Code examples

A quick introduction to the essential dev tools for building with Airwallex

Developer Essentials

Explore the flexibility and power of Airwallex APIs

Quickly and securely integrate with Airwallex products using Airwallex SDKs

SDKs

Learn how to receive push notifications via webhooks

Webhooks

Use Airwallex's demo environment to simulate transactions before going live

Demo environment

Java

```java
import org.apache.commons.codec.digest.HmacAlgorithms;
import org.apache.commons.codec.digest.HmacUtils;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.ResponseBody;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

@Controller
public class WebhookExampleController {

@PostMapping("/webhook/example")
@ResponseBody
public String receive(HttpServletRequest request, @RequestBody String payload, HttpServletResponse response) {

String responseBody = "";

StringBuilder valueToDigest = new StringBuilder();
// Get the timestamp from header
String timestamp = request.getHeader("x-timestamp");
valueToDigest.append(timestamp);
valueToDigest.append(payload);

// Get the signature from header
String signature = request.getHeader("x-signature");

// Get your secret
String secret = getSecret();

// Check if calculated signature matches the signature from the request
HmacUtils hmacUtils = new HmacUtils(HmacAlgorithms.HMAC_SHA_256, secret)
if (hmacUtils.hmacHex(valueToDigest)).equals(signature)) { 

// Do something with event

response.setStatus(HttpServletResponse.SC_OK);
} else {
// Invalid signature
response.setStatus(HttpServletResponse.SC_BAD_REQUEST);
responseBody = "failed to verify the signature";
}

return responseBody;
}

}
```

PHP

```php
<?php
use RingCentral\Psr7\Response;

function getSecret() {
return 'whsec_CEm2XM_JZ1x5FxUUEGcZoRgIz4RZfDE';
}

function handler($request, $context): Response{
$timestamp = $request->getHeaderLine('x-timestamp');
$body = $request->getBody()->getContents();

$secret = getSecret();
$signature = $request->getHeaderLine('x-signature');

if (hash_hmac('sha256', $timestamp.$body, $secret) != $signature) {
return new Response(400, array(), 'failed to verify the signature');
}

// Do something with event
return new Response(200, array(), $body);
}

```

Node.js

```javascript
// express.js
const crypto = require('crypto')

const secret = '<CLIENT_API_WEBHOOK_SECRET>'

async webhookController(ctx, next) {
  // webhook is received

  const { headers, body } = ctx.request
  const { name, accountId } = body || {} // payload

  const ts = headers['x-timestamp']

  const policy = `${ts}${body}`

  const signatureHex = crypto.createHmac('sha256', secret).update(policy).digest('hex')

  if (signatureHex === headers['x-signature']) {
    // do business logic after signature is verified

    return next() // http response code = 200: ack the webhook
  } else {
    ctx.status = 500
    ctx.body = 'failed to verify webhook signature'
    return
  }
}
```

Code example

docsLogo

Retrieve supported beneficiary banks

Using API and form schemas

Connected Account Console

Cash App Pay Disputes

Currency precision

Desktop/Mobile Website Browser - Cash App Pay

Cash App Pay - BETA

Dispute flow

Handle disputes on the Airwallex web app

Handle disputes using our APIs

Dispute response best practices

Pre-chargeback programs

Dispute notifications

Afterpay / Clearpay Disputes

Klarna Disputes

Disputes

Dispute Flow

Handling Disputes

Customization options

Upgrade to Airwallex.js

Airwallex.js

Pakistan

Nepal

Chile

Bolivia

Tanzania, United Republic of

Trinidad and Tobago

Tunisia

Seychelles

Serbia

Qatar

Nicaragua

Kazakhstan

Kuwait

Kyrgyzstan

Jordan

Jamaica

Honduras

Guyana

Guatemala

Georgia

Algeria

Dominican Republic

Costa Rica

Belize

Bahamas

Barbados

Bosnia and Herzegovina

Azerbaijan

Oman

Fiji

Iceland

Mauritius

Albania

Armenia

Martinique

Ghana

Test your integration

Guest user checkout

Registered user checkout

Place a hold on a payment method

3D Secure authentication

Enhance fraud protection with comprehensive payment data

Device fingerprinting

Cancellations

Refunds

Network Tokenization

Card Account Updater

Multi-currency pricing

Error response codes

Native API

Simulate RFI sessions

Risk

Simulate cardholder status transition

Simulate transactions on issued cards

Issuing

Simulate transfer status transition

Payouts

Simulate payment disputes

Simulate shopper action

Payments

Simulate Linked Account and DD mandate status transition

Linked Accounts

Simulate deposits to your Global Account

Deposits

Simulate connected account status transition

Simulate account amendment status transition

Connected accounts

Demo environment overview

Billing

Install Airwallex Sales Order App

View transactions

Australia (AU_BECS_DEBIT)

Australia (AU_PAYTO_DEBIT)

United States (US_ACH_DEBIT)

United States (US_FEDWIRE_DEBIT)

United Kingdom (GB_BACS_DEBIT)

Europe SEPA (EU_SEPA_DEBIT)

Canada (CA_EFT_DEBIT)

Hong Kong (HK_FPS_DEBIT)

Singapore (SG_EGIRO_DEBIT)

New Zealand (NZ_BECS_DEBIT)

Review direct debit mandate requirements

Accept PayTo payments

PayTo - BETA

Onboard multiple connected accounts

Onboard multiple connected accounts for the same legal entity

7-Eleven

Alipay CN

Alipay HK

Atome

Boost

DANA

DOKU Wallet

Dragonpay

DuitNow

E.SUN (Taiwan ATM & Internet banking)

GCash

GoPay

GrabPay - Malaysia

GrabPay - Singapore

Indonesian Bank Transfer

Indonesian Convenience Stores - BETA

Jenius Pay

Kakao Pay

Kiosk Payments

Konbini

Korean Local Cards - BETA

Laybuy by Klarna

LinkAja

Naver Pay - BETA

Pay-easy

Payco - BETA

PayNow

Philippines Online Banking

PromptPay

Rabbit LINE Pay

Samsung Pay - BETA

ShopeePay

Taiwan Convenience Stores

Tesco Lotus

Thailand Online Banking

Toss Pay - BETA

Touch 'n Go

TrueMoney

WeChat Pay

Zip - BETA

APAC

Payment Links via API

Payment Links via web app

Payment Links overview

Test your custom domain

Remove your custom domain

Set up your custom domain 

Custom domains (Beta)

Manage approvals for batch transfers

Manage batch transfers

Install Airwallex Online Payments app

SDK examples

Low-level API integration

Redirect

Card

Apple Pay

Native UI integration

Before you start

Powerful and flexible APIs to programmatically manage your money

Platform APIs

APIs and components to build your own global financial products.

Embedded Finance Use Cases

Programmatically create accounts and onboard customers

Connected Accounts icon

Programmatically create connected accounts for businesses and individuals, and enable them with rich financial capabilities.

Code examples

.css-1xcsryl>.e1x8zjqq1{opacity:0;-webkit-transition:opacity 250ms ease-in-out;transition:opacity 250ms ease-in-out;}.css-1xcsryl:hover>.e1x8zjqq1{opacity:1;}Code example.css-158icaa{margin-left:4px;}

Code example