Checkout

Sessões de checkout separam a criação autenticada pelo lojista das chamadas públicas do comprador.

Autenticação

Há dois modos seguros para criar uma sessão:

• Backend próprio: use uma chave secreta com o escopo checkout_sessions.create.
• Widget oficial MuPag: use uma chave publishable com o escopo checkout_sessions.create.

Nunca exponha uma chave secreta no navegador. A chave publishable só pode acessar operações explicitamente liberadas para uso no frontend.

Fluxo

1. Seu backend ou o widget oficial cria a sessão em POST /v1/checkout-sessions.
2. O frontend usa os endpoints públicos da sessão para escolher método, aplicar cupom e pagar.
3. O status final da venda chega por consulta da sessão e por webhook.

Campos chave

• success_url e cancel_url
• items
• customer_id ou customer_data
• allowed_payment_methods
• affiliate_code e coupon_id quando aplicável

Use checkout quando você quer uma experiência de cobrança orientada a carrinho, identidade visual e itens detalhados.