Skip to main content

Documentation Portal

Webhooks

ClientApplyLoyaltyVouchers (Global-e to Merchant)

Note

This API is part of Global-e's extensions and plug-ins. Merchants do not need to implement this API unless a custom integration is required.

Use this method to validate the Loyalty Vouchers selected by the user from the list that has been provided in the loyaltyVouchersList argument of the SendCart API call for the current user’s checkout page. This method can only be executed from within the context of the current user’s client session. Validates Loyalty Vouchers and applies them to the current user’s cart if all the vouchers in the list are valid and applicable.

  • If at least one Loyalty Voucher in the list is invalid, Merchant.ResponseInfo.Success is set to FALSE.

  • If all Loyalty Vouchers are valid, the Merchant’s server should re-calculate the cart pricing and execute before returning a response, the SendCart API call with the CartToken argument value returned from the previous call to SendCart for the current user.

Method/URL

https://www.merchant-site-domain.com/ClientApplyLoyaltyVouchers 
Parameters

Request

Name

Type

Description

Mandatory

cartAction

Object Merchant.CartAction

Delineates what action to perform with the cart data.

Yes

Response

Name

Type

Description

Mandatory

Merchant.ResponseInfo

Object Merchant.ResponseInfo

Describes the response to the API call. In case of an error, indicates the error.

Objects for ClientApplyLoyaltyVouchers API
Examples
GetCheckoutCartInfo (Global-e to Merchant)

The GetCheckoutCartInfo API retrieves cart information for international checkout processing. This API:

  • Is triggered when the cart page loads or when a checkout attempt is made

  • Only returns products that are in stock

  • Requires proper cart token validation

  • Is part of Global-e's extensions (custom integration only)

This method is called from a Global-e server with the cart token rendered in a cookie or HTML.DOM. The client's session calculates the price totals. The GetCheckoutCartInfo API returns all cart contents, including customer information for logged-in customers

This API only returns products that are in stock. If special handling is required for stock validation on your side, for products in the basket (for example, calls to an external system), Global-e can specify an additional URL for this method, to indicate that stock validation is specifically required.

If the cart data is unavailable, the checkout will not open and an error message will appear in the browser development console.

The GetCheckoutCartInfo API is only triggered upon the cart page loading, or when a checkout attempt is made.

Note

This API is part of Global-e's extensions and plug-ins. Merchants do not need to implement this API unless a custom integration in required.

Method/URL

Client-side: GET

Server-side: GET/ POST (default GET). Global-e can configure your preference.

GET https://www.merchant-site-domain.com/get-checkout-cart-info-url
POST https://www.merchant-site-domain.com/get-checkout-cart-info-url
Parameters

Request

Requests can contain more parameters than listed.

Name

Type

Description

Mandatory

countryCode

String

2-char ISO code for the country to which shipped

No

currencyCode

String

3-char currency code for the country to which shipped

No

merchantCartToken

String

Identifier used for the cart by the Merchant’s site

No

Response

Returns all cart contents, including customer information for logged-in customers.

Note

Some values are encoded and require the merchant to decode them, for example URLs, addresses, emails, and phone numbers.

Name

Type

Description

CheckoutCartInfo

Object CheckoutCartInfo

Retrieves cart information

Examples
NotifyOrderRefund (Global-e to Merchant)

The NotifyOrderRefund method notifies the merchant about Global-e initiated refunds issued to the shopper.

If implemented on the merchant’s site, the Global‑e servers post the information about customer refunds, in cases where such refunds are initiated on the Global‑e side.

Method/URL

https://www.merchant-site-domain/order-refund-url
Parameters

Request

Requests can contain more parameters than listed.

Name

Type

Description

Mandatory

order

Object Merchant.OrderRefund

Contains information about order refunds.

Yes

Response

Note

Some response values are encoded and require the merchant to decode them, for example URLs, addresses, emails, and phone numbers.

Name

Type

Description

Mandatory

Merchant.ResponseInfo

Object Merchant.ResponseInfo

Provides response data regarding the API call.

Example
PerformOrderPayment (Global-e to Merchant)

Note

This API is part of Global-e's extensions and plug-ins. Merchants do not need to implement this API unless a custom integration is required.

Posts order payment details to the Merchant's site and perform the payment.

Only order.OrderId and order.PaymentDetails classes are mandatory for this method. For Mixed orders, "Subs" is mandatory.

