> For the complete documentation index, see [llms.txt](https://alfred.gitbook.io/alfred-integration-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://alfred.gitbook.io/alfred-integration-docs/penny-api-general-integration/penny-api-operations/add-bank-or-update-bank.md).

# 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).