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

Precios

Las tarifas estándar de VEXPay por riel de pago, ejemplos con cobros de 100, 300 y 1.000, y lo que es gratis. El comprador siempre paga exactamente el precio publicado.

Tarifas estándar

Estas son las tarifas estándar de VEXPay. Las cuentas nuevas empiezan con ellas. Tus tarifas pueden variar por acuerdo; la página Rates de tu portal siempre muestra las tarifas que tu cuenta paga realmente, con los mismos ejemplos.

RielTarifa estándarSe cobra sobre
Cobros en bolívares (Pago Móvil, débito/crédito inmediato, C2P)3,5% + $0,25El monto en USD, pagado en Bs a tu tasa de bolívares; el cargo fijo siempre a tasa BCV
Tarjeta de débito4,0% + $0,25El cobro; el cargo fijo a tasa BCV
Tarjeta de crédito10,0% + $0,25El cobro; el cargo fijo a tasa BCV
Retiro inmediato a tu propia cuenta bancaria3,5% (el porcentaje de bolívares)El monto retirado
Cobros en USDT2,5% + 0,50 USDTEl monto recibido (nunca más que el monto recibido)
Cobros en pesos colombianos (tarjeta, PSE, Bancolombia, Bre-B, Nequi, Daviplata)4,5% + COP 1.500El monto en pesos (nunca más que el monto; mínimo COP 20.000 por pago); se devuelve en un reembolso
Pagos en USDT a una dirección externaLa comisión de payout de la red elegida (ver abajo)Cada pago

Una excepción: si el comprador paga en pesos colombianos un checkout con precio en USD, se le cobra el monto en USD a la tasa USDT/COP de VEX Pay más un margen cambiario de 2,5 %, redondeado hacia arriba a pesos enteros. El total en pesos se muestra antes de pagar, y lo recibes en tu saldo COP descontada la comisión COP.

Ejemplos

Calculados con las mismas funciones de comisión que usa el ledger y redondeados a céntimos de la misma forma. Los montos en bolívares y con tarjeta son precios en USD; el comprador los paga en Bs a tu tasa del bolívar (BCV o mercado), y la conversión es gratis.

CobroComisión VEXPayRecibesTras retiro inmediato
$100,00$3,75$96,25$92,88
$300,00$10,75$289,25$279,13
$1.000,00$35,25$964,75$930,98

“Tras retiro inmediato” es lo que llega a tu propia cuenta bancaria al retirar todo el saldo: el porcentaje de bolívares se cobra otra vez sobre el monto retirado.

CobroComisión débitoRecibes (débito)Comisión créditoRecibes (crédito)
$100,00$4,25$95,75$10,25$89,75
$300,00$12,25$287,75$30,25$269,75
$1.000,00$40,25$959,75$100,25$899,75

Las ventas con tarjeta llegan a tu saldo en bolívares, así que llevarlas a tu banco pasa por el mismo retiro inmediato de arriba.

Si una tarjeta es de débito o de crédito se determina por la tarjeta y el tipo de cuenta que elige el comprador (accountType 10 o 20 para débito, 0 para crédito). Una tarjeta que VEXPay sabe que es de crédito siempre paga la tarifa de crédito y, si no se indica tipo de cuenta, una tarjeta que VEXPay no puede identificar paga la tarifa de crédito.

CobroComisión VEXPayRecibesTras un pago de 1,00 USDT
100,00 USDT3,00 USDT97,00 USDT96,00 USDT
300,00 USDT8,00 USDT292,00 USDT291,00 USDT
1.000,00 USDT25,50 USDT974,50 USDT973,50 USDT

La última columna supone un pago a una dirección externa con una comisión de 1,00 USDT. Las comisiones de pago dependen de la red; la vigente de cada una está abajo. Un cobro USDT igual o menor al cargo fijo se cobra por el monto mismo y deja 0, nunca menos.

Cobros pequeños y el cargo fijo

Cada pago en bolívares o con tarjeta paga el porcentaje más un cargo fijo de $0,25. En cobros grandes el cargo fijo casi no se nota; en cobros pequeños es la mayor parte de la comisión.

CobroComisión VEXPayRecibesLa comisión es
$1,00$0,29$0,7129,0%
$2,00$0,32$1,6816,0%
$5,00$0,43$4,578,6%
$10,00$0,60$9,406,0%
$20,00$0,95$19,054,8%
$50,00$2,00$48,004,0%

