1. Prepare a crypto payout

POST/payout/withdraw/local/crypto/direct

Create a stablecoin payout request.

Note : This provides a quote that expires 60 seconds after creation. You can ask for a new quote before the previous one expires for a seamless front-end experience.

Body application/json

merchant_keystringrequired

Unique key that identifies a merchant

emailstringrequired

Email address of the payout recipient

withdraw_currencystringrequired

The currency to be withdrawn. This should be a 3-character ISO 4217 currency code

withdraw_amountnumber<float>required

Amount of the local currency to be withdrawn and converted into cryptocurrency. Is required unless the crypto_amount is specified instead.

payout_destination_type"onchain-wallet" | "binance"

Default value is onchain-wallet. binance represents sending cryptocurrency through Binance Pay.

As of June 2026, this Binance payout feature is only enabled upon request. Please contact our support team.

crypto_currencystringrequired

Cryptocurrency that will be paid out. If the payout_destination_type is binance, the supported values are BTC and USDC only.

crypto_amountnumber<float>

You can use this to request a payout for a precise crypto amount (for example, ask a payout for a value of 0.0324 ETH rather than 72 USD).

remarksstring

Remarks for the payout

addressstringrequired

The crypto wallet address of your customer. If the payout_destination_type is binance, this value should be a valid Binance ID of the recipient.

namestringrequired

The merchant’s name

id_numberstring

The merchant’s business registration number or national id if an individual

countrystringrequired

The merchant’s domiciled country. It must be a 2-character ISO 3166 country code.

ip_addressstring

IP address of the merchant

order_idstring

The merchant’s system unique order id. It has to be unique and has never been used for a payout previously.

notify_urlstring<uri>

The URL to send the webhook notification. The webhook URL given in your account setup will be used if this is not provided. For testing you can use webhook.site

notify_secretstring

The shared secret that will be used to sign the notification. This secret can be at most 64 characters long. If this is not provided in the payment request, the system will create a random secret just for that payment.

Response

Success

order_idstring

The merchant’s system unique order id.

payout_referencestring

Unique payout reference number

type"refund" | "withdraw"

The type of payout:

refund - A partial or complete refund of a prior successful payment.
withdraw - A withdrawal (or payout) of the merchant’s accumulated local currency balance in cryptocurrency.

account_type"local"

Account type the funds are drawn from: local - Funds are drawn from a local currency account

convert_type"local-local" | "local-crypto"

Type of conversion the funds underwent:

local-local - Funds are drawn from a local currency account and paid out as local currency.
local-crypto - Funds are drawn from a local currency account and paid out as cryptocurrency.

payout_destination_type"onchain-wallet" | "binance"

This indicates the type of wallet the payout goes to, either a Binance wallet or other onchain-wallet.

local_currencystring

The local currency equivalent of the payout. This should be a 3-character ISO 4217 currency code. Please ignore if the payout is in cryptocurrency.

local_amountnumber<float>

The local currency amount to be paid out. Please ignore if the payout is in cryptocurrency.

crypto_currencystring

Cryptocurrency that will be paid out. Please ignore if the payout is in local currency.

crypto_amountnumber<float>

Amount of cryptocurrency to be paid out if the payout is in cryptocurrency.

network_fee_crypto_amountnumber<float>

Amount of cryptocurrency representing the network fee. This is denominated in crypto_currency.

net_crypto_amountnumber<float>

Amount of cryptocurrency after deduction of the network_fee_crypto_amount.

crypto_addressstring

Address that recipient will receive the payout at. This could either be a unique wallet address hash or Binance ID, depending on the field - payout_destination_type.

exchange_ratenumber<float>

The exchange rate that will be used to exchange local currency to cryptocurrency or vice-versa.

status"new" | "confirm" | "cancel" | "done"

The current status of the payout:

new - The payout has just been created or refreshed, but has not been confirmed or cancelled yet. This status will appear if you call the Create Crypto Payout via API.
confirm - The payout has been confirmed. This status will appear if you call the Confirm Crypto Payout via API.
done - The payout has been broadcasted to the blockchain and successfully paid out to the recipient.
cancel - The payout has been cancelled. This status will appear if you call the Cancel Crypto Payout via API and successfully cancel the payout.

status_datestring<date-time>

Date and time the status was updated

merchant_namestring

Name of the merchant

remarksstring

Remarks for the payout

notify_urlstring<uri>

The URL to send the webhook notification. The webhook URL given in your account setup will be used if this is not provided. For testing you can use webhook.site

notify_secretstring

Unauthorized

messagestring

