{
"id": "pd_7Kq2mNv4XbR9dLc0",
"name": "My GTBank Savings",
"type": "bank_account",
"currency": "NGN",
"status": "approved",
"status_reason": null,
"is_usable": true,
"is_default": false,
"account_number": "0123456789",
"account_name": "JOHN DOE",
"bank_code": "058",
"bank_name": "Guaranty Trust Bank",
"phone_number": null,
"mobile_provider": null,
"wallet_address": null,
"network": null,
"reviewed_at": null,
"created_at": "2026-01-24T14:30:00.000Z",
"updated_at": "2026-01-24T14:30:00.000Z"
}The payout destination object
A payout destination is where a balance pays out to: a bank account, mobile money wallet, or crypto wallet. It is verified once when you register it, and payouts reference it by id.
Response containing payout destination details (bank account, mobile money, or crypto wallet).
Unique identifier for this payout destination. Use this ID when creating payouts.
"pd_7Kq2mNv4XbR9dLc0"
User-friendly name for this destination. Helps you identify destinations in your system.
"My GTBank Savings"
Type of payout destination: bank_account, mobile_money, or crypto_wallet. Determines which fields are populated.
bank_account, mobile_money, crypto_wallet "bank_account"
Currency code this destination accepts (e.g., 'NGN', 'USD', 'USDT_TRC20'). Payouts to this destination must use this currency.
"NGN"
Review status. pending_review: awaiting review, not usable yet. approved: cleared for payouts. rejected: permanently unusable, register a new destination instead.
pending_review, approved, rejected "approved"
Free-text reason set by review, populated when the destination is rejected. Null while pending or approved.
null
Whether this destination can be used for a payout right now. True only when status is approved and the destination has not been deactivated.
true
Whether a payout schedule pays out to this destination for its currency. Set it with PATCH /v1/payouts/destinations/{destination_id}.
false
Bank account number. Only populated for bank_account destinations.
"0123456789"
Account holder name as resolved from the bank. Only populated for bank_account destinations.
"JOHN DOE"
Bank code or routing number. Only populated for bank_account destinations.
"058"
Full name of the bank. Only populated for bank_account destinations.
"Guaranty Trust Bank"
Phone number associated with the mobile money account. Only populated for mobile_money destinations.
null
Mobile money provider (e.g., 'MTN', 'Vodafone'). Only populated for mobile_money destinations.
null
Cryptocurrency wallet address. Only populated for crypto_wallet destinations.
null
Blockchain network (e.g., 'TRC20', 'ERC20'). Only populated for crypto_wallet destinations. May be included in currency code (e.g., 'USDT_TRC20').
null
ISO 8601 timestamp when this destination was last reviewed by an admin. Null until reviewed.
null
ISO 8601 timestamp when this destination was created.
"2026-01-24T14:30:00.000Z"
ISO 8601 timestamp when this destination was last updated.
"2026-01-24T14:30:00.000Z"