---
title: "POST /api/v4.0/integrations/coupons/burn"
method: POST
path: "/api/v4.0/integrations/coupons/burn"
---

# POST /api/v4.0/integrations/coupons/burn

`POST /api/v4.0/integrations/coupons/burn`

This API processes the use of one or more coupons associated with a customer in Gameball. By providing customer details and a list of coupons, this endpoint marks the coupons as redeemed, completing the transaction. Optionally, a lockReference can be included to burn previously locked coupons.

## Request body

- object
  - `customerId` string, required
  - `email` string
  - `mobile` string
  - `transactionId` string — A unique identifier for the transaction in your system (e.g., order number or invoice number). This ID can be used to reverse, cancel, or refund any coupon burn transactions in Gameball.
  - `transactionTime` string, date-time — The time of the transaction in your system (e.g., order datetime, invoice datetime). Must be in UTC (ISO 8601 format).
  - `coupons` string[] — List of coupons that need to be burned. Only one of coupons or lockReference must be provided.
  - `lockReference` string — Reference used to burn the locked coupons from the validation step. Only one of coupons or lockReference must be provided.

## Response `200`

Coupon burned successfully

- object
  - `success` boolean
  - `burnedAt` string, date-time

---

[API](https://skmtc.net/gameballers/apis/gameball-api.md) · [All operations](https://skmtc.net/gameballers/apis/gameball-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gameballers/gameball-api/revisions/3b11e1670d61/schema)