unauthorized - refers to no access token is used for authentication.
Invalid token: access token is invalid - refers to the invalid or incorrect access token used.

No permission to create payout

messagestring

no_permission - refers to when trying to confirm, cancel or refresh the payout that has been confirmed or cancelled. Or access token has expired.

Exchange Rate has expired

messagestring

rate_expire - refers to confirming the payout after the exchange rate expired.

Validation Error - There are 1 or more errors in the request body

messagestring

Main error message

errorsany[]

Show errors properties

messagestring

Additional error message

pathstring

One of the JSON object key in the request body that has the error. It could be merchant_key, address, etc.

curl -X POST "https://api.triple-a.io/api/v2/payout/withdraw/local/crypto/direct" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer <token>" \ -d '{ "merchant_key": "mkey-ck9e0srok0000zumg7vx3hpkh", "email": "[email protected]", "withdraw_currency": "SGD", "withdraw_amount": 12.75, "payout_destination_type": "onchain-wallet", "crypto_currency": "testBTC", "crypto_amount": 0, "remarks": "Payout for wages earned", "address": "mtzozh***************xZ18Ggc00hbf", "name": "The Best Company Plc", "id_number": "<your_id_number>", "country": "US", "ip_address": "203.116.172.50", "order_id": "<your_order_id>", "notify_url": "https://webhook.site/1a2d24e8-1594-4569-bc35-079049e4d805", "notify_secret": "Cf9mx4nAvRuy5vwBY2FCtaKr" }'

const response = await fetch(`https://api.triple-a.io/api/v2/payout/withdraw/local/crypto/direct`, { method: 'POST', headers: { 'Content-Type': 'application/json', 'Authorization': 'Bearer <token>' }, body: JSON.stringify({ "merchant_key": "mkey-ck9e0srok0000zumg7vx3hpkh", "email": "[email protected]", "withdraw_currency": "SGD", "withdraw_amount": 12.75, "payout_destination_type": "onchain-wallet", "crypto_currency": "testBTC", "crypto_amount": 0, "remarks": "Payout for wages earned", "address": "mtzozh***************xZ18Ggc00hbf", "name": "The Best Company Plc", "id_number": "<your_id_number>", "country": "US", "ip_address": "203.116.172.50", "order_id": "<your_order_id>", "notify_url": "https://webhook.site/1a2d24e8-1594-4569-bc35-079049e4d805", "notify_secret": "Cf9mx4nAvRuy5vwBY2FCtaKr" }) }); const data = await response.json();

import requests response = requests.request( "POST", "https://api.triple-a.io/api/v2/payout/withdraw/local/crypto/direct", headers={ "Authorization": "Bearer <token>" }, json={ "merchant_key": "mkey-ck9e0srok0000zumg7vx3hpkh", "email": "[email protected]", "withdraw_currency": "SGD", "withdraw_amount": 12.75, "payout_destination_type": "onchain-wallet", "crypto_currency": "testBTC", "crypto_amount": 0, "remarks": "Payout for wages earned", "address": "mtzozh***************xZ18Ggc00hbf", "name": "The Best Company Plc", "id_number": "<your_id_number>", "country": "US", "ip_address": "203.116.172.50", "order_id": "<your_order_id>", "notify_url": "https://webhook.site/1a2d24e8-1594-4569-bc35-079049e4d805", "notify_secret": "Cf9mx4nAvRuy5vwBY2FCtaKr" }, ) data = response.json()

<?php $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, "https://api.triple-a.io/api/v2/payout/withdraw/local/crypto/direct"); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST"); curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json", "Authorization: Bearer <token>"]); curl_setopt($ch, CURLOPT_POSTFIELDS, '{ "merchant_key": "mkey-ck9e0srok0000zumg7vx3hpkh", "email": "[email protected]", "withdraw_currency": "SGD", "withdraw_amount": 12.75, "payout_destination_type": "onchain-wallet", "crypto_currency": "testBTC", "crypto_amount": 0, "remarks": "Payout for wages earned", "address": "mtzozh***************xZ18Ggc00hbf", "name": "The Best Company Plc", "id_number": "<your_id_number>", "country": "US", "ip_address": "203.116.172.50", "order_id": "<your_order_id>", "notify_url": "https://webhook.site/1a2d24e8-1594-4569-bc35-079049e4d805", "notify_secret": "Cf9mx4nAvRuy5vwBY2FCtaKr" }'); $response = curl_exec($ch); curl_close($ch);

