Colección Postman (liquidación marketplace)

Qué obtienes

Este portal publica dos archivos JSON. Impórtalos en Postman (o un cliente compatible). Las llamadas van a la API hospedada en https://api.banking.chuventures.com — configura la x-api-key de tu tenant antes de ejecutar solicitudes en vivo.

Importar

1. 01
   Descarga ambos archivos

   Usa el panel de descarga de esta página, o abre las URLs /postman/*.json y guárdalas.

2. 02
   Importa en Postman

   Postman → Import → selecciona el JSON de la colección y el del entorno.

3. 03
   Selecciona el entorno

   Selector de entorno (arriba a la derecha) → VEXPay — API. La autenticación de la colección usa {{apiKey}} como x-api-key.

4. 04
   Configura tu API key

   Reemplaza el placeholder apiKey (vk_live_replace_me) con la clave de tu tenant. baseUrl ya es https://api.banking.chuventures.com.

Orden de ejecución

1. 01
   0. Helpers

   Opcional: Listar bancos y Cotizar FX. Usa códigos SIMF de 4 dígitos como banco / bankCode.

2. 02
   1. Comerciantes

   Ejecuta primero Listar comerciantes (rellena merchantId), o Get merchant by externalRef / Get merchant (partner) by externalRef si ya conoces las refs del vendedor (`merchantExternalRef`, `merchantExternalRef2`). Crea y verifica métodos de payout solo si necesitas un vendedor nuevo o un segundo comerciante para un batch real. Detalles: /es/merchants-payouts#lookup-by-ref.

3. 03
   2. Cobrar (fondear float)

   OTP de débito → Débito Inmediato con monto 100.00 y un OTP bancario real. Confirma COMPLETED con Get payment by externalRef o payment.completed. Guía: /es/debito-inmediato.

4. 04
   3. Liquidar

   Payout de prueba (monto "10.00") y, opcionalmente, Batch split con montos que quepan en tu saldo disponible. Conceptos: /es/marketplace-settlement.

Comisiones y saldo disponible