Checkout discount vouchers

​

Limitations

• Percentage discounts only. This feature works only with percentage discounts (SFCC percent-off promotions with Global-e geDiscountType = PERCENTAGE). Other checkout discount types (for example fixed amount / currency-off) are not supported by the Global-e service and must not be used for payment-method provider / checkout discount vouchers.

​

Behaviour

• Shopper selects an eligible payment method (or enters a mapped voucher) on Global-e checkout → SFCC applies the mapped promotion for that Globale-Coupon request only and returns a new CartToken.
• Mapped codes do not create an SFCC coupon line item.
• The checkout discount (payment-method provider discount) does not survive a later real SFCC coupon apply/remove. When Global-e checkout reloads after voucher validation, payment-method selection is reset — the shopper must select an eligible payment method again to get the checkout discount.
• Leaving Global-e checkout for the cart (or opening checkout again from the cart without re-entering the voucher / re-selecting the PM) does not keep or revive the checkout discount.
• On order failover (SOTM / basket rebuilt from SendCartV2 payload), if the last SendCartV2 still carried the voucher in UrlParameters, it can be restored for calculate.
• Works on SFRA, SiteGenesis, and headless storefronts, using the scenario that matches each integration:
  • SFRA / SiteGenesis — Global-e calls Globale-Coupon in the shopper session (forwarded dwsid); the cartridge applies the mapped promotion directly on the storefront basket and calls SendCartV2. No OCAPI/SCAPI basket or coupon hooks are involved.
  • Headless (PWA, SFNext, etc.) — Global-e calls with a JWT (AuthToken) through OCAPI/SCAPI; the int_globale_headless basket/coupon hooks apply the promotion and refresh the cart token.

​

Prerequisites

1. Global-e platform — the voucher / payment-method provider discount must also be configured on the Global-e side for the merchant. Contact Global-e Merchant Support to confirm merchant-account configuration (including settings required for checkout discount / voucher refresh behaviour).
2. Cartridge path that includes int_globale and the storefront cartridge for the integration: int_globale_sfra or int_globale_sitegenesis (shopper-session scenario), or int_globale_headless (JWT OCAPI/SCAPI scenario). Only int_globale_headless registers the OCAPI basket/coupon hooks (beforePATCH/afterPATCH, coupon.*) that the JWT scenario relies on; SFRA/SiteGenesis do not need them because the shopper-session scenario runs entirely in Globale-Coupon.
3. Site preference geCheckoutDiscountVoucherMappings configured (see below).
4. An SFCC dynamic customer group whose membership depends on the session attribute in the mapping.
5. An SFCC percentage promotion (no coupon required) assigned to that customer group, with Global-e promotion attributes set as usual (geDiscountType = PERCENTAGE). Other discount types are not supported for this feature — see Limitations. See Promotions.
6. SFRA / SiteGenesis only — the shopper dwsid cookie must be present in the SendCartV2 UrlParameters (inside the ClientCookie entry). Global-e replays it when it calls Globale-Coupon, letting SFCC re-bind to the shopper session and current basket. Without dwsid, voucher apply/remove (and session-bound order create) fail — see Checkout flow → Session identifiers. Headless uses the OCAPI/SCAPI JWT instead and does not need dwsid.

​

Configuration

​

1. Site preference — Checkout Discount Voucher Mappings

[
  {
    "voucherCode": "DISCOUNT-ON-CHECKOUT",
    "sessionAttribute": "geCheckoutDiscountOnCheckout",
    "sessionValue": true,
    "promotionId": "globale-discount-on-checkout"
  }
]

​

2. Customer group and promotion

​

3. Metadata

• Site preference geCheckoutDiscountVoucherMappings
• Basket attribute geCheckoutDiscountVouchers (used by the cartridge; merchants do not set this manually)

​

Expected checkout behaviour

​

Notes

• SendCartV2 UrlParameters may carry checkout discount vouchers for SOTM / fallback basket rebuild when the discount-apply SendCart still had the basket attribute set. Other Global-e requests (OrderClientCreate, OrderCreateV2, KeepAlive, ValidateCart) neither apply nor validate vouchers, so they do not need the voucher session attributes.
• Only one checkout discount voucher is active at a time. Applying another mapped voucher replaces the previous one.
• On the Global-e platform, configure the matching payment-method provider / checkout discount as a percentage value only (for example 10%). Non-percentage checkout discounts are not supported by the Global-e service. Confirm related merchant-account settings with Global-e Merchant Support before go-live.

​

See also

• Promotions
• Customer groups
• Session attributes
• Failover and recovery
• Metadata reference