Skip to main content
POST
/
api
/
v4.0
/
integrations
/
batch
/
redeem
cURL
curl --request POST \
  --url https://api.gameball.co/api/v4.0/integrations/batch/redeem \
  --header 'Content-Type: application/json' \
  --header 'apikey: <api-key>' \
  --data '
{
  "body": [
    {
      "customerId": "<string>",
      "transactionId": "<string>",
      "transactionTime": "2023-11-07T05:31:56Z",
      "email": "<string>",
      "mobile": "<string>",
      "amount": 123,
      "points": 123,
      "holdReference": "<string>"
    }
  ]
}
'
{
  "jobId": 123
}

​
Redeem Batch Job

The Batch Redeem API enables customers to redeem loyalty points as a payment method in Gameball, allowing them to use points instead of monetary value during transactions. This API supports bulk redemptions, making it efficient for handling multiple customer transactions in a single request.
Security: Requires apiKey and secretKey headers.
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.

Authorizations

​
apikey
string
header
required

Body

application/json
​
body
object[]

Response

200 - application/json

Batch redemption processing initiated successfully

​
jobId
number

The assigned job ID, which is later used for status verification and response retrieval.