Reading payout

GET /api/public/v1/payouts/:id

This endpoint returns details of a particular payout by its ID.

Headers

Name	Value
Content-Type	application/vnd.api+json
Authorization	Bearer <api_key>

Path Parameters

Name	Value
id	Payout ID.

Response Body

Name	Type	Description
data.id	string	Payout ID.
data.type	string	Aways payouts.
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 false or omitted, both service and network fees are deducted from the transaction amount. If true, 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

HTTP 200

{
  "data": {
    "id": "c03bc7ec-8cf8-449c-9ba5-660364970682",
    "type": "payouts",
    "attributes": {
      "address": "TTbGTMwUwA3mncLP7xqCZei1ekaNSgeAJe",
      "createdAt": "2024-07-30T15:32:15.287Z",
      "absorbFees": false,
      "reference": "e8fd9254-dba4-448e-a537-4a670d720855",
      "status": "processing",
      "amount": "50.00",
      "currency": "USD",
      "payCurrency": "TRX",
      "payAmount": "363.663665",
      "payNetwork": "ttrx",
      "payNetworkName": "Tron",
      "txid": "b4ad13397e401b1238b73f5e9d99d507504096f5638e1c72cd35568f61a7139b",
      "networkFee": "2.000000",
      "networkFeeCurrency": "TRX",
      "payoutFee": "0.50",
      "payoutFeeCurrency": "USD",
      "exchangeRate": "0.1353703"
    }
  },
  "meta": {},
  "jsonapi": {
    "version": "1.0"
  }
}

HTTP 200

{
  "data": {
    "id": "c03bc7ec-8cf8-449c-9ba5-660364970682",
    "type": "payouts",
    "attributes": {
      "address": "TTbGTMwUwA3mncLP7xqCZei1ekaNSgeAJe",
      "createdAt": "2024-07-30T15:32:15.287Z",
      "absorbFees": false,
      "reference": "e8fd9254-dba4-448e-a537-4a670d720855",
      "status": "completed",
      "amount": "50.00",
      "currency": "USD",
      "payCurrency": "TRX",
      "payAmount": "363.663665",
      "payNetwork": "ttrx",
      "payNetworkName": "Tron",
      "txid": "b4ad13397e401b1238b73f5e9d99d507504096f5638e1c72cd35568f61a7139b",
      "networkFee": "2.000000",
      "networkFeeCurrency": "TRX",
      "payoutFee": "0.50",
      "payoutFeeCurrency": "USD",
      "exchangeRate": "0.1353703"
    }
  },
  "meta": {},
  "jsonapi": {
    "version": "1.0"
  }
}