Resumen y cuándo usarlo
Combina SDK o Hosted para tarjetas con API Direct para APMs y retiros, sin alcance PCI.
El modelo Híbrido combina la simplicidad del SDK/Hosted para pagos con tarjeta con el poder y la flexibilidad de API Direct para los demás métodos y los retiros —sin requerir certificación PCI. Es el enfoque recomendado para comercios que necesitan UI propia en algunos flujos y control programático en otros (iGaming, fintech, operaciones de alto volumen).
Cómo funciona
El modelo Híbrido divide tu procesamiento de forma estratégica:
- Para pagos con tarjeta: usa Hosted Checkout, Full SDK o Lite SDK. Tonder gestiona el cumplimiento PCI; no necesitas certificación.
- Para los demás métodos: usa API Direct (SPEI, OXXO Pay, MercadoPago, efectivo y cualquier método no-tarjeta).
- Para retiros: usa API Direct, con control programático total y sin requisitos PCI.
Combinaciones válidas
Elige una combinación según tus necesidades de UI para la tarjeta:
| Combinación | Tarjetas | Otros métodos | Retiros | Ideal para |
|---|---|---|---|---|
| Híbrido A | Hosted Checkout | API Direct | API Direct | Lanzamiento más rápido con máximo control en métodos no-tarjeta |
| Híbrido B | Full SDK | API Direct | API Direct | Experiencia de tarjeta embebida con UI estándar |
| Híbrido C | Lite SDK | API Direct | API Direct | Personalización total de la UI en todos los métodos |
Alcance PCI
| Modo de integración | Certificación PCI requerida |
|---|---|
| Hosted Checkout | Ninguna — Tonder aloja la captura de la tarjeta |
| SDK (Full o Lite) | Ninguna — los datos de tarjeta se tokenizan en el cliente |
| Híbrido | Ninguna — las tarjetas pasan por el leg de SDK/Hosted |
| API Direct (S2S) — flujo tokenizado | SAQ A o SAQ A-EP — la tarjeta se tokeniza antes de llegar a ti |
| API Direct (S2S) — datos en crudo | PCI DSS Nivel 1 — la tarjeta pasa por tus servidores |
Reembolsos en modo Híbrido
Los reembolsos de tarjeta pueden procesarse de dos formas:
- Dashboard (recomendado): procesa todos los reembolsos de tarjeta desde el dashboard de Tonder.
- API Direct: usa API Direct para los reembolsos de tarjeta.
Recomendamos elegir un solo método de reembolso y usarlo de forma consistente. Mezclar ambos complica tu integración.
Limitaciones importantes
- Los reembolsos solo están disponibles para pagos con tarjeta; SPEI, OXXO Pay y MercadoPago no pueden reembolsarse.
- Cada transacción solo puede reembolsarse una vez, y en su totalidad.
- Los reembolsos deben procesarse dentro de los 29 días posteriores a la confirmación del pago.
Cosas a considerar
- Patrones de integración duales. Implementarás dos estilos de integración a la vez, con formatos de petición/respuesta distintos para tarjetas vs. otros métodos.
- Manejo de webhooks dual. Recibirás webhooks estilo Hosted/SDK para tarjetas y estilo API Direct para todo lo demás. Consulta Webhooks duales.
- Mayor esfuerzo inicial de desarrollo que un enfoque puro de SDK/Hosted, al construir y mantener dos integraciones en paralelo.
El enfoque Híbrido es una solución puente. Hosted Checkout 2.0 y el nuevo Web SDK ya procesan los pagos a través de API Direct y envían los mismos webhooks, lo que unifica los patrones de petición/respuesta/webhook. Las implementaciones híbridas actuales siguen soportadas, con rutas de migración disponibles.
Siguientes pasos
Retiros en Chile (CLP)
Envía pesos chilenos a una cuenta corriente o cuenta vista por transferencia bancaria: la petición, el beneficiario chileno, montos en pesos enteros, errores de validación y estados.
Webhooks duales
Por qué una integración híbrida recibe dos formatos de webhook y cómo enrutarlos y deduplicarlos.