Get All Requests

Retrieve details of a specific transaction using your reference ID (track_id). This endpoint returns the complete transaction object with current status.

Important considerations This endpoint returns all customer transactions

made within a maximum of three days.

Request

Method: GET

Query Parameters:

track_id (required): Transaction reference

cURL Request

curl -X GET \
  "https://sandbox.peexit.com/api/v1/disbursement/all_requests?track_id=xxxxxxxxxxx" \
  -H 'SECRETKEY: ########-####-####-####-############' \
  -H 'Content-Type: application/json'

Response

Status 200 - Success

Returns an array containing the payment requests for the client.

id: Request ID
track_id: partner transaction reference
amount: Amount requested
type: Type of request (e.g., "mobile")
status: Status of the request
created_at: Creation date
... (other fields as per your API)

Success Response

  [
    {
      "id": 195405,
      "amount": 1,
      "status": "new",
      "currency": "XAF",
      "payment_proof": "",
      "identifier_by": "690000002",
      "track_id": "fess-TEST006",
      "message": "",
      "type": "mobile",
      "payment_proof_image": "/images/missing.png"
    }
  ]

Error Handling

Status 401 - Unauthorized
Invalid or missing secret key.

Status 404 - Not Found Error Transaction initiated more than 3 days ago.

Authentication error response

{
  "error": {
    "statusCode": 401,
    "name": "UnauthorizedError",
    "message": "The key provided doest not exists in our system"
  }
}

Transaction initiated more than 3 days ago

{
  "error": {
    "statusCode": 404,
    "name": "NotFoundError",
    "message": "Transactions not found on your listing! (3 days)"
  }
}