Pricing

Standard rates

These are VEXPay’s standard rates. New accounts start on them. Your rates may differ by agreement; the Rates page in your portal always shows the rates your account actually pays, with the same worked examples.

One exception: a buyer who pays a USD-priced checkout in Colombian pesos is charged the USD amount at VEX Pay’s USDT/COP rate plus a 2.5% FX margin, rounded up to whole pesos. The peso total is shown before the buyer pays, and you receive it in your COP balance net of the COP fee.

Worked examples

Computed with the same fee functions the ledger uses, and rounded to cents the same way. Bolívar and card amounts are USD prices; the buyer pays them in Bs at your Bolívar rate (BCV or market), and the conversion is free.

“After instant withdrawal” is what reaches your own bank account when you withdraw the whole balance: the bolívar percentage is charged again on the amount withdrawn.

Card sales land in your bolívar balance, so moving them to your bank goes through the same instant withdrawal shown above.

Whether a card is debit or credit is determined from the card and the account type the buyer selects (accountType 10 or 20 for debit, 0 for credit). A card VEXPay knows to be a credit card is always charged the credit rate, and when no account type is given, a card VEXPay can’t identify is charged the credit rate.

The last column assumes an external payout fee of 1.00 USDT. Payout fees are per network; the live fee for each one is listed below. A USDT charge at or below the fixed fee is charged the amount itself and nets 0 — never less.

Small charges and the fixed fee

Every bolívar and card payment pays the percentage plus a fixed $0.25. On large charges the fixed part barely matters; on small ones it is most of the fee.

The same $1 charge in bolívares, at an example BCV rate. The percentage converts at your Bolívar rate (BCV here); the fixed $0.25 always converts at BCV.

• Charge: $1.00 × 886.2271 (BCV) = Bs 886.23
• Percentage: 3.5% of Bs 886.23 = Bs 31.02
• Fixed fee: $0.25 × 886.2271 (BCV) = Bs 221.56
• Total fee: Bs 252.57 (rounded once, on the total)
• You receive: Bs 886.23 − Bs 252.57 = Bs 633.66

Best practices when you charge

• Price the fixed fee in. The buyer always pays exactly your price and the fee comes out of what you receive, so on low-ticket items add the $0.25 to the price, or keep prices where the fee is acceptable to you: from $5 it is under 9%, from $10 about 6%.
• Charge once per order, not once per item. The fixed fee applies per payment: five $1 items paid together cost $0.43 in fees, paid separately $1.43.
• Set a minimum order for bolívar and card payments in your store or app.
• Card sales cost more: credit cards are 10% + $0.25. Consider a higher minimum when the buyer pays by card.
• Check the fee before you share a link. Portal → Rates shows your own rates with examples, and GET /v1/me/merchant/payment-links/preview (the VEX Wallet "create Payment Link" screen) returns the exact fee in Bs for an amount.
• Withdraw when it suits you. Instant withdrawals are a percentage with no fixed fee, so how often you withdraw does not change what you pay.

USDT payout fees

Payout fees are set per network and charged once per payout, for USDT and USDC alike. The table above comes from GET /public/pricing; the exact fee for a payout is returned before you send it by GET /v1/crypto/networks.

What is free

• Payouts to your verified merchants
• Payouts to VEX Wallet
• Micro-deposit verification of payout accounts
• The BCV conversion — USD prices convert to Bs at the official BCV rate with no markup

How fees reach your balance

1. 01
   Credit the collection

   On payment.completed, the ledger posts PAYMENT_CREDIT for vesAmount.

2. 02
   Debit the VEXPay fee

   PLATFORM_FEE posts −feeVes: feeVes = usdAmount × (feePercent / 100) at the payment’s rate (BCV or market) + feeFixedUsd at the BCV rate, rounded once.

3. 03
   Hold the reserve

   Available balance subtracts reserveVes as a safety buffer, if your account has one. It is not a separate ledger entry — it is applied when reading the balance.

4. 04
   Hold new credits for 24 hours

   Every credit to your balance — payments in Bs, USDT and COP, conversion credits, adjustments — is held for balanceHoldHours (24h) before payouts can spend it. Held money shows as heldVes (held for stablecoins, heldCop for pesos) with nextReleaseAt, and is released automatically. Payouts asking for more than the available part get 422 insufficient_balance with heldVes and nextReleaseAt. Conversions and seller transfers may use held money; what they produce stays held until the original hold ends. Reversals, chargebacks and refunds still apply to held money.

Where your rates are set

Rates are set per account by VEXPay. There is no plan picker on the payment APIs, and a rate change never rewrites past payments.

• Portal → Rates: your effective rates, which ones differ from the standard, and worked examples with your rates.
• Marketplace seller payouts remain separate: retain your product fee by paying sellers less than you collected. See Marketplace settlement.
• Importable collect → payout walkthrough: Postman.