Create Customer

This method is called to create a customer record in Oval under the fintech partners’ profile. A unique Customer ID would be automatically generated upon successful creation and this identifies the customer for all subsequent transactions within Oval Finance and should be stored by the fintech partner.

A customer once created is automatically granted access to all Ovals’ services.

Visit this page to guide you on generating your signature and API keys

HTTP Method : POST
API Endpoint : {{baseurl}}/api/v1/customer

Sample cURL Request

curl --location --request POST 'https://dev-api.ovalfi-app.com/api/v1/api/v1/customer' \
--header 'Authorization: Bearer eyJidXNpbmVzc0lEIjoiZDA0MzE5ZDctYjNmYi00NzhlLWFkZTUtNzZjYzUxNzZlMWRkIiwidXNlcklEIjoiMmFhMjAwYzItMDMzZS00OTZhLTg1MDMtZDIzZDYwYjBiOTA0Iiwia2V5Ijoib2xhcHJvZzEifQ==' \
--header 'Signature: b1e399b4bcf4efc044337da9a4c19d1e94ad87da34aeb14e889ba5af5aed4ab5' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name":"Dunsin Oyekan",
    "mobile_number": "071129092190",
    "email":"lalaegj190@gmail.com",
    "reference":"ref567"
}'

Sample JSON Request

{
    "name":"Dunsin Oyekan",
    "mobile_number": "071129092190",
    "email":"lalaegj190@gmail.com",
    "reference":"ref567"
}

Response Parameters

{
    "status": 200,
    "data": {
        "id": "6c19686b-9617-4a6c-bbca-f37a522e0c9b",
        "customer_name": "Dunsin Oyekan",
        "mobile_number": "071129092190",
        "email": "lalaegj190@gmail.com",
        "created_at": "2022-10-25T12:54:21.855609424+01:00",
        "updated_at": null,
        "channel": "api",
        "reference": "ref567",
    },
    "message": "User account created successfully!",
    "error": null
}

🚧
OvalFi would not be responsible for the KYC of the individual account creation, this is expected to be done by the partners/business entities only.
However, our compliance team would verify the flow before access to the production environment.