Customer Histories

Get a transaction history for a specific customer.

Endpoint Information

Name: Get Customer Histories
Method: GET
URL: {{base_url}}/api/v1/customer/histories

Authentication

Type: Basic Auth

• Username: App Key
• Password: Secret Key

Query Parameters

Parameter	Type	Required	Default	Description
merchantAccountId	string	Yes	-	Your merchant account ID
customerEmail	string	No	-	Filter history by customer email
perPage	integer	No	20	Items per page
page	integer	No	1	Page number

Example Request

GET {{base_url}}/api/v1/customer/histories?merchantAccountId=100001&[email protected]&perPage=20&page=1

Response

Success Response

{
  "success": true,
  "message": "Customer histories retrieved successfully",
  "data": [
    {
      "reference_id": "B01E9POMTO",
      "amount": 40,
      "currency_code": "USD",
      "transaction_status": "Accepted",
      "customer_email": "[email protected]",
      "created_at": "2025-12-03 08:26:14"
      // ...other fields
    }
  ],
  "pagination": {
    "current_page": 1,
    "last_page": 4,
    "total": 71
  }
}

Usage

Use this to display a "My Transactions" or "Order History" section in your customer portal.