Débito inmediato por API
El débito inmediato cobra desde la cuenta de tu cliente en el momento: el cliente da sus datos en el checkout, recibe de su banco una clave de 8 dígitos por SMS, la escribe y el banco aprueba el cargo en segundos. Con pagolink lo ofreces por API junto con los demás métodos y recibes un webhook cuando el pago entra.
Cómo funciona
- Creas el cobro desde tu servidor, igual que con cualquier método.
- Tu cliente elige Débito Inmediato en el checkout y escribe sus datos.
- Su banco le envía una clave de 8 dígitos por SMS. El cliente la escribe en el checkout.
- El banco aprueba el cargo en segundos y el dinero entra a tu cuenta.
- Tu sistema recibe
payment.completedy entrega el pedido.
curl https://api.pagolink.co/v1/checkout/sessions \
-H "x-api-key: sk_test_…" \
-H "Content-Type: application/json" \
-d '{ "amount": "25.00", "currency": "USD" }'
→ 201 { "sessionId": "txn_…", "checkoutUrl": "…", "expiresAt": "…" }
Débito inmediato o domiciliación
El débito inmediato es para un pago único: el cliente lo autoriza en ese momento con la clave del SMS. Para cobrar cada mes sin pedirle el pago de nuevo se usa la domiciliación: el cliente autoriza una sola vez y los cargos salen solos. Ver domiciliación y cobros recurrentes.
Si el débito no pasa
Si el banco rechaza el débito, el checkout le ofrece al cliente pagar el mismo monto con otro método, como Pago Móvil o C2P. Tu sistema recibe payment.failed por el primer intento y payment.completed por el pago que entró.
Qué necesitas
El débito inmediato lo ejecuta el banco de tu cuenta, así que se ofrece cuando el banco activa tu cuenta de cobro. Nosotros gestionamos esa solicitud.
Con una clave de prueba (sk_test_…) no se toca el banco ni se mueve dinero. La referencia o la clave 1111 simula un rechazo, 2222 deja el cobro por confirmar y cualquier otra lo aprueba.
Preguntas frecuentes
¿Qué es el débito inmediato?
Un cobro que sale de la cuenta del cliente en el momento, autorizado con una clave que su banco le envía por SMS. El dinero entra a tu cuenta en segundos.
¿Sirve para cobros recurrentes?
No. Cada débito inmediato lo autoriza el cliente con una clave nueva. Para cobrar cada período sin pedirle el pago se usa la domiciliación.
¿Cuánto tarda en confirmarse?
Débito Inmediato y C2P, segundos. Pago Móvil, menos de un minuto. Transferencia, unos minutos.
¿Mi cliente tiene que ser de mi banco?
No. Tus clientes pagan desde su propio banco, sea cual sea.
Otras guías
Empieza a cobrar hoy.
Crea tu cuenta y nosotros gestionamos la conexión con tu banco. Para integrar, la documentación tiene cada ruta de la API.