Method/URL

POST https://www.merchant-site-domain.com/order-payment-only-url
Parameters

Request

Requests can contain more parameters than listed.

Note

Some response values are encoded and require the merchant to decode them, for example URLs, addresses, emails, and phone numbers.

Name

Type

Description

Mandatory

order

Object Merchant.Order

Merchant.Order objects contain information about orders.

Yes

Examples
RedeemGiftCard (Global-e to Merchant)

The RedeemGiftCard API sends the amount of the used card balance. This information is saved on your platform.

Add the GiftCardData.RedeemTransactionId for each gift card during this call.

Method/URL

https://www.merchant-site-domain.com/redeem-gift-card-url
Parameters

Request

Name

Type

Description

Mandatory

RedeemGiftCardRequest

Object Object RedeemGiftCardRequest

Contains information regarding gift card redemption.

Yes

Response

Name

Type

Description

Mandatory

RedeemGiftCardResponse

Object Object RedeemGiftCardResponse

Provides details about response to API call for gift card redemption.

Objects for RedeemGiftCard API
Examples

Request

{
    "MerchantGUID": "abcdabcd-abcd-abcd-abcd-abcdabcdabcd",
    "ShippingCountryCode": "IL",
    "Cards": [{
            "CardId": 2864,
            "BalanceInGiftCardCurrency": 365.930000,
            "BalanceInCustomerCurrency": 1286.210000,
            "GiftCardCurrencyCode": "USD",
            "CustomerCurrencyCode": "ILS",
            "BalanceUsedInCardCurrency": 94.910000,
            "BalanceUsedInCustomerCurrency": 333.590000,
            "CardFields": {
                "CardId": "111111"
            }
        }
    ],
    "OrderId": " GE927127",
    "MerchantCartToken": "cf270ce6b2d4ce6d2d882536b8741a01"
}

Response

{
    "Cards": [{
            "CardId": 2864,
            "BalanceInGiftCardCurrency": 365.93,
            "BalanceInCustomerCurrency": 1286.21,
            "GiftCardCurrencyCode": "USD",
            "CustomerCurrencyCode": "ILS",
            "BalanceUsedInCardCurrency": 94.91,
            "BalanceUsedInCustomerCurrency": 333.59,
            "RedeemTransactionId": 2,
            "CardFields": {
                "CardId": "111111"
            }
        }
    ],
    "ErrorCode": null,
    "ErrorText": null
}
RefundGiftCard

Call RefundGiftCard to return the used gift card balance when the order is cancelled or a new Refund has been created.

Global‑e sends the list of all applied gift cards and the total amount to refund for gift cards in both currencies (customer currency and gift card currency), as well as the conversion rate. The Merchant’s platform determines the actual refund values to be refunded for each gift card and returns the respective values in the API response accordingly.

For each gift card, set the following in response:

  • GiftCardData.RefundedBalanceInGiftCardCurrency – must not exceed the provided value of GiftCardData.BalanceUsedInCardCurrency

  • GiftCardData.RefundedBalanceInCustomerCurrency – must not exceed the provided value of GiftCardData.BalanceUsedInCustomerCurrency

  • GiftCardData.IsRefundSuccess

    • Set to true: If the two previous values for the card and values are successfully refunded.

    • Set to false: If the refund was added but something went wrong.

If no refunds are added for the particular card, do not set these values.

Method/URL

https://www.merchant-site-domain.com/refund-gift-card-url
Parameters

Request

Requests can contain more parameters than listed.

Name

Type

Description

Mandatory

order

Object Object RefundGiftCardRequest

Contains information about the gift card refund.

Yes

Response

Note

Some response values are encoded and require the merchant to decode them, for example URLs, addresses, emails, and phone numbers.

Name

Type

Description

Mandatory

order

Object RefundGiftCardResponse

Contains information about the response to the API call for gift card refunds.

Yes

Objects for RefundGiftCard API
Examples

Request

