Skip to main content

Plans

Plans belong to products and define billing cadence, amount and subscription timing.

Routes​

  • POST /v1/products/{productId}/plans
  • GET /v1/products/{productId}/plans
  • GET /v1/plans/{id}
  • PATCH /v1/plans/{id}
  • POST /v1/plans/{id}/archive

Key fields​

  • amount_cents
  • billing_period_unit
  • billing_period_interval
  • trial_days
  • setup_fee_cents

Archiving a plan blocks new signups but does not cancel active subscriptions automatically.

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