Inicio

API de Pago Móvil

La API de Pago Móvil de pagolink te deja cobrar con Pago Móvil desde tu propio sistema: tu servidor crea el cobro con POST /v1/checkout/sessions, el checkout le muestra al cliente los datos de pago y le pide la referencia, pagolink la comprueba con el banco y tu servidor recibe el webhook payment.completed. No conectas tu sistema a cada banco.

Cómo funciona la verificación

¿No vas a programar? Mira cómo verificar un Pago Móvil sin revisar el banco desde la consola.

  1. Creas el cobro por API con el monto, o compartes un link de pago.
  2. El checkout muestra los datos de cobro de tu cuenta y el monto exacto en bolívares.
  3. Tu cliente paga desde la app de su banco, sea cual sea, y escribe la referencia.
  4. pagolink comprueba la referencia con el banco. Si el pago entró, el cobro pasa a Pagado sin que lo revises.
  5. Tu sistema recibe el evento payment.completed y entrega el pedido.

Ejemplo

El cobro se crea igual para todos los métodos. Tu cliente elige Pago Móvil en el checkout.

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": "…" }

Cuando el pago se confirma, llega el webhook:

{
  "id": "evt_9f2c…",
  "type": "payment.completed",
  "livemode": true,
  "data": { … }
}

Si el pago no se puede confirmar

Si la comprobación no encuentra el pago, el cobro queda por confirmar en la consola y tu sistema recibe payment.pending_review. No cierres el pedido hasta recibir payment.completed.

Mientras el banco no ha activado tu cuenta, los pagos móviles también se cobran, pero los confirmas tú desde la consola.

Precio en dólares, pago en bolívares

Si creas el cobro en USD, el checkout le muestra a tu cliente el monto en bolívares a la tasa BCV del día. Tu cliente paga en bolívares y tú ves el cobro con las dos cifras.

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

¿Tengo que conectar mi sistema con cada banco?

No. Tu sistema habla solo con la API de pagolink. Tus clientes pagan desde su propio banco, sea cual sea, y pagolink comprueba el pago contra la cuenta de tu empresa.

¿Funciona si mi cliente es de otro banco?

Sí. Tu cliente paga desde su propio banco, sea cual sea, con la app que ya usa.

¿Cuánto tarda en confirmarse un Pago Móvil?

Por lo general menos de un minuto. Débito Inmediato y C2P se confirman en segundos y la transferencia en unos minutos.

¿Qué pasa si el pago no aparece?

El cobro queda por confirmar en la consola y recibes el evento payment.pending_review. Lo revisas y lo resuelves desde ahí.

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