POST
Initiate Transfer
Send funds to an external bank account.
POST/v2/transfers/interbank/initiate
Use this endpoint to initiate a transfer from a HexCore account to an external financial institution.
Headers
| Header | Required | Description |
|---|---|---|
Authorization | YES | Bearer token containing your secret API key. |
Body Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
source_account | string | YES | HexCore account number to debit. |
destination_bank_code | string | YES | CBN or switch routing code of the receiving bank. |
destination_account | string | YES | Account number at the receiving bank. |
amount | number | YES | Amount to transfer. |
narration | string | YES | Description of the transfer. |
Example Request
cURL
curl -X POST "https://sandbox.hexcore.io/v2/transfers/interbank/initiate" \-H "Authorization: Bearer sk_test_your_secret_key" \-H "Content-Type: application/json" \-d '{"source_account": "1234567890", "destination_bank_code": "058", "destination_account": "0987654321", "amount": 50000, "narration": "Payment for services"}'Example Response
JSON (200 OK)
{"status": true,"message": "Transfer initiated","data": { "reference": "trf_89sjd89sjd8", "status": "PROCESSING"} }