Withdrawal Status

Returns the current status of a withdrawal previously submitted with a request_id. Use this to poll a withdrawal through its lifecycle — requested, then pending — until it reaches complete, rejected, or failed (transaction_id is null while the status is requested). A request_id that doesn't match any of your withdrawals returns RequestIDNotFound.

Endpoint

Status Codes

Error Responses

{
  "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
  }
}

About Withdrawal Status

The GET /payment-agents/v1/withdraw/{request_id} endpoint: Returns the current status of a withdrawal previously submitted with a request_id. Use this to poll a withdrawal through its lifecycle — requested, then pending — until it reaches complete, rejected, or failed (transaction_id is null while the status is requested). A request_id that doesn't match any of your withdrawals returns RequestIDNotFound.