Quickstart em 5 minutos

Este caminho prova três coisas rapidamente: seu backend sabe enviar sk_test_... com segurança, o host de QA responde e o webhook consegue fechar o ciclo.

1. Crie a primeira charge autenticada no backend

Escolha sua linguagem, instale o SDK e configure MUPAG_API_KEY com sua chave sk_test_... no ambiente do servidor. O exemplo cria uma cobrança PIX de R$ 12,90.

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);

2. Mantenha a chave secreta no servidor

MétodoPOST

Path/v1/charges

Credenciaisserver only

Corpo da requisição

{
  "amount_cents": 1290,
  "payment_method": "pix",
  "customer": {
    "name": "Ana Silva",
    "email": "ana@example.com",
    "tax_id": "12345678909"
  }
}

Configurar autenticação no backendAbrir início rápido completo

Chaves secretas ficam no backend

O portal não executa mutações financeiras nem solicita sua chave. Copie um exemplo e faça a chamada autenticada a partir do seu servidor.

3. Reutilize a chave para o mesmo pagamento

Substitua order_123_charge_1 por um ID imutável da sua operação de pagamento. Persista-o antes de chamar o SDK. Repetições da mesma operação devem usar a mesma chave e payload; um novo pagamento exige uma nova chave.

O SDK cuida da autenticação, serialização e retries internos. Guarde o charge_id retornado para acompanhar a cobrança. Consulte SDKs e ferramentas e Idempotência.

4. Feche o ciclo

• Aponte seu recebedor para os eventos descritos em Webhooks.
• Confirme no dashboard de QA que a charge e o customer chegaram com os mesmos IDs do seu sistema.
• Guarde charge_id, request_id e sua chave idempotente nos logs da aplicação.