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

Online payments overview

Upgrade to Airwallex.js

Guest user checkout

Registered user checkout

Hosted Payment Page

Payment Links overview

Connected Account Console (Beta)

Connected Account Console (Beta) overview

Handle RFIs

View connected accounts

Embedded KYC RFI component

Hosted KYC RFI flow

Native KYC RFI API

Handle KYC RFI

Enable Google Pay (Express Checkout)

Enable Apple Pay (Express Checkout)

Install the Airwallex Apple Pay Payments App

Review direct debit mandate requirements

South Africa

United States

Enable Native Credit/Debit Cards

Enable Apple Pay and Google Pay

Enable and Configure Payment Methods

Failure reasons

Retrieve physical card delivery details

Integration checklist

Manage your direct debit payout mandates

Manage your direct debit payouts

Dispute your direct debit payouts

Direct debit payout statuses

Authorize direct debit payouts

Retrieve your deposits

Supported regions and currencies

Overview

Accounts

Move funds between accounts

Embedded Transaction RFI component

Hosted Transaction RFI flow

Native Transaction RFI API

Handle Transaction RFI

Embedded Payment Enablement RFI component

Hosted Payment Enablement RFI flow

Native Payment Enablement RFI API

Handle Payment Enablement RFI

Embedded KYB component

Hosted Onboarding 

Native API

Payment Method Onboarding Requirement

KYB and onboarding

Individual KYC Requirements - AU

Individual KYC Requirements - HK

Individual KYC Requirements - SG

UK & EEA

Individual KYC Requirements - UK & EEA

Individual KYC Requirements

Australia (AU) 

Canada (CA)

China (CN)

Germany (DE)

Spain (ES)

France (FR)

United Kingdom (GB)

Hong Kong (HK)

Ireland (IE)

Italy (IT)

Netherlands (NL)

Singapore (SG)

United States (US)

Others

Business KYC requirements

Embedded KYC component

Hosted Onboarding

Simulate connected account status transition

KYC and onboarding

Onboard connected accounts

Supported regions

How connected accounts work

Connected Accounts

Desktop/Mobile Website Browser - PayPal

PayPal

ACH Direct Debit - BETA

 EFT Pre-Authorized Debit - BETA

 SPEI - BETA

Venmo - BETA

North America & LATAM

Handling Disputes

Enable MOTO Payments

Install Airwallex Card Payments app

Enable express checkout

Enable Apple Pay via web application

Enable Apple Pay using API

Apple Pay Element

Drop-in Element

Mobile SDK

Use your own certificate

Test your integration

Apple Pay

Google Pay Element

Enable Google Pay™

Google Pay™

Card Element

Split Card Element

Legacy Embedded Elements

Embedded Elements

Full Featured Card Element

Redirect Element

QR Code Element

WeChat Pay Element

Partners overview

Developer Tools

Demo environment overview

Mobile SDKs

Customization options

Airwallex.js

Quickstart with Postman

Manage API keys

RFI (Request for Information)

Implement your marketplace solution

Payments for marketplaces

Desktop / Mobile Website Browser

Save bank details for future payments

Micro-deposit verification

SEPA Direct Debit - BETA

Handling Disputes & FAQs

Desktop/Mobile Website Browser

Pay by Bank app (PbBa)

US: 1099-K

US tax form filing obligations

1099-NEC form state requirements

 Account

Billing

Charges

Connected Account Transfers

Conversions

Deposits

Direct debit payouts

Global Accounts

Issuing

Linked Accounts

Online Payments

Platform

 Transfers

Payload examples

Account capability

Account status

Funds Split

Online payments

PSP Agnostic

Transfers

Event types

View and Manage Transactions

Embedded Tax Form component

Bacs Direct Debit - BETA

Bancontact

BLIK

Estonian Banks

iDEAL

Latvian Banks

Lithuanian Banks

Maxima

MyBank

Multibanco

Narvesen

Paysafecard

Paysafecash

Paysera

PayU

Perlas Terminals

Przelewy24 | P24

Satispay

Sofort.

Trustly

TWINT - BETA

EU & UK

Desktop/Mobile Website Browser - TWINT

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.

Get started

Manage accounts

Move funds

Accounts icon

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