Go-live checklist
Verify your Airwallex Payments Cartridge configuration before switching to production.
To confirm your Airwallex Payments Cartridge is ready for production, work through each item in this checklist before switching from the sandbox environment.
Before you begin
- You have completed all previous setup steps:
Verify your configuration
Review each item and confirm it is complete before going live:
- Metadata imported — All site preferences, custom objects, services, payment methods, processors, and jobs are present in your production realm.
- Cartridges uploaded —
int_airwallex,app_airwallex, andbm_airwallexare uploaded to the active code version. - Cartridge paths configured — Both the storefront site and Business Manager site have the correct cartridge paths.
- Environment set to Production — In Airwallex Settings, switch from
SandboxtoProduction. - Production credentials entered — Client ID, API key, and Webhook Secret for the production environment are configured.
- Payment methods enabled in Airwallex — Credit Card, Apple Pay, and Google Pay (or other desired methods) are toggled on in Airwallex Settings, and the corresponding methods are activated in your Airwallex account.
- Payment methods enabled in SFCC —
AirwallexCreditCardandAirwallexOnlineare enabled in Merchant Tools > Ordering > Payment Methods. - Webhook endpoint registered — The production webhook URL is configured in the Airwallex web app, and the webhook secret is saved in Business Manager.
- Webhook job enabled —
AirwallexProcessWebhooksjob is enabled and running on schedule.
Test your integration
To verify your integration works correctly, complete these steps:
-
Place test orders using each enabled payment method and verify order statuses update correctly.
-
Process a test refund from the Airwallex web app and verify the order status updates through the webhook.
-
Verify that express checkout buttons (Apple Pay, Google Pay) appear on the checkout page if enabled.
-
Confirm that local payment methods are presented based on the shopper's currency and region.
Troubleshoot common issues
| Issue | Solution |
|---|---|
| Payment methods not appearing at checkout | Verify the cartridge path order, and confirm payment methods are enabled both in SFCC and in your Airwallex account. |
| API authentication failures | Double-check the Client ID and API key for the active environment. Confirm they match the correct Airwallex environment (sandbox or production). |
| Webhook events not processing | Verify the webhook secret is correct, the job is enabled, and the webhook URL is accessible from the internet. |
| Order status not updating after payment | Check that the AirwallexProcessWebhooks job is running. Review AirwallexWebhookEvent custom objects for failed events. |
| Express checkout buttons not appearing | Confirm Apple Pay or Google Pay are enabled in Airwallex Settings and configured in your Airwallex account. Apple Pay also requires domain verification. |
Check service logs
The AirwallexPublicAPI service has communication logging enabled by default. To view API request and response logs:
-
In Business Manager, go to Administration > Operations > Services.
-
Click AirwallexPublicAPI.
-
Check the Communication Log for recent requests.