Pular para o conteúdo principal
A API MingoPay permite criar cobranças Pix, consultar o estado de pagamentos e acompanhar o saldo da sua organização. Devoluções dependem do provedor; a integração atual do provedor de pagamentos não oferece devolução Pix pela API.

Escolha seu ponto de partida

llms.txt para IA e no-code

Abra o índice oficial com o prompt pronto, as rotas públicas e as regras de segurança da integração.

URL base

Todas as rotas públicas usam /v1, JSON e autenticação Bearer. Valores monetários são enviados como inteiros em centavos.
Nunca exponha chaves mp_test_, mp_live_ ou segredos whsec_ no navegador. Faça chamadas à API somente no seu servidor.

Fluxo recomendado

1

Crie uma chave de sandbox

No dashboard, gere uma chave mp_test_ com apenas os escopos necessários.
2

Crie a cobrança

Envie POST /v1/payment-intents com uma Idempotency-Key única para a tentativa.
3

Exiba o Pix

Mostre pix.copyPasteCode ao pagador. A resposta inicial ainda não confirma o pagamento.
4

Confirme pelo webhook

Valide X-MingoPay-Signature, deduplique o evento e libere o pedido somente após payment_intent.paid.