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.
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 si estás suscrito a él.Headers de la solicitud
Campos del payload
string
El ID del webhook para el que se encoló el evento.
string
Siempre
ON_RAMP_WITHDRAW_WEBHOOK para este tipo de evento.string
ID de la orden de on-ramp.
string
El ID de tu cuenta (usuario) de VelaFi.
string
El identificador de orden que proporcionaste como cliente. Se omite si no proporcionaste uno.
string
Red del retiro, tal como se configuró en la orden.
string
Dirección de la billetera de destino, tal como se configuró en la orden.
string
Criptomoneda de la orden, por ejemplo
USDT.string
Monto cripto de la orden (el mismo valor que
cryptoAmount en ORDER_WEBHOOK).string
Hash de la transacción on-chain del retiro. Se omite si no está disponible.
string
Siempre
succeeded. Los retiros fallidos no disparan este webhook.string
Marca de tiempo Unix (milisegundos) en la que se firmó este intento de entrega.
Payload de ejemplo
Incoming POST body
Respuesta requerida
Devuelve un estado HTTP2xx (por ejemplo 200) con el siguiente cuerpo JSON para confirmar la recepción:
Your response
El mismo evento puede llegar más de una vez, así que elimina duplicados usando
orderId. Consulta Entrega y reintentos.