Cómo integrar pagos en bolívares en tu app
Para integrar pagos en bolívares en tu app, usa la API de VEX Pay: obtén tus claves de prueba, crea un pago, confírmalo por webhook y pasa a producción. Son 7 pasos, desde la primera llamada de prueba hasta el primer cobro real.
Si estás construyendo una app, un sistema de facturación o una tienda a la medida, puedes aceptar pagos venezolanos con la API de VEX Pay. Este es el camino completo, desde la primera llamada de prueba hasta el primer cobro real.
Actualizado el
Por qué cobrar se vuelve complicado
Integrar pagos en Venezuela suele significar hablar con cada banco por separado, certificar pantallas de pago y armar a mano la confirmación de cada pago móvil.
Y aunque el pago funcione, falta lo que nadie documenta: qué hacer cuando un webhook no llega, cómo evitar cobros dobles y cuándo puedes retirar el dinero.
¿Cómo integrar pagos en bolívares en una app?
Hazlo en 7 pasos.
- 01
Obtén tus claves de prueba
Abre tu cuenta de negocio y crea una clave de prueba en el portal. En modo prueba los pagos son simulados.
- 02
Elige tu flujo de pago
Usa el checkout alojado si quieres que VEX Pay muestre la pantalla de pago, o la API directa (pago móvil verificado, C2P o pesos colombianos) si construyes tus propias pantallas.
- 03
Haz tu primer pago de prueba
Crea una sesión de checkout con el monto en dólares y una referencia de tu pedido, abre el enlace y completa el pago simulado.
- 04
Confirma los pagos por webhook
Recibe los eventos firmados de VEX Pay y verifica la firma antes de marcar un pedido como pagado. La página de éxito no es prueba de pago.
- 05
Evita cobros dobles y pagos perdidos
Envía una clave de idempotencia en cada cobro, y corre cada pocos minutos un proceso que revise los pedidos que siguen esperando pago.
- 06
Entiende cómo se libera cada cobro
Cada cobro se libera al instante y llega a tu banco o a tu Pago Móvil, ya sin la comisión. La API te dice el estado de cada envío.
- 07
Pasa a producción
Cambia a tus claves Live, registra la URL de tus webhooks y verifica tu cuenta de retiro con dos micro-depósitos. La documentación incluye una lista de verificación para el día del lanzamiento.
Cuánto cuesta cobrar así
Abrir tu cuenta es gratis y no hay mensualidades. Solo pagas una comisión por cada cobro, según el método que use tu cliente.
- Pago Móvil
- 3,5 %
- Transferencia bancaria
- 3,5 %
Preguntas frecuentes de esta guía
¿En qué lenguajes hay SDK?
Hay SDKs oficiales para Node.js, Python, PHP y Laravel, además de un servidor MCP para agentes de IA. También puedes llamar la API REST directamente.
¿Tengo que construir la pantalla de pago?
No. Con el checkout alojado VEX Pay muestra la pantalla de pago con todos los métodos de tu cuenta, y tu sistema solo crea la sesión y escucha el webhook.
¿Cómo sé que un pago se completó?
Por el webhook firmado que VEX Pay envía al completarse el pago. Si alguno no llega, puedes consultar el estado de la sesión o del pago por la API.
¿Puedo probar sin mover dinero real?
Sí. Las claves de prueba simulan pagos completos, incluidos los webhooks, sin tocar bancos.
Compara y elige cómo cobrar
Crea tu cuenta VEX Pay
Activa tu cuenta de negocio y empieza a cobrar con link de pago y pago móvil, con el dinero al instante en tu banco o en tu Pago Móvil.
- Gratis
- Sin mensualidades
- Cobras desde el primer día