Reserve
Reserves a coupon code from a coupon batch (couponBatchId) for a specific transaction.
Picks an available code from the batch, computes the discount based on the batch
configuration (fixed or percent over total_item), and reserves the redemption against
the transaction (transactionId is the confirmToken).
Use Coupon search first to find a compatible batch for the cart, then call
this endpoint with the chosen couponBatchId. Settle the coupon with Coupon settlement
after the order is placed.
Monetary fields (total_item) are sent as integer cents —
see Monetary values.
Try-it values populated from environment ACME (Demo)
Authentication
Token
Send your user token in the x-guper-authorization header. Endpoints that
support a Public mode (e.g. acúmulo and resgate previews) accept the same
request without the header — Private mode adds customer data and a
confirmation token to the response.
Headers
Path parameters
Request body
Content-Type:
application/json