---
title: "Make International APAC Payments"
method: POST
path: "/transactions/exchangePayout"
---

# Make International APAC Payments

`POST /transactions/exchangePayout`

## Request

- Base URL: `https://sandbox.openpayd.com/api`
- URL: `https://sandbox.openpayd.com/api/transactions/exchangePayout`
- Auth: API key in header `Authorization`

The APAC Local Payment scheme allows you to transfer funds from your EUR base account to a beneficiary’s local account in one the following Southeast Asian currencies:<br><br> • Vietnamese Dong (VND)<br> • Malaysian Ringgit (MYR)<br> • Indonesian Rupiah (IDR)<br> • Thai Baht (THB)<br> • Philippine Peso (PHP)<br><br>Each payout involves two transactions: an automatic currency exchange from EUR  to the destination currency, followed by the local bank transfer.

## Request body

- object
  - `accountId` string, required: The 'id' of the local currency account from which the payout is initiated.
  - `exchangeSourceAccountId` string, required: The 'id' of the account used for currency conversion.
  - `amount` object, required
    - `value` number, float
    - `currency` string: `EUR`
  - `exchangeCurrency` 'THB' | 'MYR' | 'IDR' | 'VND' | 'PHP', required
  - `paymentType` string, required: The type of transfer being made.
  - `beneficiaryId` string: Enter the 'id' of the beneficiary (if such already exists).
  - `beneficiary` object, required
    - `customerType` 'RETAIL' | 'CORPORATE', required: The type of beneficiary.
    - `firstName` string: Required if `customerType` is `RETAIL`.
    - `lastName` string: Required if `customerType` is `RETAIL`.
    - `companyName` string: Required if `customerType` is `CORPORATE`.
    - `beneficiaryCountry` string, required: The country where the beneficiary resides.
    - `beneficiaryEmail` string, required: Contact email address of the beneficiary.
    - `beneficiaryBirthDate` string: Required if `customerType` is `RETAIL`.
    - `foundationDate` string: Required if `customerType` is `CORPORATE`.
    - `registrationNumber` string: Required if `customerType` is `CORPORATE`.
    - `bankAccountCurrency` 'VND' | 'MYR' | 'IDR' | 'THB' | 'PHP', required: The currency in which the payout payment will be made.
    - `bankAccountCountry` string, required: The country where the account is held.
    - `accountNumber` string, required: The account number where funds will be deposited.
    - `bankAccountCode` string, required: Code that identifies the receiving bank. The available bank codes can be found on the [Bank Codes](https://apidocs.openpayd.com/docs/bank-codes) page.
  - `reference` string, required: A custom message associated with the transaction.
  - `fixedSide` 'SELL' | 'BUY', required: Specifies which currency side is fixed (SELL).

## Response `200`

200

- object
  - `transactionId` string
  - `shortId` string
  - `externalCustomerId` unknown
  - `reference` string
  - `paymentType` string
  - `reasonCode` string
  - `amount` object
    - `value` integer
    - `currency` string
  - `beneficiary` object
    - `customerType` string
    - `firstName` unknown
    - `lastName` unknown
    - `companyName` string
    - `beneficiaryCountry` string
    - `beneficiaryPostalCode` unknown
    - `beneficiaryCity` unknown
    - `beneficiaryState` unknown
    - `beneficiaryAddressLine` unknown
    - `beneficiaryBirthDate` unknown
    - `bankAccountCountry` string
    - `bankName` unknown
    - `taxId` unknown
    - `phoneNumber` unknown
    - `bankAccountType` unknown
    - `bankAccountHolderName` string
    - `bic` unknown
    - `iban` unknown
    - `accountNumber` string
    - `documentId` unknown
    - `bankAccountAlias` unknown
    - `intermediaryBankAccountCountry` unknown
    - `intermediaryName` unknown
    - `intermediaryTownName` unknown
    - `intermediaryPostalCode` unknown
    - `bban` unknown
    - `registrationNumber` string
    - `bankAccountCode` string
    - `beneficiaryEmail` string
    - `foundationDate` string
    - `routingCodes` object
    - `metadata` object
  - `bulkPaymentId` unknown
  - `metadata` object
  - `status` string
  - `beneficiaryId` unknown
  - `sourceInfo` object
    - `type` string
    - `identifier` string
  - `destinationInfo` object
    - `type` string
    - `identifier` string
  - `accountHolderId` string
  - `type` string

## Other responses

- `400`: 400

---

[API](https://skmtc.dev/openpayd/apis/openpayd-reference-data.md) - [All operations](https://skmtc.dev/openpayd/apis/openpayd-reference-data/llms.txt) - [OpenAPI document](https://skmtc.dev/openpayd/apis/openpayd-reference-data/revisions/32370d47c0ea?raw)