Initiate Transfer for customers
This method is called to initiate funds transfer to a specified beneficiary, while it returns the transfer instruction.
HTTP Method : POST
API Endpoint : {{baseurl}}/api/v1/transfer
Sample cURL Request
curl --location --request POST 'https://api.ovalfi-app.com/api/v1/transfer' \
--header 'Authorization: Bearer eyJidXNpbmVzc0lEIjoiZDA0MzE5ZDctYjNmYi00NzhlLWFkZTUtNzZjYzUxNzZlMWRkIiwidXNlcklEIjoiMmFhMjAwYzItMDMzZS00OTZhLTg1MDMtZDIzZDYwYjBiOTA0Iiwia2V5Ijoib2xhcHJvZzEifQ==' \
--header 'Signature: 4c52772ecdbc0ffc9f5b9994494cb2b37f6ecec63b4434243e8b84e9b99fbffc' \
--data-raw '{
"customer_id": "62fa5415-d7c0-4648-8e08-600a90bc95c9",
"amount": 2500,
"currency": "USD",
"destination": {
"bank_details": {
"account_number": "1000000",
"routing_number": "12345",
"bank_name": "213000",
"country": "US",
"city": "",
"bank_address": "",
"district": "",
"postal_code": "",
"is_within_us": "yes"
},
"personal_details": {
"name": "Kehinde ODETOLA",
"country": "US",
"city": "lagos",
"address": "egbatedo street, akowonjo",
"district": "",
"postalCode": ""
}
},
"note": "Some notes here. This field is optional",
"reason": "this field is compulsory and cannot be less than 5 characters",
"reference": "reff"
}'
Sample JSON Request
{
"customer_id": "5e37dc39-5b70-492a-a5ad-46c75d06111e",
"amount": 2500,
"currency": "GHS",
"destination": {
"bank_details": {
"account_number": "1000000",
"bank_name": "213000",
"country": "US",
"city": "",
"bank_address": "",
"district": "",
"postal_code": "",
"is_within_us": "yes"
},
"personal_details": {
"name": "Kehinde ODETOLA",
"country": "US",
"city": "lagos",
"address": "egbatedo street, akowonjo",
"district": "",
"postalCode": ""
}
},
"note": "Some notes here. This field is optional",
"reason": "this field is compulsory and cannot be less than 5 characters",
"reference": "refggggg"
Response Parameters
{
"customer_id": "62fa5415-d7c0-4648-8e08-600a90bc95c9",
"amount": 2500,
"currency": "USD",
"destination": {
"bank_details": {
"account_number": "1000000",
"routing_number": "12345",
"bank_name": "213000",
"country": "US",
"city": "",
"bank_address": "",
"district": "",
"postal_code": "",
"is_within_us": "yes"
},
"personal_details": {
"name": "Kehinde ODETOLA",
"country": "US",
"city": "lagos",
"address": "egbatedo street, akowonjo",
"district": "",
"postalCode": ""
}
},
"note": "Some notes here. This field is optional",
"reason": "this field is compulsory and cannot be less than 5 characters",
"reference": "reff"
}
Updated 8 months ago