Mexico Recipients (MXN)

All endpoints require authentication with Authorization: Bearer [TOKEN] and x-api-key.

Flow

Check bank codes

Get the list of banks with GET /bank-codes/mxn to use the code when creating recipients.

Create recipient

List or delete

Check your recipients with GET /recipients/mxn or delete one with DELETE /recipients/mxn.

Bank Codes

Gets available bank codes in Mexico. Required to register recipient accounts.

MXN Bank Codes

Authorizations

Both x-api-key and Authorization: Bearer <token> headers are required.

Endpoint

GEThttps://dev.backend.colurs.co/bank-codes/mxn

Required Headers

Content-Type: application/jsonAccept: application/jsonx-api-key: [API_KEY]Authorization: Bearer [ACCESS_TOKEN]

Request Body

Field	Type	Required	Description
country	string	✓	Country code (e.g. 'mx')

request.json?country=mx

cURL Example

curl -X GET "https://dev.backend.colurs.co/bank-codes/mxn?country=mx" \
-H "Authorization: Bearer [ACCESS_TOKEN]" \
-H "x-api-key: [API_KEY]"

Response

response.json

{
"code_transaction": "OK",
"data": [
  { "code": "40012", "name":  "BBVA México"},
  { "code": "40014", "name":  "Santander México"},
  { "code": "40021", "name":  "HSBC México"},
  { "code": "40072", "name":  "Banorte"}
]
}

💡

Use the bank `code` field as `bank_code` when creating a recipient.

Recipients

List recipients

Gets the user’s registered recipient accounts.

List Recipients

Authorizations

Both x-api-key and Authorization: Bearer <token> headers are required.

Endpoint

GEThttps://dev.backend.colurs.co/recipients/mxn

Required Headers

Content-Type: application/jsonAccept: application/jsonx-api-key: [API_KEY]Authorization: Bearer [ACCESS_TOKEN]

Request Body

Field	Type	Required	Description
currency	string	✕	Currency (default: 'mxn')
network	string	✕	Network (e.g. 'spei')
protocol	string	✕	Protocol (e.g. 'clabe')
source	string	✕	'db' (default) for local database, 'api' to sync with service

request.json?currency=mxn&network=spei

cURL Example

curl -X GET "https://dev.backend.colurs.co/recipients/mxn?currency=mxn" \
-H "Authorization: Bearer [ACCESS_TOKEN]" \
-H "x-api-key: [API_KEY]"

Response

response.json

{
"code_transaction": "OK",
"data": [
  {
    "recipient_id": "rec_abc123",
    "beneficiary_name": "María López",
    "account_number": "646180157000000099",
    "bank_code": 
  "40012"}
]
}

Create recipient

Registers a new bank account as recipient for MXN withdrawals.

Create Recipient

Authorizations

Both x-api-key and Authorization: Bearer <token> headers are required.

Endpoint

POSThttps://dev.backend.colurs.co/recipients/mxn

Required Headers

Content-Type: application/jsonAccept: application/jsonx-api-key: [API_KEY]Authorization: Bearer [ACCESS_TOKEN]

Request Body

Field	Type	Required	Description
beneficiary_name	string	✓	Beneficiary full name
account_number	string	✓	CLABE account number (18 digits)
bank_code	string	✓	Bank code (from /bank-codes/mxn)
currency	string	✓	Currency (e.g. 'mxn')
network	string	✕	Network (e.g. 'spei')
protocol	string	✕	Protocol (e.g. 'clabe')

request.json{
"beneficiary_name": "María López",
"account_number": "646180157000000099",
"bank_code": "40012",
"currency": "mxn",
"network": "spei",
"protocol": "clabe"
}

cURL Example

curl -X POST "https://dev.backend.colurs.co/recipients/mxn" \
-H "Authorization: Bearer [ACCESS_TOKEN]" \
-H "x-api-key: [API_KEY]" \
-H "Content-Type: application/json" \
-d '{"beneficiary_name":"María López","account_number":"646180157000000099","bank_code":"40012","currency":"mxn"}'

Response

response.json

{
"code_transaction": "OK",
"recipient_id": 
"rec_xyz789"}

Possible Errors

Code	Error	Description
400	BadRequest	Invalid account data or incorrect CLABE
409	Conflict	Recipient is already registered

💾

Save `recipient_id` to use it when creating SPEI withdrawals in **Mexico withdrawals (MXN)**.

Delete recipient

Deletes a registered recipient account.

Delete Recipient

Authorizations

Both x-api-key and Authorization: Bearer <token> headers are required.

Endpoint

DELETEhttps://dev.backend.colurs.co/recipients/mxn

Required Headers

Content-Type: application/jsonAccept: application/jsonx-api-key: [API_KEY]Authorization: Bearer [ACCESS_TOKEN]

Request Body

Field	Type	Required	Description
recipient_id	string	✓	Recipient ID to delete

request.json?recipient_id=rec_abc123

cURL Example

curl -X DELETE "https://dev.backend.colurs.co/recipients/mxn?recipient_id=rec_abc123" \
-H "Authorization: Bearer [ACCESS_TOKEN]" \
-H "x-api-key: [API_KEY]"

Response

response.json

{
"code_transaction": "OK",
"message": 
"Recipient deleted successfully"}

Possible Errors

Code	Error	Description
400	BadRequest	recipient_id not provided
404	NotFound	Recipient not found

📄

To execute a withdrawal to a previously registered recipient, see Mexico withdrawals (MXN) in the Payments section.

US bank accounts Reference index