{
    "MerchantGUID": " abcdabcd-abcd-abcd-abcd-abcdabcdabcd",
    "Cards": [{
            "CardId": 2290,
            "BalanceInGiftCardCurrency": 1000.000000,
            "BalanceInCustomerCurrency": 906.270000,
            "GiftCardCurrencyCode": "USD",
            "CustomerCurrencyCode": "EUR",
            "BalanceUsedInCardCurrency": 273.990000,
            "BalanceUsedInCustomerCurrency": 248.3100,
            "RedeemTransactionId": "TestSuccessRedeemTransaction",
            "CardFields": {
                "CardId": "card1000"
            }
        }
    ],
    "TotalToRefundInCustomerCurrency": 115.0,
    "TotalToRefundInGiftCardCurrency": 126.89,
    "ConversionRate": 0.906269,
    "OrderId": "GE927127"
}

Response

{
    "Cards": [{
            "CardId": 2290,
            "BalanceInGiftCardCurrency": 1000.000000,
            "BalanceInCustomerCurrency": 906.270000,
            "GiftCardCurrencyCode": "USD",
            "CustomerCurrencyCode": "EUR",
            "BalanceUsedInCardCurrency": 273.990000,
            "BalanceUsedInCustomerCurrency": 248.3100,
            "RedeemTransactionId": "TestSuccessRedeemTransaction",
            "CardFields": {
                "CardId": "card1000"
            },
            "RefundedBalanceInGiftCardCurrency": 126.89,
            "RefundedBalanceInCustomerCurrency": 115.0,
            "IsRefundSuccess": true
        }
    ],
    "TotalToRefundInCustomerCurrency": 115.0,
    "TotalToRefundInGiftCardCurrency": 126.89,
    "ConversionRate": 0.906269,
    "OrderId": "GE2991190US"
}
RemoveRestrictedProducts (Global-e to Merchant)

Note

This API is part of Global-e's extensions and plug-ins. Merchants do not need to implement this API unless a custom integration is required.

This API removes restricted products from the merchant cart; it notifies merchants that restricted products were removed from the cart, then merchants must also update the cart on the merchant side.

Method/URL

https://www.merchant-site-domain.com/remove-restricted-products-url
Parameters

Request

Name

Type

Description

Mandatory

Merchant.RemoveRestrictedProductsRequest

Object Object Merchant.RemoveRestrictedProductsRequest

Contains information related to a request to remove a restricted product.

Yes

Response

Name

Type

Description

Mandatory

Merchant.RemoveRestrictedProductsResponse

Object Object Merchant.RemoveRestrictedProductsResponse

Provides details about response to API call for removal of a restricted product.

Objects for RemoveRestrictedProducts API
Examples

Request

{
    "MerchantGUID": "abcdabcd-abcd-abcd-abcd-abcdabcdabcd",
     "CartToken": "d3b9d91b-cbc9-4485-9f37-b0490c419338",
     "CartId": "37296D5PJE",
     "UserId": null,
     "CountryCode": "VN",
     "CurrencyCode": "VND",
     "WebStoreCode": null,
     "WebStoreInstanceCode": null,
     "RemovedProductCodes": ["1601893OPK0XS"]
}

Response

{"IsSuccess": true}
SendAdditionalRequiredDocumentsToMerchant (Global-e to Merchant)

SendAdditionalRequiredDocumentsToMerchant ( SendAdditionalRequiredDocumentsToMerchantRequestrequest)

Posts the required shipping documents of the order to the Merchant’s site

This notification informs the Merchant that the documents previously listed in SendorderToMerchant notification (under AdditionalRequiredDcouments), initiated by calling CreateAdditionalRequiredDcouments, are ready.

The document's content is included in this notification.

Security:

  • IP whitelist

  • Secret GUID

  • Authorization header

Method/URL

POST https://www.merchant-site-domain.com/send-additional-required-documents-url
Examples

Request:

{
    "OrderId": "Sample order id",
    "MerchantOrderId": "Sample order id from the merchant’s system",
    "CountryCode": "US",
	"AdditionalRequiredDocuments": [
		{
           "TrackingNumber" "98789723874839",
           "DocumentData": "base 64 string",
           "URL": "URL do download document", 
           "DocumentTypeCode": "11",
           "DocumentTypeName": "EAD",
           "DocumentExtension": "pdf",
           "DocumentReference": "24DE85123822923B8",
           "CreationDateTime": "2024-01-30T10:55:21"
		}
	]
}

Response:

{	
	"StatusCode": "200",
	"Success": "true",
	"Message": "...",
	"ErrorCode": "...",
	"ErrorText": "..."
}
SendOrderToMerchant (Global-e to Merchant)

