Add Manual Transaction
Add manual point adjustments to customer accounts.
POST
cURL
Add Manual Transaction
This API allows for the manual addition or deduction of points for a customer in Gameball. It provides flexibility in managing loyalty points, enabling adjustments based on specific needs or circumstances. This endpoint is also available onv4.1.
Channel Merging Available
If your system uses different customer IDs across multiple channels (e.g., online and offline), Gameball’s channel merging feature helps unify customer profiles. By including the customer’s mobile number or email (based on your merging configuration) with each request, Gameball will combine activities into a single profile.
Security: Provide both
apikey and secretkey headers.Custom Points Expiry
UseexpiryAfter to set a custom expiry period for points added through a manual transaction. The value is the number of days after which the added points expire, counted from the time the points are credited. For example, 30 means the awarded points expire 30 days from the time of the addition.
When expiryAfter is omitted, sent as null, or sent as 0, the points follow the client’s default points-expiry setting configured in the dashboard. This matches the custom expiry option available when manually adding points from the Gameball dashboard.
Validation
Example: Add Points With Custom Expiry
500 points that expire 30 days from the time of the addition.
Example: Use the Client Default Expiry
expiryAfter is omitted, so the credited points follow the client’s default points-expiry configuration.Body
application/json
The number of days after which the points added in this transaction will expire, counted from the time of the addition. For example, 30 means the awarded points expire 30 days from now. When omitted, null, or 0, the points follow the client's default points-expiry setting configured in the dashboard. This replicates the custom-expiry option available when manually adding points from the Gameball dashboard. expiryAfter applies only to point additions; it cannot be used when deducting points.
Required range:
x >= 0Example:
30
Response
Manual transaction added successfully