getUsedRewardPointRecords

Retrive all reward point subtraction transactions.

This API call is for building custom loyalty programs. For other related calls, see addCustomerRewardPoints (to add points to a customer manually) and getEarnedRewardPointRecords (to retrieve transactions where customers have earned reward points}.

For simpler integrations, you will more likely need getCustomerRewardPoints to retrieve a customer's point balance, and subtractCustomerRewardPoints to subtract points from customer.

To edit one specific record, use editUsedRewardPointRecord. (Under normal circumstances, you should not use that method; this is only for transfering points history from one customer to another, or for correcting errors in points history. To add or remove points, use subtractCustomerRewardPoints and addCustomerRewardPoints instead.)

Input parameters

Parameter name Description Possible value Required
customerID  Customer ID.  Integer    
customerIDs  Comma-separated list of customer IDs. Retrieve transactions associated with multiple customers.  String    
createdUnixTimeFrom    Unix timestamp    
createdUnixTimeTo    Unix timestamp    

Response

Field name Type Description
transactionID  Integer  Transaction ID.  
customerID  Integer  Customer ID.  
customerCardNumber  String  Code of customer's loyalty/membership card.  
invoiceID  Integer  Invoice ID.  
invoiceNo  String  Invoice number.  
campaignID  Integer    
warehouseID  Integer    
pointOfSaleID  Integer  Register ID.  
pointOfSaleName  String    
employeeID  Integer    
employeeName  String    
usedPoints  Integer    
createdUnixTime  Unix timestamp  Transaction timestamp.  
issuedCouponID  Integer  Available only if "Reward point extras" module is enabled on your account.  
description  String  Available only if "Reward point extras" module is enabled on your account.  

This API call returns error 1006 if "Reward points" module is not enabled on your account.