Listing payouts

GET /api/public/v1/payouts

This endpoint returns a list of payouts with pagination.

Headers

NameValue

Content-Type

application/vnd.api+json

Authorization

Bearer <api_key>

Query Parameters

NameTypeDescription

order

string

Order in which the list of payouts should be returned. Can be created_at.

order_type

string

Order type. Can be either asc or desc.

page

number

Page for which you want to return payouts.

per_page

number

Number of payouts per page to return.

reference

number

Payout reference.

Response Body

NameTypeDescription

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

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

{
  "data": [
    {
      "id": "dfa4b8dc-6b7c-481a-b486-71f6db5126fc",
      "type": "payouts",
      "attributes": {
        "address": "TTbGTMwUwA3mncLP7xqCZei1ekaNSgeAJe",
        "createdAt": "2024-07-30T15:35:40.253Z",
        "absorbFees": false,
        "reference": "44650aff-f7dd-49e5-ad59-01e667112a31",
        "status": "processing",
        "amount": "50.00",
        "currency": "USD",
        "payCurrency": "USDT",
        "payAmount": "45.020195",
        "payNetwork": "ttrx:usdt",
        "payNetworkName": "Tron (TRC20)",
        "txid": null,
        "networkFee": "4.000000",
        "networkFeeCurrency": "USDT",
        "payoutFee": "0.50",
        "payoutFeeCurrency": "USD",
        "exchangeRate": "1.0097879"
      }
    },
    {
      "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": {
    "page": "1",
    "per_page": "2",
    "total": 20
  },
  "jsonapi": {
    "version": "1.0"
  }
}

Last updated