Documentación
Agente de Pago

Estado del retiro

GetRequiere autenticación

Devuelve el estado actual de un retiro previamente enviado con un request_id. Tanto el cliente que inició el retiro como el agente de pago pueden consultar este endpoint. El estado avanza de pendiente a completado, rechazado o fallido. Un request_id que no coincida con ninguno de sus retiros devuelve RequestIDNotFound.

Endpoint

Get/payment-agents/v1/withdraw/{request_id}

URL Base: https://api.derivws.com

Códigos de Estado

200OK - Current status of the requested withdrawal.
400Bad request - One of: InvalidRequestIDFormat (request_id does not match the required format), RequestIDNotFound (request_id does not match any of your withdrawals).
401Unauthorized - Invalid or missing authentication.
403Forbidden - Valid token but insufficient scope (payment scope required).
500Internal server error - errors[0].code will be InternalError.
504Gateway timeout - Upstream service unavailable.

Respuestas de Error

400Bad request - request_id not found
{
  "data": {},
  "errors": [
    {
      "status": 400,
      "code": "RequestIDNotFound",
      "detail": { "message": "No withdrawal found for the given request_id" }
    }
  ],
  "metadata": {
    "endpoint": "/payment-agents/v1/withdraw/unknown-id",
    "method": "GET",
    "timing": 8
  }
}

Acerca de Estado del retiro

El endpoint GET /payment-agents/v1/withdraw/{request_id}: Devuelve el estado actual de un retiro previamente enviado con un request_id. Tanto el cliente que inició el retiro como el agente de pago pueden consultar este endpoint. El estado avanza de pendiente a completado, rechazado o fallido. Un request_id que no coincida con ninguno de sus retiros devuelve RequestIDNotFound.

¿Alguna otra pregunta? Póngase en contacto

Click to open live chat support. Get instant help from our support team.