Note

This API is part of Global-e's extensions and plug-ins. Merchants do not need to implement this API unless a custom integration is required.

This API posts the new order or updates the existing order on the merchant’s site.

When implementing a Global-e extension or plug-in, this method is required to create the customer order in the merchant’s system, clear the user’s basket, and optionally, reserve the inventory.

  • If order.PaymentDetails are provided, this method also performs the payment and returns the currency and amount actually charged in the Merchant.ResponseInfo.

  • If additional shipping documents are required for merchants that are shipping the order themselves, then it is indicated in AdditionalRequiredDocuments . In that case, the merchant should delay the fulfillment until the documents are ready and provided to the merchant in the SendAdditionalRequiredDocumentsToMerchant webhook.

Method/URL

POST https://www.merchant-site-domain.com/order-update-create-url
Parameters

Request

Requests can contain more parameters than listed.

Name

Type

Description

Mandatory

order

Object Merchant.Order

Information about the order.

Response

Note

Some values are encoded and require the merchant to decode them, for example URLs, addresses, emails, and phone numbers.

Name

Type

Description

Mandatory

ResponseInfo

Object Merchant.ResponseInfo

Indicates if an API call was successful or not and why.

Examples
SendRMAToMerchant (Global-e to Merchant)

Use the SendRMAToMerchant API to send the Global‑e RMA number to the merchant. Sends MerchantReturn object to the merchant.

This API streamlines the refund process for merchants. Merchants can initiate refunds directly from the Shopify Admin.

MerchantAppSetting, SendRMAInfoToMerchantURI must be set to turn on this feature.

Method/URL

POST https://www.merchant-site-domain.com/rma-info-to-merchant-url
Parameters

Request

Name

Type

Description

Mandatory

merchantOrder

Object merchantOrder

Provides order return details.

merchantReturn

Object merchantReturn

Provides merchant return information. Includes the following information:

  • CreatedBy

  • MerchantGUID

  • MerchantOrderId

  • OrderId

  • ReturnedProducts

  • ReturnShippingCost

  • ReturnTrackingNumber

  • RMANumber

  • ShipperName

  • TrackingURL

Return

Name

Type

Description

Mandatory

merchant.ResponseInfo

Object Merchant.ResponseInfo

Provides API call response info.

Objects for SendRMAToMerchant API
Examples

Request Example

{
    "OrderId": "GE24192321GB",
    "MerchantOrderId": "71144",
    "RMANumber": "223878",
    "ShipperName": "DHL",
    "ReturnTrackingNumber": "857854854778",
    "TrackingURL": "www.dhl.com/Tracking?TrackingNumber=857854854778",
    "CreatedBy": "Customer",
    "ReturnedProducts": [
        {
            "SKU": "ProductD",
            "Name": "Blue jacket",
            "CartItemId": "2",
            "ReturnQuantity": 1,
            "ReturnReasonName": "Arrived too late",
            "MerchantReturnReasonCode": null,
            "MerchantReturnReasonName": null
        }
    ],
    "MerchantGUID": "7e3d5523-d86a-4c56-8f47-5a48b829e3b7",
    "CurrencyCode": "EUR",
    "ReturnShippingCost": 10.00
}

Response Example

{
    "Success": "True",
    "Message": "success message",
    "Description": "success description"
}
UpdateOrderShippingInfo (Global-e to Merchant)

UpdateObject Merchant.Order

Updates the order's international shipping information on the Merchant site.

Only order.OrderId and order.InternationalDetails members are mandatory for this method.

Method/URL

https://www.merchant-site-domain.com/order-shipping-info-update-only-url
Parameters

Request

Name

Type

Description

Mandatory

order

Object Merchant.Order

Object MerchantOrder contains details about the status of the order on the merchant's site.

Yes

Response

Name

Type

Description

Mandatory

ResponseInfo

Object Merchant.ResponInfo

Response details regarding API call.

Objects for UpdateOrderShippingInfo API
Examples

Request

{
    "OrderId": "00010000100000000020",
    "InternationalDetails": {
        "OrderTrackingNumber": "1265443",
        " OrderTrackingUrl": "http://www.somecarrier.com/?1265443"
    },
    "MerchantGUID": "abcdabcd-abcd-abcd-abcd-abcdabcdabcd"
}
UpdateOrderStatus (Global-e to Merchant)

