Transfer Status

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

Status Codes

Error Responses

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

About Transfer Status

The GET /payment-agents/v1/transfer/{request_id} endpoint: 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.