1. Gere uma API key
No painel Master, abra Integrações → Keys, escolha um nome e marque as permissões Leitura e Cobranças. Copie a chave exibida uma única vez. Guarde-a em uma variável de ambiente do seu servidor, nunca no código do navegador.2. Consulte a conta
operationId, enabled, balanceCents, feeCents, cardFeeCents, minimumCardCents, maximumCardCents, minimumDepositCents, maximumDepositCents, minimumWithdrawalCents (1000), maximumWithdrawalCents (1000000) e reservedWithdrawalCents. O saldo disponível exclui saques reservados, retenções administrativas e a margem da Master. Um saldo pode estar momentaneamente desatualizado até a reconciliação do provedor. Sem X-Master-Operation, todas as chamadas usam a principal; para outro negócio, envie esse header com seu ID nas consultas e escritas. Consulte operações de negócio.
3. Crie uma cobrança Pix
Crie um UUID e preserve o mesmorequestKey em qualquer repetição da mesma cobrança.
amountCents: 10000 corresponde a R$ 100,00. A operação pode retornar pending, com copyPaste e qrCodeBase64, ou unknown se a resposta do provedor ainda precisar ser reconciliada. Não crie outra cobrança com um novo UUID quando o resultado for incerto. Consulte o mesmo ID ou repita a solicitação com o mesmo requestKey.
4. Acompanhe o status
paid confirma uma cobrança. Não existe chamada para aprovar o Pix manualmente. Após 5 segundos sem webhook, a Master agenda a consulta de status na liquidante. Para cartão, consulte cartão de crédito: aprovação e disponibilidade do saldo são etapas distintas. Para notificações automáticas, configure um webhook. Seu servidor deve verificar a assinatura antes de processar cada evento.