SPEI
Cobra por transferencia SPEI: genera la referencia, muéstrasela al cliente y espera la confirmación.
SPEI (Sistema de Pagos Electrónicos Interbancarios) es el sistema de transferencias bancarias en tiempo real de México, ideal para transacciones de mayor valor donde el cliente prefiere pagar desde su banco.
Cuándo usar SPEI
- Transacciones de mayor valor (pagos B2B).
- Clientes que prefieren transferencias bancarias sobre tarjetas.
- Transacciones que requieren procesamiento inmediato en horario hábil.
- Reducir comisiones de tarjeta en montos grandes.
Paso 1: crea la petición
SPEI no requiere datos adicionales del cliente más allá de los básicos. La API genera las instrucciones de pago.
{
"operation_type": "payment",
"amount": 500.00,
"currency": "MXN",
"customer": { "name": "Carlos Eduardo López", "email": "carlos.lopez@empresa.mx" },
"payment_method": { "type": "SPEI" },
"client_reference": "ORD-001"
}Paso 2: maneja la respuesta
Los pagos SPEI siempre empiezan en pending porque requieren que el cliente complete la
transferencia. La respuesta incluye la información de redirección con la CLABE:
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"operation_type": "payment",
"status": "pending",
"amount": 500.00,
"currency": "MXN",
"next_action": {
"redirect_to_url": {
"url": "https://stage-payflow.tonder.io/spei?clabe=710969000000629935&...",
"return_url": "https://tonder.io?tndr_payment_id=63772",
"verify_transaction_status_url": "/transactions/21cbe500-b320-4e0d-9186-9fb63c3d9617/"
}
}
}Muestra al cliente la CLABE y la referencia para que complete la transferencia. Confirma el resultado con un webhook o consultando el estado.
Los comercios nuevos de SPEI (MX) deberían usar Frictionless SPEI, que procesa automáticamente montos no coincidentes y transferencias directas.
Esta página cubre depósitos SPEI. SPEI también admite retiros (a cuenta bancaria o a tarjeta de débito) vía Retiros por API Direct.
Límites
SPEI tiene un mínimo de $1 MXN por transacción. Consulta la tabla completa en Límites.
Además, tu comercio puede configurar un monto mínimo personalizado para SPEI (por encima del mínimo por defecto). Solicítalo a tu gerente de integración de Tonder.
Si un cliente intenta pagar un monto menor al mínimo configurado, Tonder genera un reembolso automático por el monto recibido y la transacción no se completa.