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

Niveles de verificación y límites de vendedor

Todos los vendedores de VEX Pay cobran hasta un límite mensual y por venta según su nivel de verificación. VEX Pro los sube.

Cómo funcionan los niveles

Un vendedor es cualquier cuenta de VEX Pay en vivo (una persona con RIF personal o una empresa con RIF J), sin importar cómo se creó, o un vendedor de VEX Wallet. Cada vendedor tiene un nivel de 0 a 3. El nivel sale de los requisitos de verificación; los puntos (0–100) solo muestran el avance. Un vendedor mantiene su nivel mientras sigan cumplidos todos los requisitos que necesita: un requisito revocado baja el nivel de inmediato.

NivelNombreRequisitos
0RegistradoSolo el registro (modo de prueba; sin ventas Live)
1Identidad verificadaEmail y WhatsApp, identidad (documento y selfie, una verificación con Didit o un KYC de VEX Wallet vinculado), RIF en el SENIAT, una cuenta de cobro a nombre del vendedor
2Vendedor verificadoNivel 1, más comprobante de domicilio, datos del negocio, e historial de ventas o presencia en línea revisada
3Negocio registradoNivel 2, más el registro del negocio (firma personal; las empresas lo cumplen con su KYB)

Cada nivel tiene un límite mensual y un máximo por venta, que suben con el nivel. Cada vendedor ve sus propios límites, el uso del mes y cuándo se reinicia en el portal y en VEX Wallet; VEX Pay no los publica. El mes es el mes calendario en hora de Caracas. El uso es la suma de las ventas Live del vendedor en el mes, cada una por su monto en dólares fijado al crear la venta (Bs a la tasa BCV, USDT uno a uno, COP a la tasa del día). No cuentan las ventas fallidas, vencidas, canceladas ni reversadas por completo, las recargas ni el modo de pruebas. Operaciones de VEX Pay puede fijar otro nivel o límites a medida para un vendedor, siempre con un motivo escrito.

Sube tus límites

  1. Abre Verificación

    En el portal, Verificación muestra tu nivel, tus puntos, tus límites, lo cobrado este mes y cuándo se reinicia, y lo que falta en cada requisito.

  2. Completa los requisitos

    Sube tus documentos (cédula, selfie, certificado de RIF del SENIAT con su QR, comprobante de domicilio, registro de la firma personal), verifica una cuenta de Pago Móvil a tu nombre y cuéntanos qué vendes.

  3. Espera la revisión

    La mayoría de los requisitos se actualizan solos. El comprobante de domicilio, la firma personal y la presencia en línea los revisa VEX Pay. El nivel sube apenas se cumplen los requisitos.

Los vendedores reciben un email y un WhatsApp una vez al mes al llegar al 80% y al 100% de su límite mensual.

Un RIF para vender, y la declaración jurada

Todo vendedor necesita un RIF verificado para vender. Una persona se registra con un RIF V o E (o con pasaporte, como vendedor extranjero); una empresa con su RIF J o G. A una persona que sube un RIF J o G se le pide abrir una cuenta de empresa.

El USDT (convertir a USDT, pagar o retirar en USDT, guardar una billetera USDT) puede limitarse a vendedores con RIF verificado. Cuando aplica, la llamada responde 403 rif_required_for_usdt y los bolívares se siguen liquidando al Pago Móvil del vendedor.

Declaración jurada de origen y destino de los fondos. Todo vendedor acepta una declaración jurada corta antes de vender en vivo, de nuevo cuando cambia el texto, cada 12 meses y la primera vez en un mes que sus cobros llegan a US$1.000. Los vendedores de antes de la declaración tienen un plazo de gracia. Si un vendedor declara ser una persona expuesta políticamente (PEP), VEX Pay lo revisa antes de que venda en vivo. Mientras se deba la declaración, las ventas nuevas en vivo responden 422 declaration_required. Un pago que el comprador ya envió nunca se rechaza.

Errores

EstadoCódigoCuándoCuerpo
422seller_limit_reachedLa venta llevaría al vendedor por encima de su límite mensual. Se devuelve antes de cualquier llamada al banco, en todos los medios (C2P, tarjeta, débito inmediato, domiciliación, instrucciones de Pago Móvil, USDT y COP).message (en español, apto para mostrar al comprador), limitUsd, usedUsd, level
422seller_ticket_limitLa venta, o un enlace de pago al crearlo, supera el máximo por venta del vendedor.message, limitUsd, level
422declaration_requiredEl vendedor debe la declaración jurada de fondos, o una declaración PEP está en revisión.message (apto para el comprador), reason
403rif_required_for_usdtUn vendedor sin RIF verificado intentó convertir a USDT, pagar o retirar en USDT, o guardar una billetera USDT.message
409rif_takenRegistro: el RIF ya es el RIF de otro negocio. company_rif_taken es el nombre anterior, que se sigue enviando mientras el registro sea solo para empresas; acepta ambos. Con las claves de identidad activas, el cuerpo trae además matched (ver Una sola cuenta de vendedor).message, field, matched?
409identity_takenRegistro o envío del KYB: la cédula o el número de WhatsApp ya pertenecen a otra cuenta de vendedor (en despliegue).message, field, matched (rif, cedula o phone)
409registration_takenCarga de la firma personal: esta inscripción del Registro Mercantil (oficina, tomo y número) ya es de otro vendedor. No se guarda nada.message, field
409registration_rif_mismatchCarga de la firma personal: el RIF de la inscripción no es el RIF del vendedor. No se guarda nada.message, field
422 seller_limit_reachedjson
{
  "error": "seller_limit_reached",
  "message": "Este vendedor alcanzó su límite de cobros de este mes. Intenta otro método o contacta al vendedor.",
  "limitUsd": "250.00",
  "usedUsd": "240.00",
  "level": 1
}

