Conceitos e ambientes
Entenda cobrança, status, chaves e diferenças entre sandbox e produção.
Cobrança PIX
Uma payment intent representa uma tentativa de receber via PIX. Ela possui UUID da MingoPay, referência externa opcional, valor em centavos, status e datas. A criação também retorna pix.copyPasteCode e pix.expiresAt.
Os estados possíveis são created, pending, processing, paid, failed, cancelled, partially_refunded e refunded. Trate paid como confirmação de recebimento e refunded como devolução concluída.
Sandbox e produção
Chaves mp_test_ operam no sandbox; chaves mp_live_ operam em produção. O caminho /v1 é o mesmo, mas a chave determina o ambiente da cobrança. Webhooks são cadastrados separadamente por ambiente.
Sandbox simula estado e saldo, sem movimentar dinheiro real. Produção exige organização ativa e provedor efetivamente configurado.
IDs e conciliação
externalReference é uma referência sua, de até 100 caracteres. O id retornado pela MingoPay é o UUID usado para consultas. Guarde ambos junto ao estado recebido por webhook.