Submit Customer Account Info
Request
Method: POST
Endpoint:
{{base_url}}/api/v1/bank-account/customer
Headers
| Header | Type | Required | Description |
|---|---|---|---|
x-merchant-ref | String | Yes | Your unique merchant reference. |
This endpoint does not require an
Authorizationheader.
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
| Field | Type | Required | Description |
|---|---|---|---|
user_ref | String | Yes | Unique reference of the user whose wallet the fund source will be assigned to. |
Response
Success Response
Updated 11 days ago
Did this page help you?
