Guía para desarrolladores
Referencia de API
Explorar documentación

Planes de precios

Paquetes comerciales que se mapean a las comisiones del ledger del tenant: porcentaje sobre USD, fijo en USD por pago completado y una reserva en VES retenida del saldo disponible.

Qué son estos planes

Los planes son paquetes comerciales aplicados a la configuración de fees del tenant: feePercent, feeFixedUsd y reserveVes. No se eligen con un campo de la API en cada pago.

Comparación de planes

PlanfeePercentfeeFixedUsdReserva
Starter2.5%$0.15Más alta (configurada por tenant)
Growth2.0%$0.10Media (configurada por tenant)
Volume1.5%$0.05Según volumen rodante (definida por ops)

Cómo afecta el saldo disponible

  1. Acredita el cobro

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

  2. Debita la comisión de plataforma

    PLATFORM_FEE registra −feeVes a partir del porcentaje + fijo en USD del plan convertidos al bcvRate.

  3. Retén la reserva

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

Cómo elegir un plan

PlanIdeal para
StarterTenants nuevos en arranque; comisión y reserva más altas
GrowthVolumen estable; comisión y reserva medias
VolumeAlto throughput; fees listados más bajos con reserva ligada al volumen rodante

Configuración

Ops (o admins del dashboard) configuran feePercent, feeFixedUsd y reserveVes en el tenant. No hay selector de plan en las APIs de pago en el momento del checkout.

  • Dashboard → Tenants → Fees: ver y actualizar feePercent, feeFixedUsd, reserveVes y el saldo disponible.
  • Los payouts a vendedores del marketplace siguen siendo aparte: retiene la comisión de tu producto pagando a los vendedores menos de lo cobrado. Ver /es/marketplace-settlement.
  • Recorrido importable cobro → payout: /es/postman.