Skip to main content

Overview

MuPag publishes only the approved merchant-facing contract here. Everything in the portal should match docs/openapi/public-v1.yaml and the workflows that already exist in the dashboard.

Official hosts​

SurfaceURL
Portalhttps://docs.mupag.com.br
QA APIhttps://api.sandbox.mupag.com.br
Reserved production APIhttps://api.mupag.com.br — unavailable; do not use
QA dashboardhttps://qa.dashboard.mupag.com.br/app
  1. Create a restricted QA key and keep it only on your server.
  2. Make the first call with Authorization: Bearer sk_test_....
  3. Enable idempotency on every mutable operation.
  4. Verify webhook signatures before treating any payment as final.
  5. Do not switch to api.mupag.com.br: the prd environment does not exist yet and will be planned separately.

Current public scope​

  • Charges for PIX and card flows
  • Customers and catalog
  • Checkout sessions
  • Subscriptions
  • Webhooks
  • OpenAPI, raw HTTP examples and AI-readable files

Affiliates, splits, balances and payouts stay documented as dashboard-managed workflows until a public API contract is approved.

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