Guia Prático MAG Finanças

Guia Prático MAG Finanças

Guia Prático MAG Finanças

A MAG Finanças disponibiliza APIs para empresas automatizarem cobranças e recebimentos via Pix de forma simples, rastreável e escalável. Neste guia apresentamos os dois principais produtos: Pix Cobrança e Pix Automático.

◆

PIX COBRANÇA

Gere cobranças Pix imediatas ou com vencimento, acompanhe status e realize conciliação automática.

↻

PIX AUTOMÁTICO

Pagamentos recorrentes com autorização do pagador e execução automatizada via API.

▦

ACESSAR AS APIs

Cadastre-se no Portal MAG, crie seu App/Client e obtenha suas credenciais.

Nossos Produtos

1) Pix Cobrança

Ideal para cobrar por Pix com pagamento imediato ou com vencimento, com controle de status e conciliação de recebimentos.

O que dá para automatizar:

  • Criar cobrança imediata
  • Criar cobrança com vencimento
  • Consultar cobrança individual
  • Listar cobranças
  • Configurar webhook para eventos de pagamento
  • Consultar Pix recebidos
  • Tratar devoluções quando aplicável
Vantagens principais: flexibilidade (imediata ou vencimento), rastreabilidade por identificadores como txid e conciliação via notificações automáticas (webhook).

2) Pix Automático

Ideal para cobranças recorrentes. Permite ciclo completo de recorrência com acompanhamento de eventos via API.

Com um único contrato, a empresa pode cobrar clientes de qualquer instituição com conta transacional, sem necessidade de convênios bilaterais.

O que dá para automatizar:

  • Criar e gerenciar recorrências (planos/assinaturas)
  • Configurar webhook de autorizações
  • Configurar webhook de cobranças recorrentes
  • Acompanhar status e eventos (confirmações, liquidações)
  • Conciliação automática por notificações

Como acessar as APIs no Portal MAG

  1. Cadastre-se no Portal e faça login.
  2. Acesse o menu APIs e localize a API Pix.
  3. Crie seu App/Client para obter credenciais.
  4. Siga o fluxo de autenticação conforme documentação.
  5. Comece pelo ambiente Sandbox/Homologação.
  6. Valide webhooks e conciliação.
  7. Após validação, publique em Produção.

APIs no Ciclo de Cobrança MAG Finanças

Ciclo Pix Cobrança

Inicia na criação da cobrança e termina na confirmação do Pix recebido (ou devolução, quando aplicável).

  1. Criar cobrança imediata (ex.: POST /cob/{txid})
  2. Consultar cobrança (GET /cob/{txid})
  3. Listar cobranças (GET /cob)
  4. Criar cobrança com vencimento (POST /cobv/{txid})
  5. Configurar webhook por chave
  6. Conciliação e devolução quando necessário

Ciclo Pix Automático

Inicia na criação da recorrência e permanece ativo enquanto houver cobranças recorrentes.

  1. Criar recorrência (POST /rec)
  2. Configurar webhook de recorrências (POST /webhookrec)
  3. Configurar webhook de cobranças recorrentes (POST /webhookcobr)
  4. Acompanhar status e eventos continuamente
  5. Conciliação automática via notificações

Boas Práticas Mínimas

  • Configure webhooks desde o início.
  • Utilize txid para rastreabilidade.
  • Implemente idempotência nas chamadas.
  • Implemente retentativas e tratamento de erros.
  • Valide escopo e permissões no onboarding.

Pronto para integrar?

Cadastre sua conta, crie seus Apps, conheça o ambiente Sandbox e integre sua empresa aos Serviços de Integração MAG Finanças.

INTEGRE COM A MAG FINANÇAS