> ## Documentation Index
> Fetch the complete documentation index at: https://docs.global-e.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GlobaleCouponRedemptions

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](/jobs-sfcc), [Promotions](/promotions-sfcc), [Failover and recovery](/failover-sfcc).

## 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

| Step | Step type | Description |
| - | - | - |
| GlobaleGenerateCouponRedemptionsXML | `custom.GlobaleGenerateCouponRedemptionsXML` | Queries `GLOBALE_COUPON_REDEMPTIONS` custom objects and writes redemption XML to IMPEX |
| ImportCouponCodeRedemptions | `ImportCouponCodeRedemptions` | Imports the generated XML with merge mode |

## 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](/configuration-sfcc#scheduled-jobs-administration--operations--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

* [Import external coupon redemptions](https://help.salesforce.com/s/articleView?id=sf.b2c_rn_import_external_coupon_redemptions.htm\&type=5) (Salesforce B2C Commerce documentation)
* [Coupon redemption IML schema](https://salesforcecommercecloud.github.io/b2c-dev-doc/docs/current/xsd/couponredemption.xsd)