Pular para o conteúdo principal

Autenticação

MuPag separa claramente credenciais públicas e credenciais de servidor.

sk_* para operações autenticadas​

Use Authorization: Bearer sk_test_... em QA. Chaves sk_prd_... e o ambiente prd ainda não estão disponíveis; não os simule nem os configure. Chaves secretas pertencem ao backend, jobs e workers.

Tokenização de cartão fora do checkout hospedado​

No fluxo B2B direto, o lojista obtém o token do cartão no Asaas, fora da MuPag, e envia somente esse token ao backend autenticado da MuPag. A credencial usada na tokenização nunca substitui a sk_*.

No checkout hospedado, a sessão pode oferecer cartão à vista pela fatura oficial do Asaas quando o lojista tem integração real disponível. O comprador abre o hosted_payment_url retornado pela sessão; os dados do cartão ficam na página do Asaas. Crie sessões com uma chave de servidor ou com a chave publishable limitada ao escopo checkout_sessions.create, conforme o guia de checkout. Nunca exponha a chave secreta no navegador.

Regras operacionais​

  • Nunca envie sk_* do navegador.
  • Nunca grave chave em URL, query string ou screenshot.
  • Em POST, envie também Idempotency-Key.
  • Se houver rotação de segredo, aceite uma pequena janela de sobreposição no backend e zere caches antigos.

Esta página liberou seu próximo passo?

O feedback permanece no fluxo da documentação e nunca deve incluir dados de clientes ou cartões.

mupag / suporte

Como podemos ajudar?

Respostas rápidas, IA e nossa equipe.

Perguntas frequentes

Como começar a integrar?

Siga o início rápido, configure o ambiente de QA e faça sua primeira cobrança de teste.

Ler documentação
Meu PIX ainda está pendente. E agora?

A confirmação é assíncrona. Confira o status da cobrança e os eventos de webhook antes de liberar o pedido.

Ler documentação
Como receber notificações de pagamento?

Cadastre um endpoint de webhook, valide a assinatura e processe eventos repetidos com segurança.

Ler documentação
Como funcionam as assinaturas?

Consulte o guia de assinaturas para configurar recorrência e acompanhar o ciclo das cobranças.

Ler documentação
Onde encontro ajuda com autenticação?

Veja como usar as credenciais do ambiente na documentação. Nunca compartilhe sua chave no chat.

Ler documentação