Skip to main content
POST
/
api
/
v1
/
services
/
user
/
create-bank-account
[https://finlend.fincode.software/api/v1/services/user/create-bank-account](https://finlend.fincode.software/api/v1/services/user/create-bank-account)

{
  "status": "<string>",
  "data": {
    "accountId": "<string>",
    "customerId": "<string>",
    "accountNumber": "<string>",
    "accountName": "<string>",
    "bankCode": "<string>",
    "bankName": "<string>",
    "isDefault": true,
    "isVerified": true
  }
}
Customers can use this endpoint to register a bank account that can be used for loan disbursements, repayments, and fund transfers. 
[https://finlend.fincode.software/api/v1/services/user/create-bank-account](https://finlend.fincode.software/api/v1/services/user/create-bank-account)

​
Request Headers

​
X-Auth-Token
string
required
The JWT Access Token obtained from the /login or /refresh-token endpoint.
​
x-idempotency-key
string
required
Unique idempotency key for the request to prevent duplicate processing.
​
x-fapi-auth-date
string
required
The date and time at which the request was initiated (ISO 8601 format).
​
x-fapi-customer-ip-address
string
required
The IP address of the customer making the request.
​
x-fapi-interaction-id
string
required
Unique identifier for the interaction/session.
​
Content-Type
string
default:"application/json"
required
Must be application/json.

​
Request Body

​
customerId
string
required
The unique identifier (UUID) of the customer adding the bank account.
​
accountNumber
string
required
Bank account number.
​
accountName
string
required
Name of the account holder as it appears on the bank account.
​
bankCode
string
required
Code identifying the bank.
​
bankName
string
required
Name of the bank.
​
accountType
string
Type of account (e.g., SAVINGS, CURRENT, CHECKING).
​
isDefault
boolean
Whether this should be set as the default bank account.

​
Response

Returns confirmation of bank account creation with account details.
​
status
string
default:"SUCCESS"
Overall status of the API request.
​
data
object
Bank account details.

​
Code Examples

curl --location --request POST 'https://finlend.fincode.software/api/v1/services/user/create-bank-account' \
--header 'X-Auth-Token: YOUR_JWT_ACCESS_TOKEN' \
--header 'x-idempotency-key: unique-key-12345' \
--header 'x-fapi-auth-date: 2024-01-15T10:30:00Z' \
--header 'x-fapi-customer-ip-address: 192.168.1.1' \
--header 'x-fapi-interaction-id: interaction-12345' \
--header 'Content-Type: application/json' \
--data '{
    "customerId": "123e4567-e89b-12d3-a456-426614174000",
    "accountNumber": "1234567890",
    "accountName": "John Doe",
    "bankCode": "058",
    "bankName": "Guaranty Trust Bank",
    "accountType": "SAVINGS",
    "isDefault": true
}'