Vendedor, marketplace y pagos divididos

Cada cuenta es Vendedor o Marketplace. Un vendedor vende lo suyo; un marketplace cobra por sus vendedores, y los pagos divididos reparten cada cobro entre el vendedor y tu comisión.

Dos modelos de negocio

Tu cuenta tiene un modelo de negocio. Define de quién es el dinero y qué pasos te muestra el portal. Los pagos divididos no son un tercer modelo: son la forma en que cobra un marketplace.

	Vendedor	Marketplace
Para quién cobras	Para ti: vendes tus propios productos o servicios	Para tus vendedores: personas o negocios que venden a través de tu plataforma
Dónde llega el dinero	A tu saldo	Se reparte: tu comisión a tu saldo, el neto del vendedor a su saldo
Herramientas principales	Links de pago del portal, links de producto, sesiones de checkout, API de pagos	Comercios (vendedores), pagos divididos en cobros y sesiones de checkout, payouts a vendedores
Ejemplo	Una tienda en línea	Una plataforma de entrenamiento donde cada entrenador es un vendedor

Los términos que usamos

Término	Significado	En la API
Plataforma	Tú, cuando operas un marketplace	Tu cuenta (API key)
Vendedor	Alguien por quien cobras	`merchant` — `/v1/merchants`, ids `mrc_…`
Comisión	La parte de cada venta que te quedas	`applicationFeePercent` (o `applicationFeeVes`)
Neto del vendedor	Lo que recibe el vendedor: el monto, menos la comisión de VEX Pay, menos tu comisión	`pendingVes` del vendedor, luego `availableVes`
Pago dividido	Un cobro o link que indica el vendedor, para que el reparto ocurra solo	`merchantId` en el cobro o la sesión de checkout

Cómo funciona un pago dividido

Registra al vendedor
Crea el vendedor con POST /v1/merchants y verifica su destino de Pago Móvil. Opcionalmente define su comisión (o una comisión por defecto en Portal → Merchants).
Cobra con el vendedor
Envía merchantId (y opcionalmente applicationFeePercent) en un cobro C2P, con tarjeta o débito — o crea una sesión de checkout con ellos y envía su url al comprador.
El pago se completa
Tu comisión queda en tu saldo. El neto del vendedor pasa a su saldo pendiente.
Paga al vendedor
Después de la retención, paga desde el saldo del vendedor con POST /v1/payouts y fromMerchantBalance: true.

Ejemplo: Pago Móvil de Bs 2.000, comisión 3%	Monto
El comprador paga	Bs 2.000,00
Comisión de VEX Pay (Pago Móvil, sale del neto del vendedor)	según tus tarifas — ver Precios
Tu comisión (3%)	Bs 60,00 → tu saldo
Neto del vendedor	Bs 2.000,00 − comisión de VEX Pay − Bs 60,00 → saldo pendiente del vendedor

Un link de pago dividido

Para enviarle un link al comprador en lugar de construir una pantalla de pago, crea una sesión de checkout con el vendedor. Esta acepta solo Pago Móvil y te deja el 3%:

curlbash

curl --request POST "${API_URL}/v1/checkout/sessions" \
  --header "content-type: application/json" \
  --header "x-api-key: ${VEXPAY_API_KEY}" \
  --data '{
    "amountUsd": 20.00,
    "methods": ["pago_movil"],
    "merchantId": "MERCHANT_ID",
    "applicationFeePercent": 3,
    "reference": "class-1042"
  }'

Los links divididos ofrecen solo métodos en bolívares: pago_movil, c2p (Débito Inmediato) y vpos (tarjeta). Pedir USDT, USDC o COP con un vendedor responde 400.
Omite applicationFeePercent para usar la comisión del vendedor, y si no tiene, tu comisión por defecto.
La página de checkout muestra el nombre público del vendedor, porque el comprador le está pagando a él.
Los links de pago del portal son para cuentas Vendedor; un marketplace crea sus links divididos por la API (o los SDKs y el MCP).