Pular para o conteúdo principal

SDKs e ferramentas

As coordenadas abaixo apontam para versões públicas e imutáveis. Cada uma foi confirmada no respectivo registry e validada por instalação ou resolução limpa antes de ser anunciada aqui.

Coordenadas MuPag​

EcossistemaCoordenada públicaEstado
Node.js/TypeScriptmupag-sdk@0.2.0Publicado no npm e validado por instalação limpa
Pythonmupag-sdk==0.2.0Publicado no PyPI e validado por instalação limpa
Compatibilidade Pythonmupay-sdk==0.2.0Bridge legado publicado; instala mupag-sdk==0.2.0 e emite DeprecationWarning
Java corebr.com.mupag:mupag-sdk:0.2.0Publicado no Maven Central e validado por resolução limpa
Java Spring Bootbr.com.mupag:mupag-sdk-spring-boot-starter:0.2.0Publicado no Maven Central e validado por resolução limpa
Compatibilidade Java corebr.com.mupay:mupay-sdk:0.2.0POM legado publicado; redireciona para br.com.mupag:mupag-sdk:0.2.0
Compatibilidade Java Spring Bootbr.com.mupay:mupay-sdk-spring-boot-starter:0.2.0POM legado publicado; redireciona para br.com.mupag:mupag-sdk-spring-boot-starter:0.2.0
Gogithub.com/mupaybr/mupag-sdk-go@v0.2.0Publicado no Go proxy e no pkg.go.dev
PHPmupag/mupag-sdk:^0.2.0Publicado no Packagist a partir do repositório dedicado
Widget@mupag/widget@0.1.1Publicado no npm; bundles versionados disponíveis no unpkg e jsDelivr

O servidor MCP @mupag/mcp-server@0.1.0 e seus canais de descoberta estão descritos em Integração com IA.

Cobrança PIX com seu SDK​

Escolha sua linguagem e chame mupag.charges.create ou o método equivalente do seu SDK:

Instalaçãonpm install mupag-sdk@0.2.0
import { MuPag } from 'mupag-sdk';

const mupag = new MuPag({
apiKey: process.env.MUPAG_API_KEY,
env: 'test',
});

const charge = await mupag.charges.create({
amount_cents: 1290,
payment_method: 'pix',
customer: {
name: 'Ana Silva',
email: 'ana@example.com',
tax_id: '12345678909',
},
}, { idempotencyKey: 'order_123_charge_1' });

console.log(charge.charge_id);

A chave secreta fica no backend. O SDK gera Idempotency-Key; para retries distribuídos, forneça e persista uma chave estável para a mesma intenção.

Artefatos e fontes públicas​

  • OpenAPI pública para geração e validação
  • Coleção Postman publicada neste portal, limitada ao OpenAPI público e sem segredos preenchidos
  • Arquivos llms.txt e llms-full.txt para ferramentas de IA
  • Código, testes, exemplos e releases dos SDKs Go e PHP nos repositórios públicos dedicados

As demais fontes e trackers continuam internos. Os metadados públicos apontam para esta documentação, e o POM Java mantém o SCM privado permitido pelo Maven Central usando o portal público como URL do projeto.

Quando citar um pacote​

Use sempre a coordenada e a versão mostradas nesta página. Não substitua versões fixas por latest em produção ou em configurações de agentes.

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