> ## Documentation Index
> Fetch the complete documentation index at: https://docs.velafi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Casos de uso principales

> Guías de principio a fin para las integraciones más comunes de VelaFi: cobrar pagos locales, dispersar pagos, convertir desde y hacia stablecoins, y dar de alta comercios.

Cada guía de abajo recorre un flujo completo: las llamadas que debes hacer, los webhooks que debes manejar, cómo lidiar con las fallas, cómo conciliar y qué revisar antes de salir a producción.

## ¿Qué quieres construir?

> [card] [Cobrar pagos locales con cuentas virtuales](https://docs.velafi.com/es/docs/use-cases/collect-with-virtual-accounts.md)
>
> Dale a cada pagador sus propios datos de depósito locales y abona las transferencias entrantes a tu saldo fiat.

> [card] [Dispersar moneda local desde tu saldo](https://docs.velafi.com/es/docs/use-cases/payouts-from-balance.md)
>
> Envía pagos bancarios locales desde tu saldo fiat y mueve saldo entre tus comercios.

> [card] [Convertir moneda local a stablecoins](https://docs.velafi.com/es/docs/use-cases/convert-to-stablecoins.md)
>
> Convierte moneda local en USDT o USDC con órdenes de on-ramp.

> [card] [Dispersar moneda local fondeada con stablecoins](https://docs.velafi.com/es/docs/use-cases/payouts-funded-by-stablecoins.md)
>
> Vende stablecoins de tu saldo y paga la moneda local a la cuenta bancaria de un beneficiario.

> [card] [Dar de alta a tus clientes como comercios](https://docs.velafi.com/es/docs/use-cases/onboard-your-customers.md)
>
> Registra a tus propios clientes, realiza el KYC/KYB y activa sus cuentas de moneda.

> [card] [Pagos transfronterizos](https://docs.velafi.com/es/docs/guides/global-payments.md)
>
> Envía fiat en una moneda y entrega otra, con stablecoins como riel.

> [card] [Lista de verificación para salir a producción](https://docs.velafi.com/es/docs/use-cases/go-live-checklist.md)
>
> Credenciales, webhooks, idempotencia, manejo de errores y conciliación para cada integración.

## ¿Prefondeado o pago por orden?

Las órdenes de on-ramp se pueden pagar de dos formas. Elige antes de construir, porque esto cambia cómo pagan tus pagadores y cómo fallan las órdenes.

| | Prefondeado | Pago por orden |
| - | - | - |
| **Cómo funciona** | El saldo fiat de tu comercio (Pending Fund) ya tiene el dinero, por ejemplo, de depósitos a su cuenta o a sus cuentas virtuales. VelaFi toma el monto de la orden de ese saldo. | Primero creas la orden. Después, el pagador envía una transferencia bancaria a los datos de pago devueltos en el `paymentInfo` de la orden. |
| **Ideal para** | Plataformas que cobran los fondos antes de convertirlos, y cualquier flujo con volumen regular o alto. | Pagos únicos en los que no puedes mantener un saldo para el pagador. |
| **Modo de falla** | Pocas fallas una vez que el saldo cubre la orden. Revisa el saldo antes de crear órdenes. | Si el pagador no paga dentro de la ventana de pago, la orden expira y se cancela (`orderStatus` `70`). Debes crear una nueva orden y enviar nuevas instrucciones. |

> [!TIP]
>
> Usa el modelo prefondeado siempre que puedas. Un saldo que ya está disponible elimina la dependencia de que el pagador complete una transferencia a tiempo, que es de donde vienen la mayoría de las fallas del pago por orden.

Los pagos funcionan de la misma forma: los [pagos desde tu saldo](https://docs.velafi.com/es/docs/use-cases/payouts-from-balance.md) se pagan desde el saldo fiat, y los [pagos fondeados con stablecoins](https://docs.velafi.com/es/docs/use-cases/payouts-funded-by-stablecoins.md) se pagan desde el saldo cripto del comercio.

## Combina casos de uso

Los flujos comparten los mismos saldos del comercio, así que puedes encadenarlos:

* **Cobra y después convierte.** [Cobra con cuentas virtuales](https://docs.velafi.com/es/docs/use-cases/collect-with-virtual-accounts.md) hacia el saldo fiat y después [convierte a stablecoins](https://docs.velafi.com/es/docs/use-cases/convert-to-stablecoins.md) desde ese saldo con órdenes de on-ramp prefondeadas.
* **Deposita stablecoins y después dispersa localmente.** Deposita USDT o USDC en la billetera cripto del comercio ([Obtener la dirección de depósito cripto](https://docs.velafi.com/es/api-reference/merchant/get-crypto-deposit-address.md)) y después [dispersa moneda local fondeada con stablecoins](https://docs.velafi.com/es/docs/use-cases/payouts-funded-by-stablecoins.md).
* **Cobra y después dispersa.** Cobra pagos locales hacia el saldo fiat y [dispersa desde ese saldo](https://docs.velafi.com/es/docs/use-cases/payouts-from-balance.md) en la misma moneda.
* **Primero da de alta.** Si atiendes a tus propios clientes, [da de alta a cada uno como comercio](https://docs.velafi.com/es/docs/use-cases/onboard-your-customers.md) y ejecuta cualquiera de los flujos anteriores con el `merchantId` de ese cliente.

Construyas lo que construyas, termina con la [lista de verificación para salir a producción](https://docs.velafi.com/es/docs/use-cases/go-live-checklist.md).


## Related topics

- [Lista de verificación para salir a producción](https://docs.velafi.com/es/docs/use-cases/go-live-checklist.md)
- [Dar de alta a tus clientes como comercios](https://docs.velafi.com/es/docs/use-cases/onboard-your-customers.md)
- [Convertir moneda local a stablecoins](https://docs.velafi.com/es/docs/use-cases/convert-to-stablecoins.md)
- [Dispersar moneda local fondeada con stablecoins](https://docs.velafi.com/es/docs/use-cases/payouts-funded-by-stablecoins.md)
- [Dispersar moneda local desde el saldo](https://docs.velafi.com/es/docs/use-cases/payouts-from-balance.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.