Initiate Transfer

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"
}