Get Brand Wallet Transaction History

GET/payment-option/wallet/customer/{customer_id}/history

Retrieves wallet transaction history for a customer with optional filters by date range, page, and transaction type.

View as Markdown Open in ChatGPT Open in Claude Open in Perplexity

Requires Bearer token. Get token →

Path Parameters

Field	Details
`customer_id` `string`required	Unique customer identifier (e.g. cust-v1-...).

Header Parameters

Field	Details
`Request-Timestamp` `string`date-time	ISO 8601 UTC timestamp of the request. Used for idempotency and audit.
`Request-ID` `string`	Use a global unique identifier [GUID] for the request. Constraints Minimum length: 1 characterMaximum length: 50 characters

Query Parameters

Field	Details
`start_date` `string`required	Start date for the history range.
`end_date` `string`required	End date for the history range.
`page` `integer`	Page number for pagination (defaults to 1). Constraints Minimum value: 1Default value: 1
`transaction_type` `string[]`	Filter by transaction type(s). Can be repeated for multiple types.

Response

Field	Details
`data` `object`1 nested field
`transactions` `BrandWalletTransactionHistory[]`11 nested fields

Status Codes

`200`	Transaction history retrieved.
`400`	The request was malformed or missing required fields.
`401`	Authentication failed — missing, expired, or invalid Bearer token.
`500`	An unexpected error occurred on the server.

Run

Request

curl --request GET \
  --url 'https://pluraluat.v2.pinepg.in/payment-option/wallet/customer/cust-bw-001/history?start_date=2026-01-01&end_date=2026-01-31' \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  --header 'Request-ID: a1b2c3d4-e5f6-7890-abcd-ef1234567890' \
  --header 'Request-Timestamp: 2024-10-01T10:30:00Z'

Status:

{
  "data": {
    "transactions": [
      {
        "transaction_date_time": "2026-06-01T14:30:00Z",
        "outlet_name": "Store A",
        "transaction_type": "CREDIT",
        "transaction_amount": 500,
        "currency_code": "INR",
        "account_balance": 1500,
        "merchant_name": "Brand Store",
        "reason": "Wallet load",
        "transaction_id": 123456,
        "response_message": "Success",
        "transaction_status": "COMPLETED"
      }
    ]
  }
}