Guía para desarrolladores
Sitio de VEXPayReferencia de API
Explorar documentación

Vende con un enlace de pago

Sin sitio web: crea en el portal un enlace por un monto fijo, compártelo y cobra con el checkout de VEX Pay.

Cómo funciona

Un enlace de pago es una página de checkout de VEX Pay por un monto fijo en USD. Tu cliente lo abre en su teléfono, ve el nombre de tu negocio, la descripción y el monto en USD y en Bs a tu tasa del bolívar (BCV o mercado), y paga con los métodos que acepta tu cuenta. El dinero llega a tu propio saldo, menos tu comisión, igual que cualquier otro pago.

  1. Crea el enlace

    En el portal, abre Payment links. Escribe el monto en USD y para qué es (tu cliente lo ve). Si quieres, agrega una referencia privada y una fecha de vencimiento.

  2. Compártelo

    Copy link para pegarlo en WhatsApp o redes sociales, Share para usar el menú de compartir del teléfono, o QR code para mostrar o imprimir un código que tu cliente escanea con la cámara.

  3. Cobra

    Cuando tu cliente paga, el enlace pasa a Paid, el pago aparece en la página Payments y tus webhooks payment.* se envían como siempre.

Estados del enlace

EstadoSignificado
ActiveEsperando el pago.
PaidPagado una vez. Cada enlace acepta un solo pago; quien lo abra después verá que ya fue pagado.
ExpiredVenció antes de que alguien pagara. Ya no acepta pagos.
CancelledLo cancelaste. Ya no acepta pagos. Un enlace pagado no se puede cancelar.

El perfil de tu negocio

En el portal, Business profile define cómo aparece tu negocio arriba de la página de pago y en el comprobante: tu logo, nombre del negocio, RIF, y un WhatsApp y correo opcionales. Los clientes los ven bajo Pagas a, seguido de Estás pagando con la descripción y el desglose del monto, la tasa (Tasa BCV o Tasa de mercado) y el total.

  • Todos los campos son opcionales. Sin perfil, la página muestra el nombre de tu cuenta.
  • El logo puede ser PNG, JPEG o WebP de hasta 2 MB; se muestra en un círculo, así que un logo cuadrado se ve mejor.
  • El WhatsApp y el correo son públicos: tus clientes pueden tocarlos para contactarte. Déjalos vacíos si prefieres no compartirlos.
  • Tu cuenta de prueba usa el mismo perfil que tu cuenta live, y puedes configurarlo antes de salir a producción.

Los compradores que vuelven pagan con un toque

En los métodos en bolívares del checkout (Débito Inmediato y Pago Móvil) el teléfono va primero. Cuando un comprador que ya pagó en cualquier checkout de VEX Pay, y aceptó que lo recordáramos, escribe su teléfono, VEX Pay primero le envía un código de 6 dígitos por WhatsApp a ese teléfono: "Te enviamos un código por WhatsApp al 0414-•••4567". No se muestra nada del comprador, ni se pueden usar sus datos guardados, hasta que escriba el código correcto. Entonces la página muestra cada banco desde el que ha pagado (hasta 5) con la cédula, el nombre y el banco completos, y el más reciente llena el formulario. Lo revisa, cambia de cuenta o corrige, y paga con un toque. Funciona en enlaces de pago, enlaces de producto y checkout sessions, embebidos o no, sin cambios en tu integración.

CuándoQué ve el comprador
Un teléfono recordado en un dispositivo nuevoLa tarjeta del código: el campo de 6 dígitos, Verificar, Reenviar código (después de 60 segundos) y Pagar sin código. Nada más del comprador.
Después del código correctoCada cuenta guardada completa, la seleccionada en campos editables, Quitar en cada cuenta y No soy yo. Este navegador queda de confianza para ese teléfono por 30 días.
Un dispositivo de confianza (código escrito en los últimos 30 días, en este navegador)Sin código. Los bancos guardados con la cédula enmascarada como V-••••5678 y el nombre como Ana P., para pagar con un toque, más Ver mis datos completos (pide un código), Usar otros datos, Olvidar este dispositivo y No soy yo.
El teléfono no tiene WhatsApp, o WhatsApp no respondeUn aviso de una línea y el formulario normal.
Un teléfono que nadie recordóEl formulario normal, como antes.
AcciónQué hace
Botón de pagoPaga desde la cuenta seleccionada. El Débito Inmediato sigue pidiendo la clave (OTP) del banco; el Pago Móvil sigue teniendo que salir de ese teléfono.
Pagar sin códigoCierra la tarjeta del código y deja el formulario vacío. El pago no usa los datos guardados (igual puede guardar datos nuevos si la casilla está marcada).
QuitarQuita ese banco guardado. Al quitar el último, se olvidan los datos del comprador.
Usar otros datosAbre los campos vacíos. Se usa lo que el comprador escriba; lo que deje en blanco sale de los datos guardados.
Olvidar este dispositivoEste navegador deja de saltarse el código para ese teléfono.
No soy yo · Olvidar mis datosBorra los datos guardados y todos los dispositivos de confianza al instante. Ese teléfono ya no se reconoce en ningún checkout.
  • Con consentimiento. El formulario tiene la casilla Recordar mis datos para la próxima vez, marcada por defecto, con la frase de consentimiento completa debajo: "Guardamos tu cédula, nombre y banco para que tu próximo pago con VEX Pay, en cualquier comercio, sea más rápido."
  • Qué se guarda. El teléfono, la cédula/RIF, el nombre del titular (solo en Débito Inmediato) y el código del banco, y solo cuando un pago con la casilla marcada se completa, así que son datos que un banco aceptó. Cada banco (y cédula) es una cuenta guardada: volver a pagar desde él la actualiza, pagar desde un banco nuevo agrega otra, y pasadas 5 se descarta la usada hace más tiempo.
  • En todos los comercios. Un comprador recordado en un negocio se reconoce en todos los checkouts de VEX Pay del mismo modo (live o test). Los datos de live y de test nunca se mezclan. El dispositivo de confianza se recuerda por navegador; en un checkout embebido en tu sitio puede pedir su propio código.
  • Límites del código. Como máximo 3 códigos por teléfono y 10 por IP del comprador por hora, con 60 segundos entre uno y otro; un código dura 10 minutos y permite 5 intentos.
  • Nunca se comparten contigo. Los datos guardados no aparecen en tu portal, en tus consultas a la API ni en tus webhooks; tus webhooks payment.* se ven igual que antes.
  • Olvidar. El comprador usa No soy yo, o desmarca la casilla en su próximo pago (los datos se borran cuando se completa). El soporte de VEX Pay también puede borrarlos a pedido, y los datos sin uso por 12 meses (por banco guardado) se borran solos.
  • Tarjeta, USDT, USDC y COP no usan datos guardados, y los pagos creados por la API de pagos nunca los leen ni los cambian.

Quién puede usar enlaces de pago

Los enlaces de pago están disponibles para cuentas seller. Las cuentas marketplace cobran en nombre de sus comercios y no ven esta página. Una cuenta live puede crear enlaces una vez activada (ver Salir a producción); en modo test, los enlaces solo se pagan con métodos de prueba y no mueven dinero real.