Cómo cobrar por API en Venezuela

Para cobrar por API en Venezuela, tu servidor crea una sesión de cobro en la API de pagolink con el monto y la moneda. Tu cliente paga en el checkout con Pago Móvil, C2P, Débito Inmediato, transferencia o Binance Pay, y un webhook firmado le avisa a tu sistema cuando el banco confirma el pago. El dinero llega directo a la cuenta de tu empresa.

Qué necesitas

Una cuenta en un banco venezolano a nombre de tu empresa. Como persona natural puedes empezar con tu cédula en Banco Nacional de Crédito y recibir pagos móviles y transferencias verificadas.
Una cuenta de pagolink. Nosotros gestionamos la conexión con tu banco.
Una clave secreta de prueba (sk_test_…) para desarrollar sin mover dinero. La creas en la sección Desarrolladores de la consola.

Paso a paso

Crea la sesión desde tu servidor. Envía el monto y la moneda a POST /v1/checkout/sessions con tu clave secreta en la cabecera x-api-key. La clave secreta nunca va en el navegador ni en la app.
Abre el cobro. Lleva a tu cliente a checkoutUrl, o ábrelo en tu página con el SDK de pagolink: una ventana sobre tu página o un botón de pago listo para usar.
Tu cliente paga. Elige el método en el checkout: Pago Móvil, C2P, Débito Inmediato, transferencia o Binance Pay. No descarga nada ni se registra.
Confirma en tu servidor. El evento payment.completed llega a tu webhook cuando el pago entró. Ahí cierras el pedido o la factura.
Pasa a producción. Cambia la clave de prueba por la clave en vivo. El código no cambia.

Ejemplo: crear un cobro

La sesión dura 30 minutos por defecto. Con currency en USD, tu cliente paga en bolívares a la tasa BCV del día.

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

El sessionId identifica el cobro en tu sistema y en la consola.

La confirmación llega por webhook

El aviso del navegador sirve para mostrarle algo al cliente, pero lo que cuenta es el webhook: pagolink hace un POST firmado a la dirección que registres en la consola.

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

data trae el cobro completo, con tu metadata. Un reintento llega con el mismo id: guárdalo y descarta los repetidos para no cerrar dos veces el mismo pedido. Verifica la firma antes de confiar en el cuerpo.

Probar sin mover dinero

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.

Los webhooks de prueba llegan igual que los reales, con livemode: false. La API también acepta llaves de idempotencia y responde los errores con un código que tu sistema puede leer.

Preguntas frecuentes

¿Qué métodos de pago acepta la API?

Pago Móvil, C2P, Débito Inmediato, transferencia, Binance Pay en USDT y cobro manual para Zelle, Zinli o efectivo, que confirmas tú. Para cobros recurrentes, domiciliación. Todo con la misma integración.

¿El dinero pasa por pagolink?

No. El pago va de la cuenta de tu cliente a la cuenta de tu empresa. pagolink comprueba el pago con el banco y te avisa, pero no recibe ni guarda los fondos.

¿Sirve para mi app o mi plataforma web?

Sí. Creas el cobro por API y lo muestras en tu web con el botón de pago o el checkout. La misma API sirve para tu app de iOS o Android.

¿Cuánto tarda en confirmarse un pago?

Débito Inmediato y C2P, segundos. Pago Móvil, menos de un minuto. Transferencia, unos minutos.

¿Puedo probar antes de cobrar de verdad?

Sí. Con una clave de prueba los cobros, enlaces y suscripciones nacen en el entorno de prueba, no se toca el banco y no hay comisión.

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 cuenta Leer la documentación