Status API

The Status API allows you to fetch the status of a specific transaction using either the `transaction_id` or `order_id`. This endpoint provides real-time information about the transaction, including its status, amount, currency, and customer details.

API Endpoint

GET https://backend.pay.agency/api/live/status/{id}

Example:

https://backend.pay.agency/api/live/status/PA01862809 (using transaction_id)
https://backend.pay.agency/api/live/status/order67890 (using order_id)

Request Parameters

Parameter	Type	Required	Description
`transaction_id`	String	Yes	The unique ID of the transaction to retrieve its status.
`order_id`	String	No	The order ID, if provided during the transaction.

Headers

Header Name	Description
`Content-Type`	Specifies the content type. Always set to `application/json`.
`Authorization`	Bearer token for authentication.

Success Response

If the request is successful and a valid transaction_id or order_id is provided, the API will return the following response:

{
  "status": "SUCCESS",
  "message": "Transaction processed successfully!.",
  "data": {
    "amount": "100",
    "currency": "INR",
    "order_id": null,
    "transaction_id": "PA7663692011084535",
    "customer": {
      "first_name": "Tushar",
      "last_name": "vashishth",
      "email": "test@gmail.com"
    },
    "refund": {
      "status": false,
      "refund_date": null
    },
    "chargeback": {
        "status": false,
        "chargeback_date": null
    }
  }
}

Failed Response

{
  "message": "Authentication token is missing."
}

{
  "message": "Invalid Secret Key."
}