Depósitos México (MXN)

Métodos de depósito disponibles en México para fondear en pesos mexicanos. Endpoints para recibir depósitos en pesos mexicanos vía SPEI/CLABE.

Todos los endpoints requieren autenticación con Authorization: Bearer [TOKEN] y x-api-key.

Flujo General

Crear cuenta CLABE

Genera una cuenta CLABE para recibir depósitos SPEI con POST /clabe/mxn.

Recibir depósito

El usuario realiza una transferencia SPEI a la CLABE asignada.

Verificar depósito

Lista los depósitos recibidos con GET /fundings/mxn.

Cuentas CLABE

Listar cuentas CLABE

Obtiene las cuentas CLABE registradas del usuario para recibir depósitos SPEI.

Listar Cuentas CLABE

Autorización

Se requieren el header x-api-key y Authorization: Bearer <token>.

Endpoint

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

Headers Requeridos

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

Ejemplo cURL

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

Respuesta

response.json

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

Crear cuenta CLABE

Crea una nueva cuenta CLABE asociada al usuario para recibir depósitos vía SPEI.

Crear Cuenta CLABE

Autorización

Se requieren el header x-api-key y Authorization: Bearer <token>.

Endpoint

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

Headers Requeridos

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

Ejemplo cURL

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"

Respuesta

response.json

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

Errores Posibles

Código	Error	Descripción
400	BadRequest	No se pudo crear la CLABE
409	Conflict	El usuario ya tiene una CLABE activa

💡

La CLABE generada es permanente. Compártela con el remitente para que realice transferencias SPEI a tu cuenta.

Detalles de Fondeo

Obtiene las instrucciones de depósito para una moneda y red específica. Útil para mostrar al usuario cómo fondear su cuenta.

Instrucciones de Depósito

Autorización

Se requieren el header x-api-key y Authorization: Bearer <token>.

Endpoint

GEThttps://dev.backend.colurs.co/funding-details/mxn

Headers Requeridos

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

Request Body

Campo	Tipo	Requerido	Descripción
currency	string	✓	Código de moneda (ej. 'mxn', 'btc', 'usdt')
protocol	string	✕	Protocolo (ej. 'clabe', 'trc20', 'erc20')
asset	string	✕	Código de activo (ej. 'usdt', 'btc')
network	string	✕	Red (ej. 'spei', 'tron', 'eth')
integration	string	✕	Proveedor de integración (ej. 'fblocks-v1')

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

Ejemplo cURL

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]"

Respuesta

response.json

{
"code_transaction": "OK",
"data": {
  "currency": "mxn",
  "network": "spei",
  "protocol": "clabe",
  "deposit_address": "646180157000000001",
  "instructions": 
"Realiza una transferencia SPEI a la CLABE indicada"}
}

Métodos de Fondeo

Lista los métodos de fondeo disponibles para MXN.

Métodos de Fondeo Disponibles

Autorización

Se requieren el header x-api-key y Authorization: Bearer <token>.

Endpoint

GEThttps://dev.backend.colurs.co/funding-methods/mxn

Headers Requeridos

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

Request Body

Campo	Tipo	Requerido	Descripción
currency	string	✕	Código de moneda (default: 'mxn')

request.json?currency=mxn

Ejemplo cURL

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

Respuesta

response.json

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

Listar Depósitos

Lista los depósitos recibidos en la cuenta MXN, con paginación y filtros.

Listar Depósitos MXN

Autorización

Se requieren el header x-api-key y Authorization: Bearer <token>.

Endpoint

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

Headers Requeridos

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

Request Body

Campo	Tipo	Requerido	Descripción
currency	string	✕	Filtrar por moneda (ej. 'mxn', 'btc', 'usdt')
status	string	✕	Filtrar por estado (ej. 'pending', 'complete')
limit	integer	✕	Resultados por página (default: 25, max: 100)
offset	integer	✕	Offset de paginación

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

Ejemplo cURL

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]"

Respuesta

response.json

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

Depósito de Prueba (Staging)

🚫

Este endpoint solo funciona en el entorno de staging. No está disponible en producción.

Crea un depósito simulado para pruebas de integración.

Depósito de Prueba (Mock)

Autorización

Se requieren el header x-api-key y Authorization: Bearer <token>.

Endpoint

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

Headers Requeridos

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

Request Body

Campo	Tipo	Requerido	Descripción
clabe	string	✓	Número de cuenta CLABE destino
amount	string	✓	Monto a depositar (ej. '1000.00')
reference	string	✕	Referencia opcional del depósito

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

Ejemplo cURL

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"}'

Respuesta

response.json

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

Campos de Respuesta Comunes

Campo	Tipo	Descripción
`code_transaction`	string	Código de estado de la operación
`data`	object/array	Datos de respuesta
`message`	string	Mensaje descriptivo (en errores o confirmaciones)

Notas Importantes

⚠️

Límites: Los montos de depósito están sujetos a los límites diarios y mensuales de la cuenta.

💡

SPEI: Las transferencias SPEI se procesan en horario bancario mexicano (lunes a viernes, 6:00 a 17:30 CT). Fuera de horario, los depósitos se acreditan al siguiente día hábil.

Recargas Colombia Wallet USD