Cobranças

Cobranças são a base do PIX e do cartão B2B direto autenticado pelo lojista. O checkout hospedado público é PIX-only.

Endpoint principal

POST /v1/charges cria uma cobrança PIX ou cartão B2B direto. O corpo usa amount_cents, payment_method e um objeto customer com nome, email e CPF/CNPJ; se houver id, os mesmos dados continuam obrigatórios.

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

Resposta esperada

Para PIX você recebe charge_id, status, pix_emv_code, pix_qr_code_base64 e expires_at. Cartão aceita somente token Asaas obtido pelo lojista, exige payer_ip literal atestado, opera em 1x e acompanha o estado final por webhook/consulta. soft_descriptor é rejeitado e política que exige 3DS falha antes de efeitos.

Operação segura

• Gere Idempotency-Key por tentativa lógica.
• Use o mesmo customer.id quando o comprador já existe, sempre com nome, email e CPF/CNPJ inline.
• Não finalize entrega ou acesso só com a resposta síncrona; espere o evento apropriado.