Postman collection (marketplace settlement)

What you get

Two JSON files ship with this portal. Import both into Postman (or a compatible client). Calls go to the hosted API at https://api.banking.chuventures.com — set your tenant x-api-key before running live requests.

Import

1. 01
   Download both files

   Use the download panel on this page, or open the /postman/*.json URLs and save them.

2. 02
   Import into Postman

   Postman → Import → select the collection JSON and the environment JSON.

3. 03
   Select the environment

   Top-right environment picker → VEXPay — API. Collection auth uses {{apiKey}} as x-api-key.

4. 04
   Set your API key

   Replace the placeholder apiKey (vk_live_replace_me) with your tenant key. baseUrl is already https://api.banking.chuventures.com.

Run order

1. 01
   0. Helpers

   Optional: List banks and Get FX quote. Use 4-digit SIMF codes as banco / bankCode.

2. 02
   1. Merchants

   Run List merchants first (auto-fills merchantId), or Get merchant by externalRef / Get merchant (partner) by externalRef when you already know the seller refs (`merchantExternalRef`, `merchantExternalRef2`). Create + verify payout methods only if you need a new seller or a second merchant for a real batch split. Details: /merchants-payouts#lookup-by-ref.

3. 03
   2. Collect (fund float)

   Debit OTP → Débito Inmediato with monto 100.00 and a real bank OTP. Confirm COMPLETED via Get payment by externalRef or payment.completed. Walkthrough: /debito-inmediato.

4. 04
   3. Settle

   Single payout smoke test (monto "10.00"), then optionally Batch split with montos that fit your available balance. Concepts: /marketplace-settlement.

Fees and available balance