curl --request POST \
--url https://api.useglyde.co/v1/transfer/initiate \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"amount": 5000,
"currency": "NGN",
"bank_code": "058",
"account_number": "0264341458",
"reference": "txn_abc123xyz"
}
'{
"status": "success",
"message": "Transaction initiated successfully",
"data": {
"reference": "<string>",
"merchant_reference": "<string>",
"type": "debit",
"amount": "5000",
"status": "pending",
"fee": "25",
"created_at": "<string>"
}
}{
"status": "failed",
"message": "The provided currency is not supported.",
"data": {},
"errors": {}
}Initiate Transfer
Initiate a bank transfer to a recipient’s account.
Payouts are available in NGN and ZAR. The transfer debits the wallet of the currency it
names, falling back to your business’ home currency when currency is omitted. Bank
codes are only unique within a market, so the code must belong to the payout currency’s
country.
ZAR has no account name enquiry rail, so rand payouts must carry account_name and may
carry account_type.
curl --request POST \
--url https://api.useglyde.co/v1/transfer/initiate \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"amount": 5000,
"currency": "NGN",
"bank_code": "058",
"account_number": "0264341458",
"reference": "txn_abc123xyz"
}
'{
"status": "success",
"message": "Transaction initiated successfully",
"data": {
"reference": "<string>",
"merchant_reference": "<string>",
"type": "debit",
"amount": "5000",
"status": "pending",
"fee": "25",
"created_at": "<string>"
}
}{
"status": "failed",
"message": "The provided currency is not supported.",
"data": {},
"errors": {}
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
The transfer amount in major units of the payout currency (5000 = NGN 5,000). Must be within your configured minimum and maximum limits.
5000
The recipient's bank code from /v1/banks. 3-digit CBN codes for NGN, 6-digit universal branch codes for ZAR.
"058"
The recipient's account number. 10 digits for NGN, 7-11 digits for ZAR.
"0264341458"
Your unique reference for this transfer, used for idempotency and tracking.
"txn_abc123xyz"
Uppercase ISO code of the wallet to debit. Defaults to your business' home currency. Only currencies cleared for payouts are accepted.
NGN, ZAR "ZAR"
The recipient's account name. Required for ZAR payouts, where no name enquiry rail exists. Ignored for NGN, which resolves the name through the provider.
"Thabo Mokoena"
The recipient's account type. Used for ZAR payouts only.
savings, current, cheque "savings"
Was this page helpful?