package main import ( "fmt" "io" "net/http" "strings" ) func main() { req, _ := http.NewRequest("POST", "https://api.triple-a.io/api/v2/payout/withdraw/local/crypto/direct", strings.NewReader(`{ "merchant_key": "mkey-ck9e0srok0000zumg7vx3hpkh", "email": "[email protected]", "withdraw_currency": "SGD", "withdraw_amount": 12.75, "payout_destination_type": "onchain-wallet", "crypto_currency": "testBTC", "crypto_amount": 0, "remarks": "Payout for wages earned", "address": "mtzozh***************xZ18Ggc00hbf", "name": "The Best Company Plc", "id_number": "<your_id_number>", "country": "US", "ip_address": "203.116.172.50", "order_id": "<your_order_id>", "notify_url": "https://webhook.site/1a2d24e8-1594-4569-bc35-079049e4d805", "notify_secret": "Cf9mx4nAvRuy5vwBY2FCtaKr" }`)) req.Header.Set("Content-Type", "application/json") req.Header.Set("Authorization", "Bearer <token>") resp, err := http.DefaultClient.Do(req) if err != nil { panic(err) } defer resp.Body.Close() data, _ := io.ReadAll(resp.Body) fmt.Println(string(data)) }

HttpClient client = HttpClient.newHttpClient(); HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://api.triple-a.io/api/v2/payout/withdraw/local/crypto/direct")) .header("Content-Type", "application/json") .header("Authorization", "Bearer <token>") .method("POST", HttpRequest.BodyPublishers.ofString("{\n \"merchant_key\": \"mkey-ck9e0srok0000zumg7vx3hpkh\",\n \"email\": \"[email protected]\",\n \"withdraw_currency\": \"SGD\",\n \"withdraw_amount\": 12.75,\n \"payout_destination_type\": \"onchain-wallet\",\n \"crypto_currency\": \"testBTC\",\n \"crypto_amount\": 0,\n \"remarks\": \"Payout for wages earned\",\n \"address\": \"mtzozh***************xZ18Ggc00hbf\",\n \"name\": \"The Best Company Plc\",\n \"id_number\": \"<your_id_number>\",\n \"country\": \"US\",\n \"ip_address\": \"203.116.172.50\",\n \"order_id\": \"<your_order_id>\",\n \"notify_url\": \"https://webhook.site/1a2d24e8-1594-4569-bc35-079049e4d805\",\n \"notify_secret\": \"Cf9mx4nAvRuy5vwBY2FCtaKr\"\n}")) .build(); HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.body());

require "net/http" require "uri" uri = URI("https://api.triple-a.io/api/v2/payout/withdraw/local/crypto/direct") http = Net::HTTP.new(uri.host, uri.port) http.use_ssl = uri.scheme == "https" request = Net::HTTP::Post.new(uri) request["Content-Type"] = "application/json" request["Authorization"] = "Bearer <token>" request.body = "{\n \"merchant_key\": \"mkey-ck9e0srok0000zumg7vx3hpkh\",\n \"email\": \"[email protected]\",\n \"withdraw_currency\": \"SGD\",\n \"withdraw_amount\": 12.75,\n \"payout_destination_type\": \"onchain-wallet\",\n \"crypto_currency\": \"testBTC\",\n \"crypto_amount\": 0,\n \"remarks\": \"Payout for wages earned\",\n \"address\": \"mtzozh***************xZ18Ggc00hbf\",\n \"name\": \"The Best Company Plc\",\n \"id_number\": \"<your_id_number>\",\n \"country\": \"US\",\n \"ip_address\": \"203.116.172.50\",\n \"order_id\": \"<your_order_id>\",\n \"notify_url\": \"https://webhook.site/1a2d24e8-1594-4569-bc35-079049e4d805\",\n \"notify_secret\": \"Cf9mx4nAvRuy5vwBY2FCtaKr\"\n}" response = http.request(request) puts response.body

{ "order_id": "<your_order_id>", "payout_reference": "AGJ-937870-PYT", "type": "withdraw", "account_type": "local", "convert_type": "local-crypto", "payout_destination_type": "onchain-wallet", "local_currency": "SGD", "local_amount": 10, "crypto_currency": "testBTC", "crypto_amount": 0.001067203, "network_fee_crypto_amount": 0.000007203, "net_crypto_amount": 0.00106, "crypto_address": "1NcAyv8YVCnQGCrDb4kiUm1jj6GLyowxER", "exchange_rate": 10277.49, "status": "new", "status_date": "2020-01-26T03:57:22Z", "merchant_name": "A to Z Toys and Games", "remarks": "Refund for a water pistol", "notify_url": "https://webhook.site/1a2d24e8-1594-4569-bc35-079049e4d805", "notify_secret": "Cf9mx4nAvRuy5vwBY2FCtaKr" }