Step 3: Creating a Transfer
This endpoint is used to facilitate internal transfers. They can be defined by a few scenarios:
The movement of funds between a BVNK user to their customer, their customer to the BVNK user, and from a BVNK user's customer to another customer of the BVNK user.
BETA Endpoints
Please note that these endpoints are currently in beta, and they may undergo changes as we continue to improve and refine the functionality.
Request:
Environment | Endpoint |
---|---|
Production | POST https://api.bvnk.com/payment/api/v1/transfers |
Sandbox | POST https://api.sandbox.bvnk.com/payment/api/v1/transfers |
curl --request POST \
--url 'https://api.sandbox.bvnk.com/payment/api/v1/transfers' \
--header 'X-Idempotency-Key: f21b904d-8edb-46b0-b049-e611b1994e1d' \
--header 'Authorization: Hawk id="B9jnE1U8eLblzHtNeJZRxfcq03CQKcmcP9FOrACMzXb1HfrxrePWsTfuP70JNns9", ts="1633010032", nonce="guGXrD", mac="uKeg+w1qXqzaF/8mOQGv8Y9IlRxyxTT+iINLe03EQ60="' \
--header 'Content-Type: application/json' \
--data '{
"walletId": "{{walletId}}",
"amount": {
"value": 1000.00,
"currency": "USD"
},
"paymentReference": "{{randomAlphaNumeric}}",
"instruction": {
"type": "WALLET",
"beneficiaryWalletId": "{{walletId}}"
}
}'
Successful response:
{
"transactionReference": "{transaction_id}",
"fee": {
"value": 0.00,
"currency": "USD"
}
}
Response Header: LOCATION: https://api.sanbox.bvnk.com/payment/api/v1/transfers/{transaction_id}
Updated 9 days ago