> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fincode.technology/llms.txt
> Use this file to discover all available pages before exploring further.

# Add Bank Details

> Links a validated bank account to a beneficiary profile.

After creating a beneficiary, use this endpoint to associate their bank account details.

## Request Headers

<ParamField header="X-Auth-Token" type="string" required>
  The **JWT Access Token** of the authenticated user.
</ParamField>

<ParamField header="platform" type="string" required default="fincode">
  Platform identifier. Use `fincode`.
</ParamField>

<ParamField header="uuid" type="string" required default="200">
  Unique request identifier.
</ParamField>

## Request Body

<ParamField body="id" type="string" required>
  The unique ID of the beneficiary (returned from `new-beneficiary`).
</ParamField>

<ParamField body="customerId" type="string" required>
  The unique ID of the customer (sender).
</ParamField>

<ParamField body="accountOwnerCustomerCode" type="string" required>
  The sender's customer code.
</ParamField>

<ParamField body="currencyCode" type="string" required>
  The currency of the bank account.
</ParamField>

<ParamField body="country" type="string" required>
  ISO 3166-1 alpha-3 country code.
</ParamField>

<ParamField body="bankAccountMetaData" type="array" required>
  Key-value pairs of the bank details.

  <Expandable title="bankAccountMetaData item">
    <ParamField body="key" type="string" required>
      Field key (e.g., `bankname`, `bankaccountno`).
    </ParamField>

    <ParamField body="value" type="string" required>
      Field value.
    </ParamField>
  </Expandable>
</ParamField>

## Code Example

```bash cURL theme={null}
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"}
    ]
}'
```


## OpenAPI

````yaml POST /bankmanagement/add-bank-details-key-value-pairs
openapi: 3.0.0
info:
  title: FinCode API
  version: v6
servers:
  - url: https://{tenant}.fincode.software/api/v6/services
    description: API v6
    variables:
      tenant:
        default: remitjunction
        description: Enter your tenant subdomain
  - url: https://{tenant}.fincode.software/api/v1/services
    description: API v1
    variables:
      tenant:
        default: finlend
        description: Enter your tenant subdomain
  - url: https://api.stag.songhaiexchange.io
    description: Songhai Exchange API
security: []
paths:
  /bankmanagement/add-bank-details-key-value-pairs:
    post:
      summary: Add Bank Details
      description: Links bank account to beneficiary
      operationId: addBankDetails
      parameters:
        - $ref: '#/components/parameters/platformHeader'
        - $ref: '#/components/parameters/uuidHeader'
        - in: header
          name: X-Auth-Token
          schema:
            type: string
          required: true
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                id:
                  type: string
                customerId:
                  type: string
                accountOwnerCustomerCode:
                  type: string
                currencyCode:
                  type: string
                country:
                  type: string
                bankAccountMetaData:
                  type: array
                  items:
                    type: object
              required:
                - id
                - customerId
                - accountOwnerCustomerCode
                - currencyCode
                - country
                - bankAccountMetaData
      responses:
        '200':
          description: Bank details added
components:
  parameters:
    platformHeader:
      in: header
      name: platform
      schema:
        type: string
        default: fincode
      required: true
    uuidHeader:
      in: header
      name: uuid
      schema:
        type: string
        default: '200'
      required: true

````