Skip to main content

Coupons

Coupons are used in checkout and subscription flows whenever the discount must remain explicit and auditable.

Routes

  • POST /v1/coupons
  • GET /v1/coupons
  • GET /v1/coupons/{id}
  • PATCH /v1/coupons/{id}
  • POST /v1/coupons/{id}/disable
  • POST /v1/coupons/validate

Operation

Validate the coupon before showing the final total to the buyer. For auditability, persist coupon_id, the submitted code and the final discount in cents.

Did this page unblock the next step?

Feedback stays inside the docs flow and should never include customer or card data.