Seller verification levels and limits
Every VEX Pay seller collects up to a monthly and per-sale limit set by its verification level. VEX Pro raises them.
How levels work
A seller is any live VEX Pay account (a person with a personal RIF, or a company with a J RIF), however it was created, or a VEX Wallet seller. Each seller has a level from 0 to 3. The level comes from verification items; points (0–100) only show progress. A seller keeps a level while every item it needs stays done: a revoked item lowers the level at once.
| Level | Name | Needs |
|---|---|---|
| 0 | Registrado | Sign-up only (test mode; no live sales) |
| 1 | Identidad verificada | Email and WhatsApp, identity (ID and selfie, a Didit check, or a linked VEX Wallet KYC), RIF on SENIAT, a payout account in the seller’s name |
| 2 | Vendedor verificado | Level 1, plus proof of address, business details, and a sales track record or reviewed online presence |
| 3 | Negocio registrado | Level 2, plus the business registration (firma personal; companies meet it with their KYB) |
Each level has a monthly limit and a per-sale limit, which grow with the level. A seller sees its own limits, this month’s usage and when it resets in the portal and in VEX Wallet; VEX Pay does not publish them. The month is the calendar month in Caracas time. Usage is the sum of the seller’s live sales in the month, each counted at its US dollar amount fixed when the sale was created (Bs at the BCV rate, USDT one to one, COP at the day’s rate). Failed, expired, canceled and fully reversed sales, top-ups and test mode do not count. VEX Pay ops can set a different level or custom limits for a seller, always with a written reason.
Raise your limits
- Open Verificación
In the portal, Verification shows your level, points, limits, this month’s usage and when it resets, and what each item still needs.
- Complete the items
Upload your documents (ID, selfie, SENIAT RIF certificate with its QR, proof of address, firma personal registration), verify a Pago Móvil payout account in your name, and tell us what you sell.
- Wait for the review
Most items update on their own. Proof of address, the firma personal and online presence are reviewed by VEX Pay. The level rises as soon as the items are done.
Sellers get an email and a WhatsApp message once a month when they reach 80% and 100% of their monthly limit.
A RIF to sell, and the sworn declaration
Every seller needs a verified RIF to sell. A person signs up with a V or E RIF (or a passport, as a foreign seller); a company with its J or G RIF. A person who uploads a J or G RIF is asked to open a company account instead.
USDT (conversions to USDT, USDT payouts and withdrawals, saving a USDT payout wallet) can be limited to sellers with a verified RIF. When that applies, the call answers 403 rif_required_for_usdt and bolívares keep settling to the seller’s Pago Móvil.
Sworn declaration of funds. Every seller accepts a short sworn declaration of the origin and destination of its funds (in Spanish) before selling live, again when the text changes, every 12 months, and the first time in a month its collections reach US$1,000. Sellers from before the declaration have a grace period. A seller who declares being a politically exposed person (PEP) is reviewed by VEX Pay before selling live. While a declaration is owed, new live sales answer 422 declaration_required. A payment the buyer already sent is never refused.
Errors
| Status | Code | When | Body |
|---|---|---|---|
| 422 | seller_limit_reached | The sale would take the seller past its monthly limit. Returned before any bank call, on every rail (C2P, card, débito inmediato, domiciliación, Pago Móvil instructions, USDT and COP). | message (Spanish, safe to show the buyer), limitUsd, usedUsd, level |
| 422 | seller_ticket_limit | The sale, or a payment link at creation, is above the seller’s per-sale limit. | message, limitUsd, level |
| 422 | declaration_required | The seller owes the sworn declaration of funds, or a PEP declaration is in review. | message (buyer-safe), reason |
| 403 | rif_required_for_usdt | A seller without a verified RIF tried a USDT conversion, a USDT payout or withdrawal, or to save a USDT payout wallet. | message |
| 409 | rif_taken | Sign-up: the RIF is already the tax ID of another business. company_rif_taken is the deprecated name, still sent while sign-up is for companies only; accept both. With identity keys on, the body also has matched (see One seller account). | message, field, matched? |
| 409 | identity_taken | Sign-up or KYB submission: the cédula or WhatsApp number already belongs to another seller account (rolling out). | message, field, matched (rif, cedula or phone) |
| 409 | registration_taken | Firma personal upload: this Registro Mercantil entry (office, tomo and número) is already another seller’s. Nothing is stored. | message, field |
| 409 | registration_rif_mismatch | Firma personal upload: the RIF on the registration is not the seller’s RIF. Nothing is stored. | message, field |
{
"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
}One seller account (app and portal)
A person or business has one seller account, whether they started in the VEX Pay app (Vender con VEX) or on the portal. VEX Pay keeps one record per RIF, per cédula (including the cédula inside a personal V or E RIF; a company representative’s cédula is not counted) and per verified WhatsApp number. Signing up again with one of them does not create a second account: the portal answers 409 rif_taken (or identity_taken, or phone_taken), and the app answers 409 SELLER_ACCOUNT_EXISTS. The answer never names the other account, and each refusal counts toward the sign-up limit per IP.
To use the same business from the app and the portal, its owner connects it from the VEX Pay app with the business code (see The business owner uses the VEX Pay app). If that is not possible, VEX Pay support links the logins by hand after checking the person.
{
"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"
}The business owner uses the VEX Pay app
Every live business has an owner: a person verified in the VEX Pay app (Didit). After you confirm your email and WhatsApp on the portal, the portal shows a 6-character code and a QR. Open the app, verify your identity and enter the code (“Tengo un código de negocio”), or scan the QR. The app shows “Conectar con <negocio>”; confirming links the business. Until then you can use test mode, but you can’t send your verification, request go-live or create live keys: the answer is 409 owner_not_linked.
- Personal business (V or E RIF)
The cédula in the RIF and the name must match your verified identity in the app.
- Company (J or G RIF)
You must be its legal representative: your document and name must match the representative in the verification. With no representative yet, confirming makes you the representative, and your name and document come from the app (shown as “Verificado en la app”, read-only). Your ID and selfie uploads are then not required.
- Starting in the app
“Abrir cuenta de negocio” in the app creates the business with you as owner and opens the portal, signed in, on the verification step.
| Status | Code | When | Body |
|---|---|---|---|
| 409 | owner_not_linked | The business has no app owner yet (KYB submit, go-live request, live keys, new payment links). An approved business whose 30 days ended has reason: "grace_expired"; its links pause, payouts of its balance keep working. | message, reason? |
| 409 | owner_mismatch | In the app: the verified identity does not match the RIF or the legal representative. Nothing is linked; there is no override. | message |
Verify your identity with Didit
Sellers who are people (signed up on the portal, in the VEX Pay app or created by VEX Pay) can complete the identity item in the portal with Verificar con Didit (in KYB → Documentos): a photo of the cédula or passport and a selfie with a liveness check. When Didit approves and the document number matches your personal RIF and the name matches the applicant, identity is done without waiting for VEX Pay review. Otherwise the item stays in review and VEX Pay checks it. Uploading the ID and the selfie by hand is still available. You can start up to 3 Didit checks a month; an unfinished one is resumed. If your VEX Pay app account is KYC-verified with the same name and document as the application, identity is already done and no Didit step is shown (409 didit_not_needed). Without a linked app account, confirm your email and WhatsApp before opening Didit. Rolling out.
Appeal a declined or revoked item
When VEX Pay declines or revokes an item, the Verificación page shows the reason. The decision stands until it is reviewed again: a new upload does not undo it. Use Apelar to explain (20 to 1,000 characters) and attach up to 3 documents. You can have one open appeal per item; after a rejected appeal you can appeal the same item again 30 days later. Opening an appeal does not change your level or limits. VEX Pay decides with a note and emails you. Items revoked for a sanctions match or fraud show Contacta a soporte instead. Rolling out.
Verified-seller badge
On the hosted checkout, payment links and the receipt, a seller at level 1 or above shows Vendedor verificado · Nivel N next to its name. Opening it lists what VEX Pay checked: the identity, the RIF on SENIAT, the payout account and, at level 3, the business registration. It never shows documents, ID numbers, points or limits. Level 0 and restricted sellers show no badge.
Payouts wait for the bank
For sellers, a Bs sale whose bank confirmation is still pending (for example a Sofitasa C2P waiting to be deposited) stays on hold until the bank confirms it, even after the usual hold. VEX Wallet seller balances report that part as unconfirmedVes (inside pendingVes); a sweep or payout never spends it. A sale the bank does not find stays on hold for VEX Pay to review.