Product Overview
Quickly identify the fundings made into your account with the Multi-CLABE API.
CLABE Standard
The Clave Bancaria Estandarizada (CLABE) standard uniquely identifies an account in Mexico's financial system, and it is required for sending and receiving inter-bank fund transfers. This way, financial institutions and Mexico's Central Bank (Banxico) can process payments safely and guarantee that inter-bank fund transfers and automatic service charges are made to the proper accounts.
A CLABE contains 18 digits that identify the institution holding the account and the bank account number itself:
- 3 Digits: Bank Code
- 3 Digits: Branch Office Code
- 11 Digits: Account Number
- 1 Digit: Control Digit
Multi-CLABE API
The Multi-CLABE feature of Bitso's business accounts enables you to create —via API calls— multiple CLABEs linked to your account, which you can assign to your users at your convenience and implement tailor-made disbursement flows. However, a user can have one and only one CLABE assigned to them, not more.
The users of your created CLABEs can only transfer funds (deposit) into them, and the service credits these funds to your account balance. Withdrawals are not possible through these CLABEs. When you create your Bitso business account or enable International Payments in Mexican pesos (MXN), the system assigns a CLABE to your account by default (Main or International CLABE, respectively), and when you request an MXN withdrawal, the Withdrawal Service uses this default CLABE to withdraw the funds.
Because of security matters or lack of payment for the service, Bitso operators can block created CLABEs. The service returns any funds sent to a blocked CLABE to the sender's account.
The Multi-CLABE API includes a set of RESTful endpoints that enable you to create CLABEs on demand and then query the operations made using those CLABEs. The functionality includes:
- Create CLABEs: Set up as many CLABEs as you need in your account and assign them on a one-to-one relationship to users.
- Retrieve a specific CLABE: Get comprehensive details of one of your CLABEs.
- Set minimum and maximum deposit limits: Configure minimum and maximum deposit amounts that determine the lowest and highest values a user can deposit into a CLABE for the service to accept the transaction. You can set maximum limits per transaction and period.
- Turn unblocked CLABEs on or off: Switch a created CLABE to an inactive state (cannot receive deposits) or vice versa. You can update the state of unblocked CLABEs and access this endpoint only if the Multi-CLABE feature is active in your account.
- List your CLABEs: Retrieve a paginated set of CLABEs that comply with your query parameters.
- List your CLABEs' deposits: Retrieve a paginated, filtered list of the fundings made into the CLABEs linked to your account.
- Receive One-Time Payments: Request a CLABE for a one-time SPEI® payment and provide a unique, client-supplied payment ID for the transaction, streamlining your reconciliation of incoming payments.
- List your One-Time Payments: Retrieve a paginated payment list that matches your query parameters.
- List rejected transactions: Retrieve a paginated, filtered list of rejected deposits and one-time payments that rapidly lets you know why the service rejected the transaction.
- Create mock deposits: Simulate deposits and refund deposits in MXN into your Bitso testing account.
- Receive webhook notifications: Get real-time status data about deposit events in your account.
Benefit for Users
Because CLABEs can be assigned only on a per-user basis and NOT per transaction, multiple CLABEs associated with your account enable you to quickly identify the fundings (deposits) made by different users and create adequate disbursement flows for them. The CLABE acts as an identification tag for the funds received in your account from a specific user.
The service does not provide a segregated balance by CLABE. However, it provides an endpoint that helps you list the deposits made into a specific CLABE.
Potential Users
Mexican and non-Mexican institutional customers can hire the Multi-CLABE feature in their accounts. However, non-Mexican institutional customers must first enable International Payments in MXN to make the Mexican peso currency available in their account.
Service Cost
The feature requires service and infrastructure, which incur costs per transaction. As a result, Bitso applies charges for using this feature; deposits into created CLABES and withdrawals are subject to applicable fees. Contact your account manager for the most accurate and up-to-date information regarding the specific charges associated with this service.
Updated 28 days ago
