Sal a producción: de la lista de pasos a tu primer pago real

Qué vas a hacer

Tu cuenta Live empieza pendiente: las claves Live devuelven 403 live_mode_not_activated y los enlaces de pago Live no aceptan pagos. VEXPay aprueba el modo Live después de revisar tu negocio y tu integración. Este playbook te lleva por cada paso, en orden.

• Tu integración ya funciona en Test (mira Prueba todo primero).
• Los documentos de tu empresa a mano: acta constitutiva, certificado de RIF, cédula del representante legal y un comprobante de domicilio (PDF, PNG o JPEG, hasta 10 MB cada uno).

Completa la lista Getting started

El Overview del portal muestra una lista Getting started. Complétala en tu cuenta Live:

1. 01
   Agrega tus datos de contacto

   Guarda el email y el teléfono del dueño cuando el portal los pida. Son privados: nunca se muestran a compradores ni se envían en la API. Hasta guardarlos, el portal no deja crear, rotar ni mostrar ninguna clave, y rechaza salir a producción (409 owner_contact_required).

2. 02
   Verifica tu negocio

   Abre Business verification. Completa los datos de la empresa, la actividad, el representante legal y los beneficiarios finales (25 % o más), la declaración PEP y las declaraciones juradas, sube los documentos y envía. Puedes editarla mientras es borrador o cuando VEXPay pide cambios (verás su nota).

3. 03
   Obtén tus credenciales de API

   Ten al menos una clave activa en Credentials. Las claves Live se pueden crear cuando el modo Live está aprobado; hasta entonces, usa Test.

4. 04
   Agrega un endpoint de webhook

   Al menos un endpoint activo en Webhooks. Mira Configurar webhooks.

5. 05
   Guarda y verifica tu cuenta de payout

   Guarda una cuenta de Pago Móvil en Payouts y confirma los dos microdepósitos, o guarda una wallet USDT en USDT (utilizable 24 horas después de guardarla). Mira Retirar tu saldo.

6. 06
   Marketplaces: registra y verifica un vendedor

   Las cuentas marketplace además registran su primer vendedor y verifican un destino de payout de un vendedor. Mira Registrar un vendedor.

Solicita salir a producción

1. 01
   Completa un pago de prueba y una entrega de webhook

   VEXPay revisa en tu cuenta Test al menos un pago completado y una entrega de webhook exitosa.

2. 02
   Haz clic en Request go-live

   En el portal Live, haz clic en Request go-live en el banner "Live mode pending review". El banner muestra entonces que pediste la revisión. El botón no funciona desde el portal Test.

3. 03
   Envía un video corto de tu integración

   VEXPay pide un video corto de tu integración funcionando de punta a punta (un comprador pagando y tu sistema reaccionando). Envíalo por WhatsApp al +58 414 933 3844 (wa.me/584149333844) con el nombre de tu cuenta. La aprobación espera hasta revisarlo.

4. 04
   Espera la aprobación

   La aprobación requiere la verificación de tu negocio aprobada y tu contacto del dueño guardado. Cuando se aprueba el modo Live recibes el webhook tenant.live_status_changed y el banner desaparece.

Cambia a producción

1. 01
   Crea una clave Live

   Con Live seleccionado, abre Credentials y crea una clave. Guárdala en tu entorno de producción.

2. 02
   Registra los webhooks de producción en Live

   Live y Test tienen endpoints y secretos separados. Registra tu URL de producción en la cuenta Live y guarda su secreto.

3. 03
   Despliega y haz un pago real pequeño

   Despliega con la clave Live, paga un monto real pequeño y compruébalo de punta a punta.

curl "${API_URL}/v1/banks" \
  --header "x-api-key: ${VEXPAY_API_KEY}"
# 200 = modo Live activo · 403 live_mode_not_activated = aún no aprobado

Comprueba que funcionó

• GET /v1/banks con la clave Live devuelve 200.
• Tu primer pago real está COMPLETED, y su webhook payment.completed trae livemode: true.
• Los créditos Live aparecen retenidos 24 horas en GET /v1/balance (heldVes, nextReleaseAt) y luego pasan a disponibles.

Si algo sale mal

Relacionado: Salir a producción · Autenticación · Vendedor o marketplace