Wallet Transaction Status API

The Wallet Transaction Status API allows you to fetch the status of a specific wallet 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/v1/live/payout/{id}/status

Example:

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

Request Parameters

Parameter	Type	Required	Description
`id`	String	Yes	The `transaction_id` or `order_id` to identify the transaction.

Headers

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

Success Response

If the request is successful and the transaction is found, the API returns a formatted response with transaction details.

{
  "status": "SUCCESS",
  "message": "Transaction processed successfully!",
  "data": {
    "amount": "500",
    "currency": "USD",
    "order_id": "ORD-123456",
    "transaction_id": "TXN-654321",
    "customer": {
      "first_name": "Alice",
      "last_name": "Smith",
      "email": "alice@example.com"
    }
  }
}

Failed Response

{
  "message": "Authentication Secret Key is missing."
}

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