Airwallex logo

Currency conversion

Although FX risk is one of the major risks faced by global businesses, it is poorly managed given its complexities. To allow our clients to hedge against FX volatility, better manage their FX risks and maximise profitability, we offer an extended spectrum of FX services integrated with our solutions that are easily customisable to suit our customers’ requirements. Whether it is to protect e-commerce platforms against adverse FX movements when holding FX rates for international buyers while they shop online, or to empower online travel agencies to offer “guaranteed 24 hours rates” when customers book their holiday packages, our FX solutions powered by the FX Engine is designed to meet these needs.

Our FX conversions services are readily integratable with Scale and could be utilised in parallel to allow Sellers control over the timing, denomination, and amount of funds converted. Powered by our FX Engine, we provide real-time access to wholesale interbank rates for users, allowing them to access a variety of FX products as required by business models. We offer:

  • Live FX rates, SPOT & Forwards
  • Wholesale comparable rates
  • Carded rates
  • Single platform for FX and payout

As a platform, currency conversion may be triggered in two ways: 1. Using the Create a new conversion API to transfer funds between your wallets 2. Using the Create a new conversion API on behalf of the connected account

Using the Create a new conversion API to transfer funds between your wallets

curl -X POST \
'https://api-demo.airwallex.com/api/v1/conversions/create' \
-H 'Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJqdGkiOiI4Mjg5NTRiNC02ZjgzLTQ1MTktYWZkOC00NmQ2MTViMjMxOTkiLCJzdWIiOiJlYWQzOWQzZS1lMWU2LTQ3MjUtOWE0OS1iYmNhYTM5Y2Y2MzUiLCJpYXQiOjE1NDcxMjAzMzQsImV4cCI6MTU0NzEzMjMzNH0.ZFI38fBQUE5g48ndrtoBbutXjmMBPJJDmLDYcofu66g' \
-H 'Content-Type: application/json' \
-H 'cache-control: no-cache' \
-d '{
"buy_amount": "10000",
"buy_currency": "USD",
"client_data": "string",
"reason": "Settling invoices",
"request_id": "67f687fe-dcf4-4462-92fa-203353a01d9d96",
"sell_currency": "AUD",
"settlement_date": "2018-12-11",
"term_agreement": true
  }'

Using the Create a new conversion API on behalf of the connected account

You can simply use the same conversion code and add in the on behalf of header.

curl -X POST \
'http://api-demo.airwallex.com/api/v1/conversions/create' \
-H 'Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJqdGkiOiI4Mjg5NTRiNC02ZjgzLTQ1MTktYWZkOC00NmQ2MTViMjMxOTkiLCJzdWIiOiJlYWQzOWQzZS1lMWU2LTQ3MjUtOWE0OS1iYmNhYTM5Y2Y2MzUiLCJpYXQiOjE1NDcxMjAzMzQsImV4cCI6MTU0NzEzMjMzNH0.ZFI38fBQUE5g48ndrtoBbutXjmMBPJJDmLDYcofu66g' \
-H 'Content-Type: application/json' \
-H 'cache-control: no-cache' \
-H 'x-on-behalf-of: 133097196' \
-d '{
"buy_amount": "10000",
"buy_currency": "USD",
"client_data": "string",
"reason": "Settling invoices",
"request_id": "67f687fe-dcf4-4462-92fa-203353a01d9d96",
"sell_currency": "AUD",
"settlement_date": "2018-12-11",
"term_agreement": true
 }'

Currency conversion may also be triggered when creating a payment either from your own profile or on behalf of a connected profile using the Create a new payment API where the debit currency is different to the payment currency.

curl -X POST \
https://api-demo.airwallex.com/api/v1/payments/create \
-H 'Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJqdGkiOiJiMmJmYjcyMy0yZWFhLTQyZmItODkxYy04MDhhZDU2ZTdlMDkiLCJzdWIiOiJlYTgwYWM3MC02NjlhLTQwMWItOWMxZi0yMzFjMjYwNWNmNWEiLCJpYXQiOjE1NDcxNzc4MjAsImV4cCI6MTU0NzE4OTgyMH0.dIPFFYx-uLKloSBWalHXkcEMepqbpF6GgVYf9bGPZHE' \
-H 'Content-Type: application/json' \
-H 'cache-control: no-cache' \
-d '{
  "beneficiary": {
	"additional_info": {},
	"address": {
		"city": "Melbourne",
		"country_code": "AU",
		"postcode": "3000",
		"state": "VIC",
		"street_address": "15 William Street"
	},
	"bank_details": {
		"account_currency": "AUD",
		"account_name": "Complete Concrete Pty Ltd",
		"account_number": "12750852",
		"account_routing_type1": "bpay_biller_code",
		"account_routing_value1": "252957",
		"account_routing_type2": "bpay_customer_reference",
		"account_routing_value2": "4805064560558",
		"bank_country_code": "AU",
		"bank_name": "BPay"
	},
	"company_name": "Complete Concrete Pty Ltd",
	"entity_type": "COMPANY"
},
"fee_paid_by": "PAYER",
"payer": {
  "additional_info": {
    "business_registration_number": "EU300503",
    "business_registration_type": "Partnership",
    "personal_email": "[email protected]",
    "personal_id_number": "1234567890"
  },
  "address": {
    "city": "Melbourne",
    "country_code": "AU",
    "postcode": "3000",
    "state": "VIC",
    "street_address": "15 William Street"
  },
  "company_name": "Example Company",
  "date_of_birth": "1976-08-26",
  "entity_type": "COMPANY",
  "first_name": "James",
  "last_name": "Smith"
},
"payment_amount": "19500",
"payment_currency": "AUD",
"payment_date": "2019-01-12",
"payment_method": "LOCAL",
"reason": "Education_Training",
"reference": "ID 480506456 Mali Wu Tuition CRN 4805064560558",
"request_id": "ET20181015120501496742-0000000000-0002",
"source_currency": "USD"
 }'