Checkout

Sessões de checkout separam a criação autenticada pelo lojista das chamadas públicas do comprador. O checkout hospedado atual aceita somente PIX; cartão existe apenas na API B2B direta.

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 aplicar cupom e pagar via PIX.
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, restrito a ["pix"]
• affiliate_code e coupon_id quando aplicável

Use checkout quando você quer uma experiência PIX orientada a carrinho, identidade visual e itens detalhados. Tentativas de selecionar ou pagar com cartão são rejeitadas.