> ## 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.

# Evento de retiro de on-ramp

> Referencia del payload ON_RAMP_WITHDRAW_WEBHOOK que VelaFi envía cuando la cripto de una orden de on-ramp por API completada se retiró a la billetera de destino de la orden.

Para las órdenes de on-ramp (`BUY`) creadas mediante la API con una red y una dirección de billetera de destino, VelaFi puede retirar la cripto comprada a esa dirección después de que la orden se completa. Cuando el retiro es exitoso, VelaFi envía una solicitud HTTP POST firmada a tu endpoint de `ON_RAMP_WITHDRAW_WEBHOOK`. Verifica el header `signature` y responde con `{"callbackStatus": "SUCCESS"}` para confirmar la recepción.

> [!NOTE]
>
> VelaFi habilita por cuenta el retiro automático a una dirección de destino, y no todas las órdenes se retiran automáticamente. Las órdenes que no se retiran automáticamente no disparan este webhook. Los retiros automáticos también disparan [`CRYPTO_WITHDRAW_WEBHOOK`](https://docs.velafi.com/es/api-reference/webhooks/crypto-withdraw-message-push) si estás suscrito a él.

## Headers de la solicitud

| Header | Descripción |
| - | - |
| `signature` | Firma RSA-SHA256 del cuerpo sin procesar de la solicitud, codificada en hexadecimal. Usa la `publicKey` de tu webhook para verificarla. Consulta [Configuración de webhooks](https://docs.velafi.com/es/api-reference/webhooks/webhook-setup.md). |
| `Content-Type` | `application/json` |

## Campos del payload

**webhookId** `string`

El ID del webhook para el que se encoló el evento.

**eventType** `string`

Siempre `ON_RAMP_WITHDRAW_WEBHOOK` para este tipo de evento.

**orderId** `string`

ID de la orden de on-ramp.

**userId** `string`

El ID de tu cuenta (usuario) de VelaFi.

**clientId** `string`

El identificador de orden que proporcionaste como cliente. Se omite si no proporcionaste uno.

**network** `string`

Red del retiro, tal como se configuró en la orden.

**address** `string`

Dirección de la billetera de destino, tal como se configuró en la orden.

**crypto** `string`

Criptomoneda de la orden, por ejemplo `USDT`.

**amount** `string`

Monto cripto de la orden (el mismo valor que `cryptoAmount` en `ORDER_WEBHOOK`).

**txHash** `string`

Hash de la transacción on-chain del retiro. Se omite si no está disponible.

**status** `string`

Siempre `succeeded`. Los retiros fallidos no disparan este webhook.

**timestamp** `string`

Marca de tiempo Unix (milisegundos) en la que se firmó este intento de entrega.

## Payload de ejemplo

```json Incoming POST body theme={null}
{
  "webhookId": "ebab8a9663704e7cbbebe672c7c67912",
  "eventType": "ON_RAMP_WITHDRAW_WEBHOOK",
  "orderId": "473130522693193728",
  "userId": "455472",
  "clientId": "W658784738723",
  "network": "POL",
  "address": "0x9876543210fedcba9876543210fedcba98765432",
  "crypto": "USDT",
  "amount": "11.5",
  "txHash": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
  "status": "succeeded",
  "timestamp": "1735280590000"
}
```

## Respuesta requerida

Devuelve un estado HTTP `2xx` (por ejemplo `200`) con el siguiente cuerpo JSON para confirmar la recepción:

```json Your response theme={null}
{
  "callbackStatus": "SUCCESS"
}
```

> [!NOTE]
>
> El mismo evento puede llegar más de una vez, así que elimina duplicados usando `orderId`. Consulta [Entrega y reintentos](https://docs.velafi.com/es/api-reference/webhooks/webhook-setup.md#delivery-and-retries).


## Related topics

- [Evento de retiro cripto](https://docs.velafi.com/es/api-reference/webhooks/crypto-withdraw-message-push.md)
- [Crear una orden de on-ramp](https://docs.velafi.com/es/api-reference/order/create-a-fiat-to-crypto-order.md)
- [Confirmar una orden](https://docs.velafi.com/es/api-reference/order/confirm-a-specific-order.md)
- [Registro de cambios](https://docs.velafi.com/es/docs/changelog.md)
- [Webhooks](https://docs.velafi.com/es/docs/guides/webhooks.md)


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