Payouts concept
General
Payouts refer to sending cryptocurrency and token transactions from either your fiat or cryptocurrency accounts on the Txn platform to external wallets and recipients. Payouts typically include the amount, currency, payment network, and receiving wallet address of a payout recipient. Txn processes each payout request immediately to broadcast a cryptocurrency or token transaction on the relevant network as soon as possible, meaning we do not batch multiple payout requests to process them at once.
When sending payout requests, merchants need to consider the fees deducted either from the payout amount or the merchant account balance before a transaction gets broadcast - the payout fees and network fees.
The payout fee is the platform fee that the Txn platform charges for providing services
The network fee is a fee taken by the Txn platform to cover blockchain fees. Txn doesn't control the blockchain fees required by miners; hence, we can only update the network fee settings on our side in a timely manner to keep it around the average blockchain fee necessary for including transactions in the next block. Please expect network fees to update over time without prior notification
Fees
Merchants can use the absorbPayoutFee
and absorbNetworkFee
boolean parameters in their payout requests to control how both the payout fee and network fee are deducted.
Fees can either be:
Absorbed by the merchant (deducted from their account balance), or
Deducted from the payout amount, reducing the amount the recipient receives.
Examples
Case 1
absorbPayoutFee = true
and absorbNetworkFee = true
Both fees are absorbed by the merchant, ensuring the recipient receives the full intended payout amount.
Formula:
amountCharged = payoutAmount + payoutFee + networkFee * rate
paidAmount = payoutAmount / rate
Case 2
absorbPayoutFee = false
and absorbNetworkFee = false
Both fees are deducted from the payout amount. The recipient receives less cryptocurrency by the combined impact of both fees.
Formula:
amountCharged = payoutAmount
paidAmount = (payoutAmount - payoutFee) / rate - networkFee
Case 3
absorbPayoutFee = true
and absorbNetworkFee = false
The merchant absorbs the payout fee, but the network fee is deducted from the payout amount.
Formula:
amountCharged = payoutAmount + payoutFee
paidAmount = payoutAmount / rate - networkFee
Case 4
absorbPayoutFee = false
and absorbNetworkFee = true
The payout fee is deducted from the payout amount, reducing the payout amount. The merchant absorbs the network fee.
Formula:
amountCharged = payoutAmount + networkFee * rate
paidAmount = (payoutAmount - payoutFee) / rate
Regardless of the selected option, we strongly encourage merchants to thoroughly test payouts in our Sandbox environment before going live. Additionally, it’s advisable to cross-check transaction data from an accounting and reconciliation perspective to ensure your Finance and Reconciliation teams understand how transactions and fees are processed.
Here’s a concise comparison table summarizing all combinations of absorbPayoutFee
and absorbNetworkFee
, including who pays which fee and how it affects the recipient:
absorbPayoutFee
absorbNetworkFee
Who Pays Payout Fee
Who Pays Network Fee
amountCharged
paidAmount
true
true
Merchant (account balance)
Merchant (account balance)
payoutAmount + payoutFee + networkFee * rate
payoutAmount / rate
false
false
Recipient (deducted from payout)
Recipient (deducted from crypto)
payoutAmount
(payoutAmount - payoutFee) / rate - networkFee
true
false
Merchant (account balance)
Recipient (deducted from crypto)
payoutAmount + payoutFee
payoutAmount / rate - networkFee
false
true
Recipient (deducted from payout)
Merchant (account balance)
payoutAmount + networkFee * rate
(payoutAmount - payoutFee) / rate
Payout Limits
Another thing to consider is the minimum and maximum limits for payout amounts. You can refer to Payout Limitations.
Address Validation
Upon receiving a payout request, the Txn platform automatically validates the receiving wallet address format and also evaluates its risk level to ensure a payout will not be sent to a wallet connected to illegal activities or involves any sanctions-related risks for the Txn merchant. In either case, the payout request is rejected by the Txn platform straight away.
To make the customer experience even smoother for your end-users, we recommend using the Validate Address endpoint before creating crypto payouts.
Quick example:
Collect a wallet address from your customer
Make a call to validate the wallet address upfront to ensure your Create Payout call will pass without errors
Make a call to create a payout
Last updated