Inicio

Cobro C2P por API

En un cobro C2P (comercio a persona) es el comercio quien cobra: tu cliente da su banco, su teléfono y la clave C2P que le da su banco, y el cargo sale de su cuenta. Con pagolink creas el cobro por API, el checkout pide esos datos y el banco responde en segundos. Tu servidor recibe un webhook con el resultado.

C2P o Pago Móvil

En el Pago Móvil el cliente envía el dinero y después da la referencia. En el C2P el cliente no envía nada: autoriza el cargo con su clave y el comercio cobra. No hay que esperar a que el cliente haga el pago ni comprobar referencias, por eso se confirma en segundos.

Con pagolink ofreces los dos en el mismo checkout. Ver API de Pago Móvil.

Paso a paso

  1. Crea el cobro desde tu servidor con POST /v1/checkout/sessions.
  2. Tu cliente elige C2P en el checkout y escribe su banco, su teléfono y su clave C2P.
  3. pagolink envía el cobro al banco de tu cuenta, que responde en segundos.
  4. Recibes el resultado por webhook: payment.completed si se aprobó, payment.failed si no.
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": "…" }

Si el banco rechaza el C2P

Si el banco rechaza el cobro, por ejemplo porque el cliente no tiene el servicio C2P activo, el checkout le ofrece pagar el mismo monto con otro método. Para tu sistema son dos cobros: el rechazado y el nuevo.

Qué necesitas

C2P lo ejecuta el banco de tu cuenta, así que se ofrece cuando el banco activa tu cuenta de cobro. Nosotros gestionamos esa solicitud. Antes de eso puedes cobrar con Pago Móvil y transferencia.

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é datos pide un cobro C2P?

El banco del cliente, su número de teléfono y la clave C2P que le da su banco. El checkout de pagolink los pide; tú no los manejas.

¿Cuánto tarda en confirmarse un C2P?

Segundos. El banco aprueba o rechaza el cargo en el momento.

¿Qué pasa si mi cliente no tiene C2P activo?

El banco rechaza el cobro y el checkout le ofrece pagar el mismo monto con otro método, como Pago Móvil o Débito Inmediato.

¿Necesito un contrato con el banco para cobrar con C2P?

Necesitas tu cuenta de cobro activa en el banco. Nosotros gestionamos la solicitud y, cuando el banco la activa, C2P queda disponible.

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.

Solicita tu cuentaLeer la documentación