VEXPay · Guía
Cómo integrar pagos en bolívares en tu app
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 VEXPay. Este es el camino completo, desde la primera llamada de prueba hasta el primer cobro real.
El problema
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.
Paso a paso
Cómo hacerlo 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 y el saldo no tiene retención.
- 02
Elige tu flujo de pago
Usa el checkout alojado si quieres que VEXPay muestre la pantalla de pago, o la API directa (pago móvil verificado, C2P, tarjeta, USDT 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 VEXPay 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 saldos y retiros
Cada cobro queda retenido 24 horas antes de poder retirarlo o enviarlo. La API te dice cuánto está disponible, cuánto retenido y cuándo se libera.
- 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.
Comisiones
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 %
- Tarjeta de débito
- 4 %
- Tarjeta de crédito
- 5 %
- USDT
- 2,5 % + $0,50
Preguntas frecuentes
Preguntas frecuentes de esta guía
Sigue leyendo
Compara y elige cómo cobrar
Crea tu cuenta VEXPay
Activa tu cuenta de negocio y empieza a cobrar con link de pago, pago móvil y tarjeta, con el dinero en tu cuenta VEX al instante.
Gratis · Sin mensualidades · Cobras desde el primer día