Creating payout
POST
/api/public/v1/payouts
This endpoint creates payouts.
It takes a few seconds to build and broadcast a transaction, so please expect some delay before a txId
value appears. We advise polling the GET /api/public/v1/payouts/:id endpoint to monitor both the payout status and the txId.
Headers
Name | Value |
---|---|
Content-Type |
|
Authorization |
|
Request Body
Name | Type | Required | Description |
---|---|---|---|
data.type | string | Yes | Can only be |
data.attributes.reference | string | No | The custom reference ID to tie the payout to end-user who gets paid. This can be anything you choose. Must be a unique value for each pyout you create. |
data.attributes.amount | number | Yes | Payout amount. This is the amount that Txn will debit from your account on the Txn platform. Refer to Payout Limitations. |
data.attributes.currency | string | Yes | Payout amount currency code. This is effectively the currency account which Txn will take the payout amount from. Refer to Supported Currencies. |
data.attributes.payNetwork | string | Yes | Refer to Supported Currencies. |
data.attributes.address | string | Yes | Wallet address of a payout recipient. |
absorbFees | boolean | No | If true, both service and network fees are deducted from the transaction amount. If false, both fees are deducted from your account balance. |
Response Body
Name | Type | Description |
---|---|---|
data.id | string | Payout ID. |
data.type | string | Aways |
data.attributes.reference | string | The custom reference ID to tie the payout to end-user who gets paid. This can be anything you choose. |
data.attributes.status | string | Payout status. Refer to Payout Status Flow. |
data.attributes.address | string | Wallet address of a payout recipient. |
data.attributes.createdAt | string | Payout creation timestamp. |
data.attributes.absorbFees | boolean | If true, both service and network fees are deducted from the transaction amount. If false, both fees are deducted from your account balance. |
data.attributes.amount | number | Payout amount. This is the amount that Txn debited from your account on the Txn platform. |
data.attributes.currency | string | Payout amount currency code. This is effectively the currency account which Txn took the payout amount from. |
data.attributes.payCurrency | string | The code of a token or cryptocurrency transferred to the receiving address. |
data.attributes.payAmount | string | The amount of tokens or cryptocurrency transferred to the receiving address. |
data.attributes.txid | string | The token or cryptocurrency transaction hash. This is effectively a unique identifier of a transaction on a relevant blockchain. You can share it with the receipient as a proof of payment. |
data.attributes.payNetwork | string | Refer to Supported Currencies. |
data.attributes.networkName | string | Network name. E.g. Tron (TRC20). |
data.attributes.networkFee | string | The network fee amount Txn took to cover blockchain fees. |
data.attributes.networkFeeCurrency | string | Network fee currency. |
data.attributes.payoutFee | string | Payout fee amount. This is the Txn's processing fee. |
data.attributes.payoutFeeCurrency | string | Payout fee currency. |
data.attributes.exchangeRate | string | Exchange rate. |
Response
Last updated