How payouts work
When you initiate a payout, PIK debits the specified amount from the wallet balance in the given currency and sends it to the external destination. The payout moves through the relevant rail — domestic bank transfer for AUD, SWIFT or local rails for international fiat, or on-chain for crypto. PIK confirms the payout once the transfer is dispatched. For crypto payouts, confirmation happens once the transaction is broadcast on-chain. For bank payouts, confirmation happens once PIK has submitted the transfer to the banking network — actual receipt at the destination bank may take additional time.Payout types
AUD domestic payout — Send AUD from a PIK wallet to any Australian bank account via BSB and account number. Settlement typically occurs within one business day. NPP-enabled transfers may settle faster. International fiat payout — Send USD, HKD, SGD, or other supported fiat currencies to an international bank account via SWIFT or local payment rails. Settlement times vary by corridor and currency. Crypto payout — Send USDT or USDC from a PIK wallet to any compatible external crypto wallet address. The transfer is broadcast on-chain and typically confirms within minutes.Creating a payout
Call POST /api/v1/payouts with the following fields: currency — The currency to send, for example AUD, USDT, or USD. amount — The amount to send as a decimal string, for example 500.00. destination_type — Set to bank_account for fiat payouts or crypto_address for crypto payouts. destination — An object containing the payout destination details. For bank_account, include bsb, account_number, and account_name. For crypto_address, include address and network. reference — An optional string for your records and for the beneficiary’s statement. x-on-behalf-of header — Set to the connected account ID if paying out from a connected account wallet. Omit to pay out from the platform wallet.Destination fields for bank payouts
For AUD domestic payouts:- bsb — The six-digit BSB of the destination bank.
- account_number — The destination account number.
- account_name — The name on the destination account.
- swift_code — The SWIFT/BIC code of the destination bank.
- account_number — The destination account number or IBAN.
- account_name — The name on the destination account.
- bank_name — The name of the destination bank.
- bank_address — The address of the destination bank.
- country — The two-letter ISO country code of the destination bank.
Destination fields for crypto payouts
- address — The destination wallet address.
- network — The blockchain network. Currently supported: solana for USDT and USDC payouts.
Payout statuses
- pending — Payout request received and queued for processing.
- processing — Payout submitted to the banking network or broadcast on-chain.
- completed — Payout confirmed. Funds dispatched to the destination.
- failed — Payout could not be completed. Check the failure_reason field.
- returned — Funds were sent but returned by the destination bank. Returned funds are credited back to the originating wallet.
