Documentación
Agente de Pago

Estado de la transferencia

GetRequiere autenticación

Devuelve el estado actual de una transferencia iniciada previamente con un request_id. Tanto el agente de pago que envió la transferencia como el cliente receptor pueden verificarlo. La mayoría de las transferencias devuelven el estado completo en la respuesta inicial y no requieren sondeo; si el estado inicial está pendiente, progresa a completo, rechazado o fallido. Un request_id que no coincide con ninguna de sus transferencias devuelve 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.

Respuestas de Error

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 de la transferencia

El endpoint GET /payment-agents/v1/transfer/{request_id}: Devuelve el estado actual de una transferencia iniciada previamente con un request_id. Tanto el agente de pago que envió la transferencia como el cliente receptor pueden verificarlo. La mayoría de las transferencias devuelven el estado completo en la respuesta inicial y no requieren sondeo; si el estado inicial está pendiente, progresa a completo, rechazado o fallido. Un request_id que no coincide con ninguna de sus transferencias devuelve RequestIDNotFound.

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