Skip to main content
POST
/
api
/
v4.0
/
integrations
/
transactions
/
{transactionId}
/
activate
cURL
curl --request POST \
  --url https://api.gameball.co/api/v4.0/integrations/transactions/{transactionId}/activate \
  --header 'apikey: <api-key>'
{
  "pointsActivated": 50,
  "gameballTransactionId": 11035201,
  "clientTransactionId": "txn54321221"
}

​
Activate Transaction

This API is used to immediately activate loyalty points that are currently in a pending state, bypassing the configured return window duration. This endpoint overrides that duration and activates the points immediately, making them available for use by the customer without waiting for the pending return window duration to elapse. This API is especially useful for scenarios where the client determines that the order is confirmed and the points can be safely activated ahead of schedule.
Note: Once points are activated, the action cannot be reversed via this API.
Security: Provide both apikey and secretkey headers.

Authorizations

​
apikey
string
header
required

Path Parameters

​
transactionId
string
required

The transaction id on your system which you want to activate.

Response

200 - application/json

Transaction activated successfully

​
pointsActivated
number

Number of points that has been successfully activated by the transaction

Example:

50

​
gameballTransactionId
number

The unique identifier for the transaction within Gameball.

Example:

11035201

​
clientTransactionId
string

A unique identifier for a transaction in your system (e.g., order number or invoice number).

Example:

"txn54321221"