Deriv API
Documentación
Agente de Pago

Withdrawal Status

GetRequiere autenticación

Returns the current status of a withdrawal previously submitted with a request_id. Both the client who initiated the withdrawal and the payment agent can query this endpoint. The status progresses from pending to complete, rejected, or failed. A request_id that doesn't match any of your withdrawals returns 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 Withdrawal Status

El endpoint GET /payment-agents/v1/withdraw/{request_id}: Returns the current status of a withdrawal previously submitted with a request_id. Both the client who initiated the withdrawal and the payment agent can query this endpoint. The status progresses from pending to complete, rejected, or failed. A request_id that doesn't match any of your withdrawals returns RequestIDNotFound.

¿Alguna otra pregunta? Póngase en contacto

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