Asigna una CLABE por usuario

POST /api/v1/clabe-assignments da a cada uno de tus usuarios finales su propia CLABE SPEI. Cualquier transferencia SPEI que tu usuario envíe a esa CLABE se acredita a tu cuenta de comercio.

Llámalo una vez por usuario — por ejemplo cuando se registra, o la primera vez que abre tu pantalla de depósitos. La llamada es idempotente por usuario: volver a llamarla con el mismo user_id devuelve la misma CLABE en vez de crear una nueva. Cada user_id corresponde a exactamente una CLABE dentro de tu cuenta de comercio, y dos valores distintos de user_id siempre reciben dos CLABEs distintas.

URL base

Usa el dominio del API de Tonder de tu entorno y agrega /deposits antes de la ruta del endpoint.

Autenticación

Envía tu llave API de Tonder en el header Authorization, con el prefijo Token y un espacio:

Authorization: Token <tu-llave-api>

Usa la misma llave API que usas para el resto del API de Tonder. Tonder identifica tu cuenta de comercio a partir de la llave, así que la petición no lleva id de comercio. Una llave faltante o inválida se rechaza antes de que la petición llegue al endpoint.

Paso a paso

curl -X POST https://api-stage.tonder.io/deposits/api/v1/clabe-assignments \
  -H "Authorization: Token $TONDER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"user_id": "customer-48213"}'

curl -X POST https://api.tonder.io/deposits/api/v1/clabe-assignments \
  -H "Authorization: Token $TONDER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"user_id": "customer-48213"}'

const res = await fetch(
  "https://api.tonder.io/deposits/api/v1/clabe-assignments",
  {
    method: "POST",
    headers: {
      Authorization: `Token ${process.env.TONDER_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ user_id: "customer-48213" }),
  }
);

if (!res.ok) throw new Error(`CLABE assignment failed: ${res.status}`);
const { clabe, is_new } = await res.json();

import os, requests

res = requests.post(
    "https://api.tonder.io/deposits/api/v1/clabe-assignments",
    headers={"Authorization": f"Token {os.environ['TONDER_API_KEY']}"},
    json={"user_id": "customer-48213"},
    timeout=30,
)
res.raise_for_status()
clabe = res.json()["clabe"]

{
  "assignment_id": "9b2f6c1e-4d3a-4f7b-8a51-2c6e0d9f7a14",
  "clabe": "710969000012345678",
  "merchant_id": "1234",
  "user_id": "customer-48213",
  "provider_type": "Tonder",
  "assigned_at": "2026-10-13T18:22:05.123456+00:00",
  "is_new": true
}

Errores

Los errores del endpoint devuelven un cuerpo JSON con error y message. Los dos errores de autenticación vienen del gateway y solo incluyen message.

{
  "error": "INVALID_PARAMETER",
  "message": "user_id is required"
}

Referencia de la API

curl -X POST "https://example.com/api/v1/clabe-assignments" \  -H "Content-Type: application/json" \  -d '{    "user_id": "customer-48213"  }'

{
  "assignment_id": "9b2f6c1e-4d3a-4f7b-8a51-2c6e0d9f7a14",
  "clabe": "710969000012345678",
  "merchant_id": "1234",
  "user_id": "customer-48213",
  "provider_type": "Tonder",
  "assigned_at": "2026-10-13T18:22:05.123456+00:00",
  "is_new": false
}

{
  "assignment_id": "9b2f6c1e-4d3a-4f7b-8a51-2c6e0d9f7a14",
  "clabe": "710969000012345678",
  "merchant_id": "1234",
  "user_id": "customer-48213",
  "provider_type": "Tonder",
  "assigned_at": "2026-10-13T18:22:05.123456+00:00",
  "is_new": true
}

{
  "error": "INVALID_PARAMETER",
  "message": "user_id is required"
}

{
  "message": "Unauthorized"
}

{
  "message": "User is not authorized to access this resource"
}

{
  "error": "INTERNAL_ERROR",
  "message": "Unexpected error"
}

Siguientes pasos