Create Payment Accounts

This method is used to create a virtual NGN account for the fintech partners' customers. Customers can then proceed to make a wire transfer to these accounts from their banking apps.

Every customer is automatically assigned a holding balance/profile by Oval Finance and this can be viewed when you retrieve customer information using the Get Customer by ID API

Funds received in this account is settled in the holding balance of the customer and the fintech partner can then decide to either initiate a savings deposit on behalf of the customer by using the Holdings Transfers ]API to move the funds to desired yield profile or they could move the funds between customers using the Intra Transfer API.

HTTP Method : POST
API Endpoint : {{baseurl}}/api/v1/intra-transfer

Sample cURL Request

curl --location --request POST 'https://sandbox-api.ovalfi-app.com/api/v1/payments/banks/account' \
--header 'Signature: 9b22497f8096b26ff60c32d1059b6f6fdb037c8ff4cd9280d2c4a8252f09a3c2' \
--data-raw '{
  "customer_id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
  "currency": "NGN",
  "reference": "ACC123456",
  "bvn": "12345678901",
  "phone_number": "+234809567890",
}'

Sample JSON Request

{
  "customer_id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
  "currency": "NGN",
  "reference": "ACC123456",
  "bvn": "12345678901",
  "phone_number": "+234809567890",
}

Response Parameters

{
    "status": 200,
    "data": {
       {
    "status": 200,
    "data": {
        "id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
        "customerID": "6ba7b810-9dad-11d1-80b4-00c04fd430c9",
        "businessID": "6ba7b810-9dad-11d1-80b4-00c04fd430c0",
        "accountID": "ACC123456",
        "accountDetail": {
          "iban": "",
          "sortCode": "",
          "notes": null,
          "bankPhone": "",
          "reference": "",
          "swiftCode": null,
          "bankAddress": "",
          "accountName": "John Doe",
          "accountNumber": "12345678",
          "bankName": "Alat Bank",
          "bankCode": "022",
          "routingNumber": "",
          "beneficiaryAddress": ""
        },
        "reference": "REF123456",
        "currency": "NGN",
        "createdAt": "2024-02-28T12:00:00Z",
        "updatedAt": "2024-02-28T13:30:00Z",
        "deletedAt": null
        },
    "message": "Successfully retrieved account details",
    "error": null
}
    },
    "message": "create account details successfully",
    "error": null
}