Note

This API is part of Global-e's extensions and plug-ins. Merchants do not need to implement this API unless a custom integration is required.

Updates order status of the order on the Merchant’s site. Only order.OrderId and order.StatusCode members are mandatory for this method.

When implementing a Global-e extension or plug-in, this method is required to support order cancellation when it is initiated on Global-e’s side. It can also be used for reporting other order status updates as they occur in the Global-e’s system, and reflect them in the Merchant’s system.

Method/URL

POST https://www.merchant-site-domain.com/order-status-update-only-url
Parameters

Request

Name

Type

Description

Mandatory

orderStatus

Object MerchantOrder

Object MerchantOrder contains details about the status of the order on the merchant's site.

Yes

Response

Name

Type

Description

Mandatory

ResponseInfo

Object Merchant.ResponInfo

Response details regarding API call.

Objects for UpdateOrderStatus
Example

Request

{
    "OrderId": "00010000100000000020",
    "StatusCode": "canceled",
    "MerchantGUID": "abcdabcd-abcd-abcd-abcd-abcdabcdabcd"
}
ValidateGiftCard (Global-e to Merchant)

The ValidateGiftCard request sends the gift card data to the platform, gets the card amount, and makes sure that the card is valid.

ValidateGiftCard is called when the user fills out all gift card fields on the checkout page.

Method/URL

https://www.merchant-site-domain.com/validate-gift-card-url
Parameters

Request

Name

Type

Description

Mandatory

ValidateGiftCardRequest

Object Object ValidateGiftCardRequest

Provides information related to validating the gift card.

Response

Name

Type

Description

Mandatory

ValidateGiftCardResponse

Object ValidateGiftCardResponse

Provides API call response info.

Objects for ValidateGiftCard API
Examples

Request

{
    "MerchantGUID": abcdabcd - abcd - abcd - abcd - abcdabcdabcd ",
    	" ShippingCountryCode ":" UA ",
    	" CardFields ":{" CardId ":" 111111 "},
    	" MerchantCartToken ":" 2c5c7b3db2ed101426cba38d9c534086 "
}

Responses

For valid cards:

{
    "IsValid": true,
    "Balance": 1000,
    "CurrencyCode": "GBP",
    "IsGlobalEGiftCard": false,
    "ErrorCode": null,
    "ErrorText": null
}

For invalid cards:

{
    "IsValid": false,
    "Balance": null,
    "CurrencyCode": null,
    "IsGlobalEGiftCard": false,
    "ErrorCode": null,
    "ErrorText": "Invalid Card"
}
ValidateStock (Global-e to Merchant)

Note

This API is part of Global-e's extensions and plug-ins. Merchants do not need to implement this API unless a custom integration is required.

The Merchant Cart Validation checks basic cart validity and validates the product’s stock availability.

If a product line cart item listed in order.Products does not have full stock availability for the specified quantity, this cart item is included in the AmendedProducts array with an indication of the quantity actually available. If all items are in stock, the AmendedProducts array is empty.

If required, the ValidateStock API is called when the shopper is in the Global‑e checkout. If the AmendedProducts array is not empty, the list of out-of-stock products is displayed to the shopper.

Note

In the GEM integration method, the GetCheckoutCartInfo API may be reused for stock validation purposes.

Method/URL

https://www.merchant-site-domain.com/checkout-validate-cart-stock-url
Parameters

Request

Name

Type

Description

Mandatory

order

Object Object Merchant.Order

Provides information related to the order.

Request

Name

Type

Description

Mandatory

Merchant.StockValidationResponse

Object Object Merchant.StockValidationResponse

Provides information related to validating that stock exists.

Objects for ValidateStock API
Examples

Request

