Code examples

A quick introduction to building with Airwallex APIs

Quickstart

Explore our comprehensive reference to integrate with Airwallex API endpoints

API Reference

Learn how to receive push notifications via webhooks

Webhooks

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

Desktop/Mobile Website Browser

Paysafecash

Store Detail Requirement 

Payment Method List

Native API

Configure remote authorization

iOS SDK

Android SDK

Registered user checkout

Install the Airwallex Google Pay Payments App

Getting Started

Install Airwallex Card Payments app

Install Airwallex Online Payments App

Install Airwallex Klarna Payments App

Install Airwallex Afterpay Payments App

Install the Airwallex Apple Pay Payments App

Shopline

Supported currencies

 Micro-deposit verification

Transfer webhooks (older versions)

Desktop/Mobile Website Browser - Afterpay / Clearpay

Afterpay / Clearpay

Pakistan

Bangladesh

Indonesia

Market & infrastructure coverage

Settlement report

Transaction & fee types

Payment activity export

Payments rounding logic

Reporting

Enable Native Credit/Debit Cards

Hungary

Zambia

Wallis and Futuna

Virgin Islands (British)

Viet Nam

Vanuatu

Uzbekistan

Uruguay

United States

United Kingdom

United Arab Emirates

Ukraine

Uganda

Turkey

Tunisia

Togo

Timor-Leste

Thailand

Tanzania, United Republic of

Tajikistan

Taiwan (China)

Switzerland

Sweden

Sri Lanka

Spain

South Africa

Slovenia

Slovakia

Singapore

Seychelles

Serbia

Senegal

Saudi Arabia

San Marino

Saint Pierre and Miquelon

Saint Martin (French part)

Saint Lucia

Saint Barthélemy

Rwanda

Romania

Réunion

Republic of the Congo

Qatar

Puerto Rico

Portugal

Poland

Philippines

Peru

Paraguay

Panama

Palestine, State of

Oman

Norway

Nigeria

Niger

New Zealand

New Caledonia

Netherlands

Nepal

Namibia

Morocco

Montenegro

Albania

Algeria

Andorra

Angola

Anguilla

Antigua and Barbuda

Argentina

Armenia

Aruba

Australia

Austria

Azerbaijan

Bahrain

Belgium

Belize

Benin

Bolivia

Bosnia and Herzegovina

Botswana

Brazil

Bulgaria

Burkina Faso

Cambodia

Cameroon

Canada

Canary Islands

Central African Republic

Chad

Chile

China

Colombia

Costa Rica

Côte d'Ivoire

Croatia

Curaçao

Cyprus

Czech Republic

Denmark

Dominican Republic

Dominica

Ecuador

Egypt

El Salvador

Equatorial Guinea

Estonia

Faroe Islands

Fiji

Finland

France

French Guiana

French Polynesia

French Southern Territories

Gabon

Gambia

Georgia

Germany

Gibraltar

Greece

Greenland

Grenada

Guatemala

Guernsey

Guinea-Bissau

Guyana

Honduras

Hong Kong SAR

Iceland

India

Ireland

Isle of Man

Israel

Italy

Jamaica

Japan

Jersey

Jordan

Kazakhstan

Kenya

Korea, Republic of

Kosovo

Kuwait

Kyrgyzstan

Latvia

Lesotho

Liechtenstein

Lithuania

Luxembourg

Macedonia, the former Yugoslav Republic of

Macao SAR

Madagascar

Malawi

Malaysia

Maldives

Malta

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