Deriv API
Documentação
Agente de Pagamento

Transfer Status

GetAutenticação necessária

Returns the current status of a transfer previously initiated with a request_id. Both the payment agent who sent the transfer and the receiving client can check it. Most transfers return complete in the initial response and don't need polling; if the initial status is pending, it progresses to complete, rejected, or failed. A request_id that doesn't match any of your transfers returns RequestIDNotFound.

Endpoint

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

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

Códigos de Estado

200OK - Current status of the requested transfer.
400Bad request - One of: InvalidRequestIDFormat, RequestIDNotFound.
401Unauthorized - Invalid or missing authentication.
403Forbidden - Valid token but insufficient scope (payment scope required).
500Internal server error (InternalError).
504Gateway timeout - Upstream service unavailable.

Respostas de Erro

400Bad request - request_id not found
{
  "data": {},
  "errors": [
    {
      "status": 400,
      "code": "RequestIDNotFound"
    }
  ],
  "metadata": {
    "endpoint": "/payment-agents/v1/transfer/my-request-id",
    "method": "GET",
    "timing": 0.019
  }
}

Acerca de Transfer Status

O endpoint GET /payment-agents/v1/transfer/{request_id}: Returns the current status of a transfer previously initiated with a request_id. Both the payment agent who sent the transfer and the receiving client can check it. Most transfers return complete in the initial response and don't need polling; if the initial status is pending, it progresses to complete, rejected, or failed. A request_id that doesn't match any of your transfers returns RequestIDNotFound.

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