Skip to main content
POST
/
bankmanagement
/
add-bank-details-key-value-pairs
Add Bank Details
curl --request POST \
  --url https://{tenant}.fincode.software/api/v6/services/bankmanagement/add-bank-details-key-value-pairs \
  --header 'Content-Type: application/json' \
  --header 'X-Auth-Token: <x-auth-token>' \
  --header 'platform: <platform>' \
  --header 'uuid: <uuid>' \
  --data '
{
  "id": "<string>",
  "customerId": "<string>",
  "accountOwnerCustomerCode": "<string>",
  "currencyCode": "<string>",
  "country": "<string>",
  "bankAccountMetaData": [
    {}
  ]
}
'
After creating a beneficiary, use this endpoint to associate their bank account details.

​
Request Headers

​
X-Auth-Token
string
required
The JWT Access Token of the authenticated user.
​
platform
string
default:"fincode"
required
Platform identifier. Use fincode.
​
uuid
string
default:"200"
required
Unique request identifier.

​
Request Body

​
id
string
required
The unique ID of the beneficiary (returned from new-beneficiary).
​
customerId
string
required
The unique ID of the customer (sender).
​
accountOwnerCustomerCode
string
required
The sender’s customer code.
​
currencyCode
string
required
The currency of the bank account.
​
country
string
required
ISO 3166-1 alpha-3 country code.
​
bankAccountMetaData
array
required
Key-value pairs of the bank details.

​
Code Example

cURL
curl -X POST 'https://remitjunction.fincode.software/api/v6/services/bankmanagement/add-bank-details-key-value-pairs' \
--header 'X-Auth-Token: YOUR_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
    "id": "beneficiary_uuid",
    "customerId": "customer_uuid",
    "accountOwnerCustomerCode": "RZ0LNK",
    "currencyCode": "NGN",
    "country": "NGA",
    "bankAccountMetaData": [
        {"key": "bankname", "value": "FCMB"},
        {"key": "bankaccountno", "value": "8883968718"},
        {"key": "country", "value": "NGA"},
        {"key": "accountholdername", "value": "VICTOR ADEBIYI ADEYINKA"}
    ]
}'

Headers

​
platform
string
default:fincode
required
​
uuid
string
default:200
required
​
X-Auth-Token
string
required

Body

application/json
​
id
string
required
​
customerId
string
required
​
accountOwnerCustomerCode
string
required
​
currencyCode
string
required
​
country
string
required
​
bankAccountMetaData
object[]
required

Response

200

Bank details added