# Introducción

Con el API Cash Out de Payvalida, administra y controla tu bolsa de dinero disponible para retiro en las redes de recaudo autorizadas.

Consulta, registra y elimina operaciones de cashout a través de nuestra API REST, haz pruebas en nuestro Sandbox y despliega a producción cuando tu equipo de desarrollo esté listo.

Para usar este API necesitas tener claros algunos conceptos que te explicamos a continuación.

![](/files/-Lz3jDXONujG0i1okt_V)

## 💰Bolsa de Cash Out

La bolsa de cashout es el dinero que tienes disponible para que tus usuarios puedan retirar con una orden de retiro generada por medio de la API.

{% hint style="info" %}
Si aún no tienes este servicio, contacta con nuestro equipo comercial para activarlo.
{% endhint %}

### Características

1. No se pueden crear operaciones de retiro si la suma de los valores entre ellas supera el saldo disponible en la bolsa.
2. El saldo se descuenta de la bolsa cuando se registra la operación y no cuando el usuario final hace el retiro.
3. Las comisiones se descuentan del saldo si la operación lo requiere.
4. El comercio indica cuánto es el saldo que se le debe entregar al usuario.
5. Cuando una orden se vence o se cancela, el saldo se regresa a la bolsa incluyendo la comisión (si la tiene).
6. El tiempo de vencimiento recomendado es de 30 minutos después de registrada la orden. Éste será el tiempo disponible que tiene el usuario para retirar el dinero.
7. Si el retiro tiene costo, el comercio debe indicarlo. La tirilla entregada al usuario incluirá el costo del retiro. Nota: Payvalida nunca hace cobro del retiro y le entrega al usuario el valor total indicado en el registro de la orden.

### Límites transaccionales

* La cantidad máxima de órdenes de retiro creadas al día por el comercio asociadas a un documento de identificación es de cinco (5), independiente de su estado (aprobado o cancelado).
* Colombia: Los usuarios pueden retirar entre cinco mil (5.000 COP) y un millón quinientos mil (1.500.000 COP)  pesos colombianos.
* Ecuador: Los usuarios pueden retirar entre diez (10 USD) y doscientos (200 USD) dólares.&#x20;
* Perú: Los usuarios pueden retirar entre cinco (5 PEN) y quinientos (500 PEN) soles.

<br>

![](/files/PPFEEzWqDdsuMDOD4n9k)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.payvalida.com/api-cashout/master.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
