Mexico deposits (MXN)

Available deposit methods in Mexico to fund Mexican pesos. Endpoints to receive Mexican peso deposits via SPEI/CLABE.

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

General flow

Create CLABE account

Generate a CLABE account to receive SPEI deposits with POST /clabe/mxn.

Receive deposit

The user sends a SPEI transfer to the assigned CLABE.

Verify deposit

List received deposits with GET /fundings/mxn.

CLABE Accounts

List CLABE accounts

Gets the user’s registered CLABE accounts for receiving SPEI deposits.

List CLABE Accounts

Authorizations

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

Endpoint

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

Required Headers

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

cURL Example

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

Response

response.json

{
"code_transaction": "OK",
"data": [
  {
    "clabe": "646180157000000001",
    "status": "active",
    "clabe_type": 
  "spei"}
]
}

Create CLABE account

Creates a new CLABE account linked to the user for receiving SPEI deposits.

Create CLABE Account

Authorizations

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

Endpoint

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

Required Headers

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

cURL Example

curl -X POST "https://dev.backend.colurs.co/clabe/mxn" \
-H "Authorization: Bearer [ACCESS_TOKEN]" \
-H "x-api-key: [API_KEY]" \
-H "Content-Type: application/json"

Response

response.json

{
"code_transaction": "OK",
"clabe": "646180157000000002",
"status": 
"active"}

Possible Errors

Code	Error	Description
400	BadRequest	Could not create CLABE
409	Conflict	User already has an active CLABE

💡

Generated CLABE is permanent. Share it with the sender to make SPEI transfers to your account.

Funding Details

Gets deposit instructions for a specific currency and network. Useful to show users how to fund their account.

Deposit Instructions

Authorizations

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

Endpoint

GEThttps://dev.backend.colurs.co/funding-details/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 code (e.g. 'mxn', 'btc', 'usdt')
protocol	string	✕	Protocol (e.g. 'clabe', 'trc20', 'erc20')
asset	string	✕	Asset code (e.g. 'usdt', 'btc')
network	string	✕	Network (e.g. 'spei', 'tron', 'eth')
integration	string	✕	Integration identifier

request.json?currency=mxn&network=spei&protocol=clabe

cURL Example

curl -X GET "https://dev.backend.colurs.co/funding-details/mxn?currency=mxn&network=spei&protocol=clabe" \
-H "Authorization: Bearer [ACCESS_TOKEN]" \
-H "x-api-key: [API_KEY]"

Response

response.json

{
"code_transaction": "OK",
"data": {
  "currency": "mxn",
  "network": "spei",
  "protocol": "clabe",
  "deposit_address": "646180157000000001",
  "instructions": 
"Send a SPEI transfer to the indicated CLABE"}
}

Funding Methods

Lists available funding methods for MXN.

Available Funding Methods

Authorizations

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

Endpoint

GEThttps://dev.backend.colurs.co/funding-methods/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 code (default: 'mxn')

request.json?currency=mxn

cURL Example

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

Response

response.json

{
"code_transaction": "OK",
"data": [
  {
    "method": "spei",
    "currency": "mxn",
    "protocol": "clabe",
    "min_amount": "100.00",
    "max_amount": 
  "500000.00"}
]
}

List Deposits

Lists deposits received in the MXN account, with pagination and filters.

List MXN Deposits

Authorizations

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

Endpoint

GEThttps://dev.backend.colurs.co/fundings/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	✕	Filter by currency (e.g. 'mxn', 'btc', 'usdt')
status	string	✕	Filter by status (e.g. 'pending', 'complete')
limit	integer	✕	Results per page (default: 25, max: 100)
offset	integer	✕	Pagination offset

request.json?currency=mxn&status=complete&limit=10&offset=0

cURL Example

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

Response

response.json

{
"code_transaction": "OK",
"data": [
  {
    "fid": "f123abc",
    "currency": "mxn",
    "amount": "25000.00",
    "status": "complete",
    "method": "spei",
    "created_at": 
  "2026-01-15T10:30:00Z"}
]
}

Test Deposit (Staging)

🚫

This endpoint only works in staging. It is not available in production.

Creates a simulated deposit for integration tests.

Test Deposit (Mock)

Authorizations

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

Endpoint

POSThttps://dev.backend.colurs.co/mock-deposit/mxn

Required Headers

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

Request Body

Field	Type	Required	Description
clabe	string	✓	Target CLABE account number
amount	string	✓	Amount to deposit (e.g. '1000.00')
reference	string	✕	Optional deposit reference

request.json{
"clabe": "646180157000000001",
"amount": "5000.00",
"reference": "TEST_DEPOSIT_001"
}

cURL Example

curl -X POST "https://dev.backend.colurs.co/mock-deposit/mxn" \
-H "Authorization: Bearer [ACCESS_TOKEN]" \
-H "x-api-key: [API_KEY]" \
-H "Content-Type: application/json" \
-d '{"clabe":"646180157000000001","amount":"5000.00","reference":"TEST_001"}'

Response

response.json

{
"code_transaction": "OK",
"message": "Mock deposit created successfully",
"data": {
  "deposit_id": "dep_mock_abc123",
  "clabe": "646180157000000001",
  "amount": "5000.00",
  "status": 
"complete"}
}

Common Response Fields

Field	Type	Description
`code_transaction`	string	Operation status code
`data`	object/array	Response data
`message`	string	Descriptive message (errors or confirmations)

Important notes

⚠️

Limits: Deposit amounts are subject to account daily and monthly limits.

💡

SPEI: SPEI transfers are processed during Mexican banking hours (Monday to Friday, 6:00 to 17:30 CT). Outside that window, deposits are credited on the next business day.

Colombia top-ups USD Wallet