Airwallex logo

Go-live checklist

Verify your Airwallex Payments Cartridge configuration before switching to production.

Copy for LLMView as Markdown

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

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 uploadedint_airwallex, app_airwallex, and bm_airwallex are 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 Sandbox to Production.
  • 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 SFCCAirwallexCreditCard and AirwallexOnline are 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 enabledAirwallexProcessWebhooks job is enabled and running on schedule.

Test your integration

To verify your integration works correctly, complete these steps:

  1. Place test orders using each enabled payment method and verify order statuses update correctly.

  2. Process a test refund from the Airwallex web app and verify the order status updates through the webhook.

  3. Verify that express checkout buttons (Apple Pay, Google Pay) appear on the checkout page if enabled.

  4. Confirm that local payment methods are presented based on the shopper's currency and region.

Troubleshoot common issues

IssueSolution
Payment methods not appearing at checkoutVerify the cartridge path order, and confirm payment methods are enabled both in SFCC and in your Airwallex account.
API authentication failuresDouble-check the Client ID and API key for the active environment. Confirm they match the correct Airwallex environment (sandbox or production).
Webhook events not processingVerify the webhook secret is correct, the job is enabled, and the webhook URL is accessible from the internet.
Order status not updating after paymentCheck that the AirwallexProcessWebhooks job is running. Review AirwallexWebhookEvent custom objects for failed events.
Express checkout buttons not appearingConfirm 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:

  1. In Business Manager, go to Administration > Operations > Services.

  2. Click AirwallexPublicAPI.

  3. Check the Communication Log for recent requests.

Was this page helpful?