Submit Customer Account Info

Request

Method: POST

Endpoint:

{{base_url}}/api/v1/bank-account/customer

Headers

HeaderTypeRequiredDescription
x-merchant-refStringYesYour unique merchant reference.

This endpoint does not require an Authorization header.

Request Body

{
  "user_ref": "{{vault:Merchant-user-ref}}",
  "customer_reference": "cust_001",
  "customer_info": {
    "first_name": "Teslim",
    "last_name": "Ayantola",
    "date_of_birth": "1993-04-20",
    "email": "[email protected]",
    "nationality": "NG",
    "gender": "m",
    "nin": "{{vault:nin}}",
    "bvn": "{{vault:bvn}}",
    "phone": "{{vault:phone}}",
    "address": {
      "line_1": "16 Ave maria",
      "city": "Port Harcourt",
      "state": "Rivers",
      "postal_code": "10001",
      "country_code": "NG"
    },
    "identification": {
      "type": "national_id",
      "number": "{{vault:nin}}",
      "issue_date": "2026-07-23",
      "expiry_date": "2030-07-23",
      "issuing_country": "NG",
      "issuing_authority": "Nigeria",
      "id_subtype": "NIN"
    },
    "proof_of_address_type": "bank_statement"
  },
  "documents": {
    "identity": {
      "file_url": "https://stora.IN%20FRONT.jpeg",
      "file_back_url": "https://storage"
    "proof_of_address": {
      "file_url": "https://storage.fuspay.us/ZEN_2026101"
  }
}

Request Fields

FieldTypeRequiredDescription
user_refStringYesUnique reference of the user whose wallet the fund source will be assigned to.

Response

Success Response


Did this page help you?