Documentação
Agente de Pagamento

Estado da Transferência

GetAutenticação necessária

Devolve o estado atual de uma transferência iniciada anteriormente com um request_id. Tanto o agente de pagamento que enviou a transferência como o cliente destinatário a podem consultar. A maioria das transferências devolve complete na resposta inicial e não necessita de polling; se o estado inicial for pending, este evolui para complete, rejected ou failed. Um request_id que não corresponda a nenhuma das suas transferências devolve 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 Estado da Transferência

O endpoint GET /payment-agents/v1/transfer/{request_id}: Devolve o estado atual de uma transferência iniciada anteriormente com um request_id. Tanto o agente de pagamento que enviou a transferência como o cliente destinatário a podem consultar. A maioria das transferências devolve complete na resposta inicial e não necessita de polling; se o estado inicial for pending, este evolui para complete, rejected ou failed. Um request_id que não corresponda a nenhuma das suas transferências devolve RequestIDNotFound.

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