Skip to main content
POST
Send payment

Overview

Send a payment using the specified payment method. Supported methods include bank_transfer, card, mobile_money, tag_transfer (wallet-to-wallet), defi, revolut, paypal, ussd, cashapp, and zelle. Provide from_amount, from_wallet_id, to_currency, payment_method, and info (recipient details; fields depend on the method). For tag transfer, info must include tag_id. Payments can be instant, scheduled, or recurring.

Authorizations

X-API-KEY
string
header
required

API key for authentication.

Body

application/json
from_amount
number
required

Amount to send (source currency)

Required range: x >= 0.01
from_wallet_id
string
required

Wallet ID to debit from

to_currency
string
required

Destination currency (e.g. NGN, USD)

payment_method
string
required

One of: card, bank_transfer, mobile_money, wallet, tag_transfer, defi, revolut, paypal, cashapp, zelle, ussd

info
object
required

Recipient details; required fields depend on payment_method (e.g. account_number, bank_code, account_name for bank_transfer; tag_id for tag_transfer)

is_save_to_beneficiary
boolean

Save recipient as beneficiary

reference
string

Idempotency or client reference

document
string

Base64-encoded document (e.g. invoice)

payment_type
object
approver
string

Account UID to notify for approval (non-owner)

Response

Payment initiated successfully

status
boolean
data
object
error
any[]
message
string