/member/payments

Overview

This endpoint retrieves a member's points or credit transaction history. It allows you to view historical payment activities including point additions, redemptions, and credit transactions.

When to Use This Endpoint

Use this endpoint in the following cases:

• To display a member's points or credit transaction history
• To show detailed transaction records for member account statements
• To audit or review historical payment activities
• To provide transparency on loyalty balance changes

Key Considerations

• The budgetType parameter determines whether to retrieve points or credit history
• Results can be filtered by date range using fromDate and toDate
• Pagination is supported through limit and offset parameters
• Default date range is not limited unless specified

Request Details

Method & URL

POST /member/payments

See API Servers for the base URL to use in place of {{server}}.

Headers

Header	Type	Required	Description
x-api-key	string	Yes	API key for authentication
x-source-type	string	Yes	Origin of the request (e.g., POS, Web)
x-source-name	string	Yes	Name of the client or integration system
x-pos-id	string	Yes	POS terminal identifier
x-branch-id	string	Yes	Branch or store location identifier

Request Body

Field	Type	Required	Default	Description
member	object	Yes	—	Member identifier (see Member reference)
budgetType	string	Yes	—	Type of budget: points or credit
limit	integer	No	40	Max number of records (1-100)
offset	integer	No	0	Number of records to skip for pagination (≥0)
fromDate	string	No	—	Filter start date (ISO 8601 format)
toDate	string	No	—	Filter end date (ISO 8601 format)

Request Example

curl --location --request POST 'https://{{server}}/v1/member/payments' \
--header 'Content-Type: application/json' \
--header 'x-api-key: {{api-key}}' \
--header 'x-source-type: POS' \
--header 'x-source-name: pos_terminal_01' \
--header 'x-pos-id: POS001' \
--header 'x-branch-id: BR001' \
--data-raw '{
  "member": {
    "membershipKey": "abc123"
  },
  "budgetType": "points",
  "limit": 20,
  "offset": 0,
  "fromDate": "2024-01-01T00:00:00Z",
  "toDate": "2024-12-31T23:59:59Z"
}'

Success Response

{
  "status": "success",
  "transactions": [
    {
      "transactionId": "confirmation-uuid-or-db-id",
      "createdAt": "2024-06-15T14:30:00.000Z",
      "operation": "AddPoints",
      "type": "Point",
      "amount": 105
    },
    {
      "transactionId": "conf-uuid-2",
      "createdAt": "2024-06-10T12:15:00.000Z",
      "operation": "RedeemPoints",
      "type": "Point",
      "amount": -50
    }
  ]
}

Response Fields

Field	Type	Description
status	string	Request status indicator
transactions	array	Array of transaction objects
transactionId	string	Unique identifier for the transaction
createdAt	string	ISO 8601 timestamp of the transaction
operation	string	Operation type: AddPoints, RedeemPoints, AddCredits, RedeemCredits
type	string	Budget type: Point or Credit
amount	number	Transaction amount (positive for add, negative for use)

Error Response Examples

Missing Required Header

{
  "status": "error",
  "error": {
    "code": "101",
    "message": "Missing X-Api-Key header"
  }
}

Member Not Found

{
  "status": "error",
  "error": {
    "code": "203",
    "message": "Member not found"
  }
}

Invalid Budget Type

{
  "status": "error",
  "error": {
    "code": "1001",
    "message": "Invalid or missing budgetType. Must be 'points' or 'credit'"
  }
}

Invalid Date Format

{
  "status": "error",
  "error": {
    "code": "1002",
    "message": "Invalid fromDate format. Use ISO 8601 format"
  }
}

Error Codes

Code	Description
101	Missing X-Api-Key header
102	Missing X-Source-Type header
103	Missing X-Source-Name header
104	Missing X-Pos-Id header
105	Missing X-Branch-Id header
203	Member not found
1001	Invalid or missing budgetType
1002	Invalid fromDate format
1003	Invalid toDate format
1011	Invalid limit (must be an integer between 1 and 100)
1012	Invalid offset (must be an integer of 0 or more)
1010	Internal server error

Related Use Cases

• Displaying member transaction history in a mobile app or web portal
• Generating account statements for members
• Auditing loyalty point or credit transactions
• Providing transparency on balance changes