# Add Bank or Update Bank

***

### Description:

This endpoint is designed to facilitate the addition or updating of a user's bank details. By providing essential bank information, users can ensure their financial details are accurate and up-to-date in the system.

**Mode:**

`POST`

#### Node:

```bash
/third-party-service/update-bank
```

<mark style="color:green;">`POST`</mark> `/third-party-service/update-bank`

Add or update User's bank

#### Headers

| Name                                            | Type                                                                                                                                                 | Description                                                    |
| ----------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------- |
| API-Key<mark style="color:red;">\*</mark>       | String                                                                                                                                               | Your API key for authentication.                               |
| API-Secret<mark style="color:red;">\*</mark>    | String                                                                                                                                               | Your API secret for enhanced security.                         |
| Authorization<mark style="color:red;">\*</mark> | eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VybmFtZSI6IkBub3ZhNDciLCJzdWIiOjExNywiaWF0IjoxNjg5MDk1MDI3fQ.0BHv\_jc6etSqAuTinoKxSiXnmrC4XLfiezRQZbNG8cA | Access token obtained from the KYC Lite process. Example token |

#### Request Body

| Name                                                 | Type                            | Description                                                                                                                   |
| ---------------------------------------------------- | ------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| "bankName"<mark style="color:red;">\*</mark>         | "Banco Industrial de Argentina" |                                                                                                                               |
| "bankNumber"<mark style="color:red;">\*</mark>       | "345854122904778"               |                                                                                                                               |
| "bankAccountOwner"<mark style="color:red;">\*</mark> | "Francisco Guevara"             | If this value differs from the user's token name, the system will default to the full name in the token. "countryCode": "ARG" |
| "countryCode"<mark style="color:red;">\*</mark>      | "ARG"                           |                                                                                                                               |
| "id"<mark style="color:red;">\*</mark>               | 59                              | Example ID                                                                                                                    |
| "DNI"<mark style="color:red;">\*</mark>              | String                          | Identification number assigned by your bank                                                                                   |

{% tabs %}
{% tab title="202: Accepted " %}

```json
// 
{
    "statusCode": 202,
    "data": {
        "statusCode": 202,
        "message": "banks user data",
        "data": {
            "bankName": "Banco",
            "bankNumber": "345854122904778",
            "bankAccountOwner": "Francisco",
            "countryCode": "ARG",
            "icon": null,
            "active": true,
            "id": 59
            "DNI": "56"
        }
    },
    "message": "bank"
}
```

{% endtab %}
{% endtabs %}

#### Considerations:

Always ensure that the `bankAccountOwner` is correct. If it differs from the name associated with the user's token, the system will default to using the full name from the token.

**Registration by Country:**

* **BRA:** Register a PIX account\
  \&#xNAN;*Local processor: PIX*
* **ARG**: CVU/CBU account\
  \&#xNAN;*Local processor: COELSA*&#x20;
* **MEX:** CLABE account \
  \&#xNAN;*Local processor: SPEI*&#x20;

*Note\*\* These accounts registered will be used to be the recipient bank accounts in "Pay Out Bank". These accounts must be the origin accounts for the "Pay In bank" already registered in alfred.* [<br>](/alfred-integration-docs/welcome/alfred-overview/required-documents-for-kyc-by-country.md)

Specific Information regarding KYC Documents by country can be found [here](/alfred-integration-docs/welcome/alfred-overview/required-documents-for-kyc-by-country.md).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://alfred.gitbook.io/alfred-integration-docs/penny-api-general-integration/penny-api-operations/add-bank-or-update-bank.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.