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

Billing

Install Airwallex Sales Order App

Simulate transactions on issued cards

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

Simulate RFI sessions

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

Overview

iOS Airwallex SDK

Guest user checkout

Registered user checkout

Airwallex iOS SDK Privacy Details

Mobile SDK

Embedded KYC RFI component

Hosted KYC RFI flow

Native KYC RFI API

Handle KYC RFI

Payments & fee rounding

Cameroon

Central African Republic

Chad

Eswatini

Madagascar

Djibouti

Republic of the Congo

Togo

Zimbabwe

Tuvalu

Turks and Caicos Islands

Trinidad and Tobago

Tonga

Suriname

Solomon Islands

Sierra Leone

Sao Tome and Principe

Samoa

Saint Vincent and the Grenadines

Saint Kitts and Nevis

Saint Helena, Ascension and Tristan da Cunha

Rwanda

Papua New Guinea

Palau

Northern Mariana Islands

Niger

Nicaragua

Montserrat

Mongolia

Micronesia

Marshall Islands

Malawi

Liberia

Lesotho

Lebanon

Lao People's Democratic Republic

Kiribati

Holy See (Vatican City)

Guinea-Bissau

Guinea

Ghana

Gambia

Gabon

Falkland Islands (Malvinas)

Ethiopia

Côte d'Ivoire

Cook Islands

Cayman Islands

Cabo Verde

Burkina Faso

Brunei Darussalam

Bhutan

Bermuda

Benin

Barbados

Bahamas

American Samoa

Albania

Algeria

Andorra

Angola

Anguilla

Antigua and Barbuda

Argentina

Armenia

Aruba

Australia

Austria

Azerbaijan

Bahrain

Bangladesh

Belgium

Belize

Bolivia

Bosnia and Herzegovina

Botswana

Brazil

Bulgaria

Cambodia

Canada

Canary Islands

Chile

China

Colombia

Costa Rica

Croatia

Curaçao

Cyprus

Czech Republic

Denmark

Dominica

Dominican Republic

Ecuador

Egypt

El Salvador

Equatorial Guinea

Estonia

Payout network

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