Gr4vy

Gr4vy is a cloud-based payment orchestration platform where merchants can manage multiple payment service providers, anti-fraud tools, and over 400 alternative payment methods through a single, no-code dashboard.

Supported payment methods: For the payment methods available through this integration, see the Payment methods overview.

Prerequisites

Before you begin, make sure you have:

• An existing Airwallex account. You can find your Airwallex API key and Client ID in the Airwallex web app under Account > Developer.
• Selected the payment methods you want to route through Airwallex. Make sure these match the methods configured in your Airwallex account under Account > Developer.

Add Airwallex as the payment gateway

You can add Airwallex as the payment gateway in Gr4vy to process card transactions.

1. Set up the Airwallex connector. In the Airwallex web app under Account > Developer, copy your Client ID, then select Create restricted API key. Enter a name, select the Payment Acceptance and Finance access scopes, then select Create API Key and copy the scoped API key. For more information, see Scoped API keys. Then, in the Gr4vy dashboard, set up the Airwallex connector and configure the Client ID and API key.

2. Route transactions to the connector. Configure how transactions are routed to Airwallex. Choose one of the following options:

• Using Flow: configure Airwallex as the target connector in Flow to automatically route card transactions to it.
• Using the API: set the payment_service_id parameter to the Airwallex connector ID when creating transactions. This overrides any Flow routing rules. You can find the connector ID in the dashboard under Connections > Configured connections.

3. Capture card data securely. Use Gr4vy's client-side tools to capture card information. For PCI compliance, make sure sensitive data is never transmitted to your own servers. Integration options include:

• Embed : a ready-to-use, adaptable UI for the entire checkout journey.
• Secure Fields : individual components for building custom forms while maintaining security standards.
• Mobile SDKs : kits for iOS, Android, and cross-platform environments.

Once the card data is tokenized, initiate a payment through the API. Gr4vy routes the transaction to your Airwallex connector using your Flow logic or a specific payment_service_id.

Send billing data

To improve risk engine accuracy, Airwallex recommends supplying enriched data fields. During transaction creation, provide billing information in the buyer object, either as an online guest buyer or by using a stored buyer reference.

Device fingerprinting

Deploying the Airwallex Risk JavaScript on your checkout to send device metadata through the Gr4vy API is mandatory for Airwallex merchants on Gr4vy.

1. Implement the Airwallex Risk JavaScript and collect device telemetry by following the first two steps in the device fingerprinting guide. The data is associated with the order session ID through data-order-session-id.
2. Forward the captured telemetry to Airwallex when creating a transaction by populating the anti_fraud_fingerprint parameter.

Webhooks

Airwallex uses webhooks for asynchronous updates on payment intents and refunds. To synchronize statuses, define a notification URL and select the relevant events in the Airwallex web app under Account > Developer > Webhooks. The signing secret is optional, but Gr4vy recommends entering it in the Webhook Secret field to enable signature validation.

Testing

You can simulate payment outcomes in the Airwallex demo environment using these standard test cards:

• Visa: 4111 1111 1111 1111
• Mastercard: 5555 5555 5555 4444
• American Express: 3782 822463 10005

Use any future expiry date and any 3-digit CVV (use 4 digits for American Express). For more scenarios, see the test card numbers documentation or contact your Airwallex representative.

Settlement report and reconciliation

You can download the settlement reports for reconciliation from the web app > Reports page. See Settlement reports for more details.