Customer CLABE Management

⚠️
IMPORTANT
To follow the steps below, it is essential to have the corresponding Authorization Token. For more information, please refer to the following documentation page: Authorization Token

Create Customer CLABE

Endpoint

POST https://ecartpay.com/api/customers/{customerId}/clabes
POST https://sandbox.ecartpay.com/api/customers/{customerId}/clabes

Headers

Authorization: token

Path Parameters

customerId: The id associated to the customer.

Request Payload

clabe : The 18-digit standard interbank number.
bank_code : The standard 3-digit code representing the Mexican bank. See the Bank Codes Catalog below for further details.
bank_name : Name of the financial institution.
customer_rfc : The tax ID (RFC) of the account holder.
alias : (Optional) A descriptive name for the account (e.g., "Personal Savings").

Examples

Request

curl --location 'https://sandbox.ecartpay.com/api/customers/6944a4946afaf625504595e3/clabes' \
--header 'Authorization: eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY4YTRjMzE1MGIyOGE5NTg0MzA1YTJhYSIsImFjY291bnRfaWQiOiI2OGE0YzMxNTBiMjhhOTU4NDMwNWEyYTYiLCJhY2NvdW50Ijp7ImVtYWlsIjoiaHVnby5tb3JpbkBlY2FydHBheS5jb20iLCJmaXJzdF9uYW1lIjoiSHVnbyIsImxhc3RfbmFtZSI6Ik1vcsOtbiIsInBob25lIjoiNTI.....' \
--header 'Content-Type: application/json' \
--header 'Cookie: __cf_bm=C4zOk2opFVctJ3DYgyiBFGCygevp10BAc873Md.abfU-1766105279-1.0.1.1-E8D6c1bihRoOPUsgJq9LuaOEoJHeCwNnMo6wRiGDdlOXPPZFyyeQQTWQcdptbrgniXSYr8Dz9epb77WWbnJKxMKuweRcar59A5Aqkeqn7rk' \
--data '{
    "clabe": "012555555555555555",
    "bank_name": "BBVA México",
    "customer_rfc": "PERJ950714DL2",
    "bank_code": "012",
    "alias": "Juan Perez"
}'

Response

{
    "account_id": "68a4c3150b28a9584305a2a6",
    "customer_id": "6944a4946afaf625504595e3",
    "clabe": "012555555555555555",
    "customer_rfc": "PERJ950714DL2",
    "bank_name": "BBVA México",
    "bank_code": "012",
    "alias": "Juan Perez",
    "is_active": false,
    "id": "6944a5366afaf625504595ea",
    "created_at": "2025-12-19T01:07:02.088Z",
    "updated_at": "2025-12-19T01:07:02.088Z"
}

Retrieve Customer CLABE

Fetch the full details of a previously registered CLABE.

Endpoint

GET https://ecartpay.com/api/customers/{customerId}/clabes
GET https://sandbox.ecartpay.com/api/customers/{customerId}/clabes

Headers

Authorization: token

Path Parameters

customerId: The id associated to the customer.

Response Key Features

is_active : Indicates if the CLABE has been verified and is ready for Direct Debit transactions.
bank_code : The standard 3-digit code representing the Mexican bank. See the Bank Codes Catalog below for further details.

Examples

Request

curl --location 'https://sandbox.ecartpay.com/api/customers/6944a4946afaf625504595e3/clabes' \
--header 'authorization: eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY4YTRjMzE1MGIyOGE5NTg0MzA1YTJhYSIsImFjY291bnRfaWQiOiI2OGE0YzMxNTBiMjhhOTU4NDMwNWEyYTYiLCJhY2NvdW50Ijp7ImVtYWlsIjoiaHVnby5tb3JpbkBlY2FydHBheS5jb20iLCJmaXJzdF9uYW1lIjoiSHVnbyIsImxhc3RfbmFtZSI6Ik1vcsOtbiIsInBob25lIjoiNTI......' \
--header 'Cookie: __cf_bm=C4zOk2opFVctJ3DYgyiBFGCygevp10BAc873Md.abfU-1766105279-1.0.1.1-E8D6c1bihRoOPUsgJq9LuaOEoJHeCwNnMo6wRiGDdlOXPPZFyyeQQTWQcdptbrgniXSYr8Dz9epb77WWbnJKxMKuweRcar59A5Aqkeqn7rk'

Response

{
    "count": 1,
    "docs": [
        {
            "clabe": "012555555555555555",
            "customer_rfc": "PERJ950714DL2",
            "bank_name": "BBVA México",
            "bank_code": "012",
            "alias": "Juan Perez",
            "is_active": false,
            "id": "6944a5366afaf625504595ea",
            "account_id": "68a4c3150b28a9584305a2a6",
            "customer_id": "6944a4946afaf625504595e3"
        }
    ],
    "pages": 1
}

Bank Codes Catalog (Mexico)

When registering a CLABE or activating a Direct Debit, you must use the 3-digit code corresponding to the specific banking institution. Below is a list of the supported banks in Mexico:

Code	Banking Institution	Short Name
002	Banco Nacional de México, S.A.	Banamex
012	BBVA México, S.A.	BBVA México
014	Banco Santander México, S.A.	Santander
019	Banco Nacional del Ejército, Fuerza Aérea y Armada	Banjercito
021	HSBC (México), S.A.	HSBC
030	Banco del Bajío, S.A.	BanBajío
036	Banco Inbursa, S.A.	Inbursa
042	Banca Mifel, S.A.	Mifel
044	Scotiabank Inverlat, S.A	Scotiabank
058	Banco Regional de Monterrey, S.A	Banregio
059	Banco Invex, S.A.	Invex
062	Banca Afirme, S.A.	Afirme
072	Banco Mercantil del Norte, S.A.	Banorte
106	Bank of America (México), S.A.	Bank of America
113	Banco Ve por Más, S.A.	Ve por Más
127	Banco Azteca S.A.	Azteca
130	Compartamos Banco, S.A.	Compartamos
132	Banco Multiva, S.A.	Multiva
133	Banco Actinver, S.A.	Actinver
136	Interbanco, S.A.	Interbanco
137	Bancoppel, S.A.	Bancoppel
145	Banco BASE, S.A.	BASE
147	Bankaool, S.A.	Bankaool
151	Fundación Dondé, S.A.	Dondé
152	Banco BANCREA, S.A.	BANCREA
156	Banco Sabadell S.A.	Sabadell

Bank not found? If you need to process a CLABE from an institution that does not appear in this list, please contact our technical support team to verify the code's compatibility.