Una sola cuenta de vendedor (app y portal)

Una persona o un negocio tiene una sola cuenta de vendedor, haya empezado en la app VEX Pay (Vender con VEX) o en el portal. VEX Pay guarda un registro por RIF, por cédula (incluida la cédula dentro de un RIF personal V o E; la cédula del representante de una empresa no cuenta) y por número de WhatsApp verificado. Registrarse de nuevo con uno de ellos no crea una segunda cuenta: el portal responde 409 rif_taken (o identity_taken, o phone_taken) y la app responde 409 SELLER_ACCOUNT_EXISTS. La respuesta nunca nombra la otra cuenta, y cada rechazo cuenta para el límite de registros por IP.

Para usar el mismo negocio desde la app y el portal, su titular lo conecta desde la app VEX Pay con el código del negocio (ver El titular del negocio usa la app VEX Pay). Si no es posible, el soporte de VEX Pay vincula los accesos a mano después de verificar a la persona.

409 rif_takenjson
{
  "error": "rif_taken",
  "message": "No pudimos crear la cuenta con este RIF. Si ya usas VEX Pay, inicia sesión o escríbenos a soporte.",
  "field": "rif"
}

El titular del negocio usa la app VEX Pay

Todo negocio live tiene un titular: una persona verificada en la app VEX Pay (Didit). Después de confirmar tu email y tu WhatsApp en el portal, el portal muestra un código de 6 caracteres y un QR. Abre la app, verifica tu identidad e ingresa el código («Tengo un código de negocio»), o escanea el QR. La app muestra «Conectar con <negocio>»; al confirmar, el negocio queda conectado. Mientras tanto puedes usar el modo test, pero no puedes enviar tu verificación, solicitar salir a producción ni crear claves live: la respuesta es 409 owner_not_linked.

  1. Negocio personal (RIF V o E)

    La cédula del RIF y el nombre deben coincidir con tu identidad verificada en la app.

  2. Empresa (RIF J o G)

    Debes ser su representante legal: tu documento y tu nombre deben coincidir con el representante de la verificación. Si todavía no hay representante, al confirmar pasas a serlo, con el nombre y el documento de la app (se muestran como «Verificado en la app», sin poder editarse). Entonces no hace falta subir tu documento ni tu selfie.

  3. Empezar desde la app

    «Abrir cuenta de negocio» en la app crea el negocio contigo como titular y abre el portal, con la sesión iniciada, en el paso de verificación.

EstadoCódigoCuándoCuerpo
409owner_not_linkedEl negocio aún no tiene titular en la app (enviar KYB, solicitar salir a producción, claves live, nuevos enlaces de pago). Un negocio aprobado cuyos 30 días terminaron trae reason: "grace_expired"; sus enlaces se pausan y los retiros de su saldo siguen funcionando.message, reason?
409owner_mismatchEn la app: la identidad verificada no coincide con el RIF ni con el representante legal. No se conecta nada y no hay forma de saltarlo.message

Verifica tu identidad con Didit

Los vendedores que son personas (del portal, de la app VEX Pay o creados por VEX Pay) pueden completar el paso de identidad con Verificar con Didit (en KYB → Documentos): una foto de la cédula o el pasaporte y una selfie con prueba de vida. Cuando Didit aprueba, el número del documento coincide con tu RIF personal y el nombre coincide con el del solicitante, la identidad queda lista sin esperar la revisión de VEX Pay. Si no, el paso queda en revisión y VEX Pay lo revisa. Subir la cédula y la selfie a mano sigue disponible. Puedes iniciar hasta 3 verificaciones de Didit al mes; una sin terminar se retoma. Si tu cuenta de la app VEX Pay está verificada (KYC) con el mismo nombre y documento que la solicitud, la identidad ya está lista y no se muestra Didit (409 didit_not_needed). Si no tienes la app vinculada, confirma tu email y tu WhatsApp antes de abrir Didit. En despliegue.

Apela un paso rechazado o revocado

Cuando VEX Pay rechaza o revoca un paso, la página Verificación muestra el motivo. La decisión se mantiene hasta que se revise de nuevo: una carga nueva no la deshace. Usa Apelar para explicar (entre 20 y 1.000 caracteres) y adjunta hasta 3 documentos. Puedes tener una apelación abierta por paso; tras una apelación rechazada puedes apelar el mismo paso 30 días después. Abrir una apelación no cambia tu nivel ni tus límites. VEX Pay decide con una nota y te escribe por email. Los pasos revocados por una coincidencia en listas de sanciones o por fraude muestran Contacta a soporte. En despliegue.

Insignia de vendedor verificado

En el checkout, los enlaces de pago y el comprobante, un vendedor de nivel 1 o más muestra Vendedor verificado · Nivel N junto a su nombre. Al abrirla se ve lo que VEX Pay verificó: la identidad, el RIF en el SENIAT, la cuenta de cobro y, en el nivel 3, el registro del negocio. Nunca muestra documentos, números de cédula, puntos ni límites. Los vendedores de nivel 0 y los restringidos no muestran insignia.

Los payouts esperan al banco

Para los vendedores, una venta en Bs cuya confirmación del banco sigue pendiente (por ejemplo, un C2P de Sofitasa que espera ser depositado) queda retenida hasta que el banco la confirme, aunque haya pasado la retención habitual. Los saldos de los vendedores de VEX Wallet muestran esa parte como unconfirmedVes (dentro de pendingVes); un barrido o un payout nunca la usa. Una venta que el banco no encuentra queda retenida para que VEX Pay la revise.