Txn.pro - API Documentation
Sandbox LoginChangelogStatus Page
  • Getting setup
    • Environments
    • Creating a Sandbox account
    • Back office user roles
    • Creating your API keys
    • Postman collection
  • API Basics
    • API specification
    • API status
    • Supported currencies
    • Date and time format
    • Authenticating the API
    • Webhooks
      • Verifying webhooks
      • Source IP addresses
      • Retrying schedule
    • Rate limits
  • Hosted pages
  • Accounts
    • Accounts concept
    • Listing accounts
    • Reading account
    • Listing account addresses
    • Creating account address
    • Listing account transactions
    • Reading account transaction
  • Exchange
    • Exchange concept
    • Supported currency pairs
    • Reading exchange rates
    • Exchange webhooks
    • Creating quote
    • Confirming quote
  • Invoices
    • Invoices concept
    • Invoice status flow
    • Invoices in cashier
    • Invoice limitations
    • Listing invoice currency pairs
    • Invoice webhooks
    • Creating invoice
    • Reading invoice
    • Listing invoices
    • Invoice refunds
  • Payouts
    • Payouts concept
    • Payout status flow
    • Payout limitations
    • Listing payout currency pairs
    • Validating addresses
    • Payout webhooks
    • Creating payout
    • Reading payout
    • Listing payouts
  • Mass Payouts
  • PAYMENT LINKS
    • Payment links concept
    • Creating payment link
    • Expiring payment link
    • Reading payment link
    • Listing payment links
  • CHANNELS
    • Channels concept
    • Channels deposit flow
    • Listing channel currency pairs
    • Channel webhooks
    • Creating channel
    • Reading channel
    • Updating channel
    • Listing channels
    • Listing channel deposits
    • Reading channel deposit
  • (BETA) Fiat Settlements
    • Important information
    • Bank withdrawal webhooks
    • Bank deposit webhooks
    • Listing bank accounts
    • Reading bank account
    • Previewing bank withdrawal
    • Creating bank withdrawal
    • Listing bank withdrawals
    • Reading bank withdrawal
    • Listing bank deposits
    • Reading bank deposit
Powered by GitBook
On this page
  1. Payouts

Listing payouts

GET /api/public/v1/payouts

This endpoint returns a list of payouts with pagination.

Headers

Name
Value

Content-Type

application/vnd.api+json

Authorization

Bearer <api_key>

URL Parameters

Name
Type
Description

order

string

Order in which the list of transactions 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 transactions.

per_page

number

Number of transactions per page to return.

reference

number

Payout reference.

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

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.

data.attributes.currency

string

Payout amount currency code.

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 processing fee amount taken from the merchant's account.

data.attributes.payoutFeeCurrency

string

Payout fee currency.

data.attributes.displayFee

string

Fee associated with the payout represented in data.attributes.currency. For example, if the payout currency is TRY, the fee is also expressed in TRY.

data.attributes.displayFeeCurrency

string

Fee associated with the payout represented in data.attributes.currency. For example, if the payout currency is TRY, the fee is also expressed in TRY.

data.attributes.amountCharged

string

The amount deducted from the merchant's account.

data.attributes.amountChargedCurrency

string

The amount deducted from the merchant's account.

data.attributes.payChargeRate

string

Pay currency to charge currency exchange rate applied by Txn. E.g., XRP/EUR.

data.attributes.payChargeRateCurrency

string

Pay currency to charge currency exchange rate applied by Txn.

data.attributes.exchangeRate

string

Pay currency to payout currency exchange rate applied by Txn. E.g., XRP/TRY.

Response

{
  "data": [
    {
      "id": "9b4317e2-f369-4e00-9e65-6ee7d59667a4",
      "type": "payouts",
      "attributes": {
        "address": "rLsBa2vWV2uuPx2UKbocAZG2WHXoaGyMPf?dt=61",
        "expiresAt": "2025-01-31T09:48:01.580Z",
        "createdAt": "2025-01-31T09:47:31.580Z",
        "absorbFees": true,
        "reference": "c2b091dc-d140-44fc-a9de-58c405a67af3",
        "status": "completed",
        "amount": "2000.00",
        "currency": "TRY",
        "payCurrency": "XRP",
        "payAmount": "17.901661",
        "payNetwork": "txrp",
        "payNetworkName": "Ripple",
        "txid": "5DC730018F5DF5F3AB28E1209061111B3737EFC369774FF04F22773ABFFE46A0",
        "networkFee": "1.000000",
        "networkFeeCurrency": "XRP",
        "payoutFee": "0.54",
        "payoutFeeCurrency": "EUR",
        "displayFee": "20.00",
        "displayFeeCurrency": "TRY",
        "exchangeRate": "111.72147825",
        "amountCharged": "57.16",
        "amountChargedCurrency": "EUR",
        "payChargeRate": "2.99537619",
        "payChargeRateCurrency": "EUR"
      }
    }
  ],
  "meta": {
    "page": 1,
    "per_page": 1,
    "total": 237
  },
  "jsonapi": {
    "version": "1.0"
  }
}
PreviousReading payoutNextMass Payouts

Last updated 3 months ago

Payout status. Refer to .

Refer to .

Payout Status Flow
Supported Currencies