{
    "GlobalECartToken": "1da35dc3-cbe6-4cd8-81d6-ce433466d715",
    "PreferredCultureCode": null,
    "AuthToken": "34sdfdg43erfg43234fwsedfsdf423",
    "SessionId": "12345",
    "DateCreated": "0001-01-01T00:00:00",
    "CurrencyName": null,
    "Parcels": null,
    "AllowMailsFromMerchant": false,
    "AllowDirectCommunicationFromMerchant": false,
    "ClearCart": false,
    "UserId": null,
    "CurrencyCode": "ILS",
    "Products": [{
            "Attributes": null,
            "Sku": "648340636",
            "Price": 157.7000,
            "PriceBeforeRoundingRate": null,
            "PriceBeforeGlobalEDiscount": null,
            "Quantity": 1,
            "VATRate": null,
            "CustomerVATRate": null,
            "InternationalPrice": 649.0000,
            "InternationalDiscountedPriceInMerchantCurrency": null,
            "CartItemId": "ci21000088",
            "ParentCartItemId": null,
            "CartItemOptionId": null,
            "HandlingCode": null,
            "GiftMessage": null,
            "RoundingRate": 0.0,
            "IsBackOrdered": false,
            "BackOrderDate": null,
            "DiscountedPrice": null,
            "InternationalDiscountedPrice": null,
            "ProductCodeSecondary": "MKC1120A~N~040~~NS",
            "Brand": null,
            "Categories": null,
            "ListPrice": 0.0,
            "InternationalListPrice": 0.0,
            "GenericHSCode": null,
            "DiscountedPriceForCustoms": 0.0,
            "InternationalDiscountedPriceForCustoms": 0.0,
            "IsGiftCard": false,
            "IsFixedPrice": true
        }
    ],
    "Customer": {
        "EmailAddress": null,
        "IsEndCustomerPrimary": false,
        "SendConfirmation": false
    },
    "PrimaryShipping": {
        "FirstName": "sdfsdf",
        "LastName": "sdfsdf",
        "MiddleName": null,
        "Salutation": null,
        "Company": null,
        "Address1": "asdasd+234",
        "Address2": "",
        "City": "asdasd",
        "StateCode": null,
        "StateOrProvince": null,
        "Zip": "1234567",
        "Email": "sdfsdf%40asdasd.com",
        "Phone1": "0000000000",
        "Phone2": null,
        "Fax": null,
        "CountryCode": "IL",
        "CountryCode3": null,
        "CountryName": null,
        "AddressBookId": null,
        "AddressBookName": null,
        "SaveAddress": false
    },
    "SecondaryShipping": {
        "FirstName": "GlobalE",
        "LastName": "GE-UK@EMA-Norsk",
        "MiddleName": null,
        "Salutation": null,
        "Company": "",
        "Address1": "Building 436, Argosy Road",
        "Address2": "East Midlands Airport",
        "City": "Derby",
        "StateCode": "NN",
        "StateOrProvince": null,
        "Zip": "DE74 2SA",
        "Email": "[email protected]",
        "Phone1": "01332 818723",
        "Phone2": null,
        "Fax": null,
        "CountryCode": "GB",
        "CountryCode3": "GBR",
        "CountryName": "United Kingdom",
        "AddressBookId": null,
        "AddressBookName": null,
        "SaveAddress": false
    },
    "ShippingMethodCode": "Express Courier (Air)",
    "Discounts": [],
    "Markups": [],
    "LoyaltyPointsSpent": null,
    "LoyaltyPointsEarned": null,
    "SameDayDispatch": false,
    "SameDayDispatchCost": 0.0,
    "DoNotChargeVAT": false,
    "CustomerComments": null,
    "IsFreeShipping": false,
    "FreeShippingCouponCode": null,
    "ShipToStoreCode": null,
    "RoundingRate": 0.0,
    "UrlParameters": "[{\"Key\":\"ClientCookie\",\"Value\":\"JSESSIONID=null\"},{\"Key\":\"userId\",\"Value\":\"1148993\"},{\"Key\":\"orderId\",\"Value\":\"w748807\"},{\"Key\":\"locale\",\"Value\":\"en_IL\"}]",
    "OriginalMerchantTotalProductsDiscountedPrice": 0.0,
    "LoyaltyCode": null,
    "OTVoucherCode": null,
    "OTVoucherAmount": null,
    "OTVoucherCurrencyCode": null,
    "IsSplitOrder": false,
    "PrePayOffered": false,
    "InitialCheckoutCultureCode": null,
    "CultureCode": null,
    "HubId": 0,
    "IsReplacementOrder": false,
    "OriginalOrder": null,
    "ReservationRequestId": null,
    "IsSuppressPersonalInformation": false,
    "TotalDutiesAndTaxesPrice": 0.0,
    "USSalesTax": 0.0,
    "CCFPrice": 0.0,
    "PaymentDetails": null,
    "PrimaryBilling": {
        "FirstName": null,
        "LastName": null,
        "MiddleName": null,
        "Salutation": null,
        "Company": null,
        "Address1": null,
        "Address2": null,
        "City": null,
        "StateCode": null,
        "StateOrProvince": null,
        "Zip": null,
        "Email": null,
        "Phone1": null,
        "Phone2": null,
        "Fax": null,
        "CountryCode": null,
        "CountryCode3": null,
        "CountryName": null,
        "AddressBookId": null,
        "AddressBookName": null,
        "SaveAddress": false
    },
    "SecondaryBilling": {
        "FirstName": null,
        "LastName": null,
        "MiddleName": null,
        "Salutation": null,
        "Company": null,
        "Address1": null,
        "Address2": null,
        "City": null,
        "StateCode": null,
        "StateOrProvince": null,
        "Zip": null,
        "Email": null,
        "Phone1": null,
        "Phone2": null,
        "Fax": null,
        "CountryCode": null,
        "CountryCode3": null,
        "CountryName": null,
        "AddressBookId": null,
        "AddressBookName": null,
        "SaveAddress": false
    },
    "OrderId": null,
    "StatusCode": null,
    "MerchantGUID": "7f132fc6-bdbc-420e-a2ce-fd35ab5c06d0",
    "CartId": "_2S0DVucAbjgfHAR-SUmRshWaS3pB5F9Bk7OfgWBR9ujllKrTw5H!17426857!1596453641116",
    "MerchantOrderId": null,
    "PriceCoefficientRate": 0.0,
    "CartHash": "94210A58BAC3B3AB292DE94382910C87",
    "WebStoreCode": "en_IL",
    "WebStoreInstanceCode": "GlobalEDefaultStoreInstance",
    "DiscountedShippingPrice": 0.0,
    "InternationalDetails": null,
    "GiftCards": null
}

