Get Started

Using the Cash Out API you check and control your available funds to be drawn by your users from the authorized safekeeping networks.

Consult, register and delete cashout operations using our REST API, test in our sandbox environment and deploy to production when your development team is ready.

In order to use to fully understand and use our API, let's get started understanding some concepts:

💰Cashout funds

Your Cashout funds are the maximum amount that all your users can draw using their orders/operations generated by the API, when you're out of funds, you will have to recharge it before your users can start drawing out again.

If you don't have this service, please contact our commercial team to activate it.

Characteristics

  1. You can't create more cashout operations if the combined amount of them is higher than your available balance in your funds.

  2. Balance is discounted when you register the operation/order instead of discounting it when the users executes the cash out.

  3. Commissions are discounted from the funds if the operation requires it.

  4. Users can draw out between one thousand and one million Colombian peso (COP).

  5. The merchant indicates how much money will be delivered to the user.

  6. When an order expires or is nullified, the balance is returned to the funds including the commission if it applies.

  7. The recommended expiring time is 30 minutes after the order is registered. This will be the time available for the user to withdraw out the money.

  8. If the withdrawing has a cost, the commerce has to indicate it, the user's voucher will include the cost of the operation. Note: Payvalida never charges for the withdraw and it delivers the total amount indicated in the registration of the order.

  9. The maximum number of withdrawal orders created per day by the merchant associated with an specific ID is five (5), regardless of their status (approved or cancelled).

Last updated