Skip to main content
This optional job updates coupon redemption status when coupons are applied during Global-e order failover. It is not included in the default metadata/jobs.xml; import and schedule it when coupon verification during failover is required. See also: Jobs overview, Promotions, Failover and recovery.

​
Use case

A merchant has coupon codes with redemption limits (per code, customer, or time frame) assigned to a specific SFCC customer group (not Everyone) or a source code. If the OrderCreate API fails, Global-e recreates the order using a fallback scenario (SendOrderToMerchant payload). In that scenario there is no customer session, so customer-group-based coupon redemption cannot run on the new basket. Global-e applies the discount via custom price adjustments and creates GLOBALE_COUPON_REDEMPTIONS custom objects (order number, customer email, coupon code, coupon ID). GlobaleCouponRedemptions reads those custom objects, writes an XML file with redemption records, and imports it using the standard ImportCouponCodeRedemptions step (MERGE mode). After a successful import, the custom objects are deleted.

​
Overview

Typical setup that needs this job:
  • Coupon codes with redemption limits (per code, customer, or time frame).
  • Coupon assigned to a campaign/promotion scoped to a specific customer group (not Everyone) with Required Qualifiers All.

​
Job steps

​
Creating the job

This job is not shipped in metadata/jobs.xml; only the step type is provided by the cartridge. In Business Manager, create a new job with the ID GlobaleCouponRedemptions and add the two steps above in order:
  • GlobaleGenerateCouponRedemptionsXML — add custom step custom.GlobaleGenerateCouponRedemptionsXML.
  • ImportCouponCodeRedemptions — add the standard SFCC step and point it at the file written by the previous step, with import mode MERGE.
Assign the job flow only to Global-e operated sites. See Configuration → Scheduled Jobs for Business Manager setup.

​
Configuration

  1. Set site preference Enable Coupon Verification (geEnableCouponVerification) to Yes under Merchant Tools → Site Preferences → Custom Site Preference Groups → Global-e Settings.
  2. Configure the GlobaleCouponRedemptions job steps in Business Manager as described above.

​
Notes

Creating coupon redemption records via this import path does not appear in SFCC Business Reports and Dashboards. It does record the redemption so the platform can enforce limits on subsequent redemption attempts with the same code.

​
External references