Responses

Example of generic error:

Error code 3 is expected. An appropriate error message is shown to the customer and a new clean cart is generated.

{
    "AmendedProducts": [],
    "Error": "3",
    "StackTrace": " at CallSite.Target(Closure , CallSite , Object )\r\n at GlobalE.GEM.BL.GEMProviders.BaseProviders.BaseGEMProvider.ParseReservationInfo(Object reservationInfo) in C:\\jenkins\\workspace\\GEPI\\787e4b5b9a7709ca06b57fcfbeb2bdb2\\GlobalE.GEM.BL\\GEMProviders\\BaseProviders\\BaseGEMProvider.cs:line 844",
    "ReservationRequestId": null
}

Example of invalid email error:

Error code 2 is expected. An appropriate error message is shown to the customer and a new clean cart is generated.

{
    "AmendedProducts": [],
    "Error": "2",
    "StackTrace": null,
    "ReservationRequestId": null
}

Example of invalid cart content error:

Error code 1 is expected. One of the cart fields is invalid. An appropriate error message is shown to the customer and a new clean cart is generated.

{
    "AmendedProducts": [],
    "Error": "1",
    "StackTrace": null,
    "ReservationRequestId": null
}

If all products are in stock:

{
    "AmendedProducts": [],
    "ReservationRequestId": null,
    "Error": null
}

If some products are out of stock:

{
    "AmendedProducts": [{
            "CartItemID": "11007",
            "QuantityInStock": 1
        }
    ],
    "ReservationRequestId": null
}
ValidateVoucher (Global-e to Merchant)

Note

This API is part of Global-e's extensions and plug-ins. Merchants do not need to implement this API unless a custom integration is required.

This API returns new CartToken in the CartToken attribute. The API call is used to help validate vouchers/coupons used on the Checkout page. If the voucher is valid, the merchant’s platform is responsible for applying this voucher to the shopper's basket and executing a new SendCart / SendCartV2 API call to Global‑e, with an indication of the newly generated discount for this voucher or coupon. The new CartToken returned from this call is returned in the CartToken attribute.

Method/URL

https://www.merchant-site-domain.com/checkout-validate-cart-voucher-url
Parameters

Request

Name

Type

Description

Mandatory

Merchant.CartVoucherValidation

Object Merchant.CartVoucherValidation

Provides information related to validating a voucher in a cart.

Response

Name

Type

Description

Mandatory

Merchant.VoucherValidationResponse

Object Merchant.VoucherValidationResponse

Provides information related to the voucher validation.

Examples