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.

mupag / support

How can we help?

Quick answers, AI and our team.

Frequently asked questions

How do I start integrating?

Follow the quickstart, configure the QA environment and create your first test charge.

Read documentation
My PIX payment is pending. What now?

Confirmation is asynchronous. Check the charge status and webhook events before fulfilling the order.

Read documentation
How do I receive payment notifications?

Register a webhook endpoint, verify its signature and handle duplicate events safely.

Read documentation
How do subscriptions work?

Read the subscriptions guide to configure recurring billing and follow the charge lifecycle.

Read documentation
Where can I find authentication help?

See how to use environment credentials in the documentation. Never share your key in chat.

Read documentation