El mismo cobro de $1 en bolívares, con una tasa BCV de ejemplo. El porcentaje se convierte a tu tasa de bolívares (aquí BCV); el cargo fijo de $0,25 siempre se convierte a tasa BCV.

  • Cobro: $1,00 × 886,2271 (BCV) = Bs 886,23
  • Porcentaje: 3,5% de Bs 886,23 = Bs 31,02
  • Cargo fijo: $0,25 × 886,2271 (BCV) = Bs 221,56
  • Comisión total: Bs 252,57 (se redondea una sola vez, sobre el total)
  • Recibes: Bs 886,23 − Bs 252,57 = Bs 633,66

Buenas prácticas al cobrar

  • Incluye el cargo fijo en tu precio. El comprador siempre paga exactamente tu precio y la comisión sale de lo que recibes, así que en productos de bajo monto suma los $0,25 al precio, o mantén precios donde la comisión te resulte aceptable: desde $5 es menos de 9%, desde $10 cerca de 6%.
  • Cobra una vez por pedido, no una vez por producto. El cargo fijo se aplica por pago: cinco productos de $1 pagados juntos cuestan $0,43 de comisión; pagados por separado, $1,43.
  • Define un pedido mínimo para pagos en bolívares y con tarjeta en tu tienda o app.
  • Las ventas con tarjeta cuestan más: tarjeta de crédito es 10% + $0,25. Considera un mínimo mayor cuando el comprador paga con tarjeta.
  • Revisa la comisión antes de compartir un link. Portal → Rates muestra tus tarifas con ejemplos, y GET /v1/me/merchant/payment-links/preview (la pantalla "Crear Payment Link" de VEX Wallet) devuelve la comisión exacta en Bs para un monto.
  • Retira cuando te convenga. Los retiros inmediatos son un porcentaje sin cargo fijo, así que la frecuencia de tus retiros no cambia lo que pagas.

Comisiones de pagos en USDT

RedComisión por pago
BNB Smart Chain (BEP20)1,00 USDT
Polygon1,00 USDT
Solana1,00 USDT

Las comisiones de pago se fijan por red y se cobran una vez por pago, tanto en USDT como en USDC. La tabla de arriba viene de GET /public/pricing; GET /v1/crypto/networks devuelve la comisión exacta antes de enviar el pago.

Lo que es gratis

  • Pagos a tus comercios verificados
  • Pagos a VEX Wallet
  • Verificación de cuentas de pago con micro-depósitos
  • La conversión BCV: los precios en USD se convierten a Bs a la tasa oficial BCV sin recargo

Cómo llegan las comisiones a tu saldo

  1. Acredita el cobro

    En payment.completed, el ledger registra PAYMENT_CREDIT por vesAmount.

  2. Debita la comisión de VEXPay

    PLATFORM_FEE registra −feeVes: feeVes = usdAmount × (feePercent / 100) a la tasa del pago (BCV o mercado) + feeFixedUsd a tasa BCV, redondeado una sola vez.

  3. Retén la reserva

    El saldo disponible resta reserveVes como colchón, si tu cuenta tiene una. No es un tipo de asiento aparte: se aplica al leer el balance.

  4. Retener los créditos nuevos 24 horas

    Cada crédito a tu saldo — pagos en Bs, USDT y COP, créditos de conversiones, ajustes — queda retenido balanceHoldHours (24 h) antes de que un pago (payout) pueda usarlo. Lo retenido aparece como heldVes (held en stablecoins, heldCop en pesos) con nextReleaseAt, y se libera solo. Un payout que pida más que lo disponible recibe 422 insufficient_balance con heldVes y nextReleaseAt. Las conversiones y las transferencias a vendedores sí pueden usar lo retenido; lo que producen sigue retenido hasta que termine la retención original. Reversos, contracargos y reembolsos siguen aplicando sobre lo retenido.

Dónde se configuran tus tarifas

VEXPay configura las tarifas de cada cuenta. No hay selector de plan en las APIs de pago, y un cambio de tarifa nunca reescribe pagos anteriores.

  • Portal → Rates: tus tarifas vigentes, cuáles difieren del estándar y ejemplos calculados con tus tarifas.
  • Los payouts a vendedores del marketplace son aparte: retén la comisión de tu producto pagando al vendedor menos de lo cobrado. Ver Liquidación marketplace.
  • Recorrido importable de cobro → payout: Postman.