> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mingopay.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Documentação MingoPay

> Integre cobranças Pix, acompanhe pagamentos e consulte operações com uma API segura.

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

| Objetivo | Guia |
| - | - |
| Criar uma cobrança no sandbox | [Primeira integração](https://docs.mingopay.com.br/documentation/quickstart.md) |
| Autenticar chamadas e testar rotas | [Chaves de API](https://docs.mingopay.com.br/documentation/authentication.md) |
| Confirmar pagamentos de forma assíncrona | [Webhooks](https://docs.mingopay.com.br/documentation/webhooks.md) |
| Integrar com IA ou ferramenta no-code | [Integração com IA e no-code](https://docs.mingopay.com.br/documentation/no-code.md) |

> [card] [llms.txt para IA e no-code](https://docs.mingopay.com.br/llms.txt)
>
> Abra o índice oficial com o prompt pronto, as rotas públicas e as regras de segurança da integração.

## URL base

```text theme={"system"}
https://api.mingopay.com.br
```

Todas as rotas públicas usam `/v1`, JSON e autenticação Bearer. Valores monetários são enviados como inteiros em centavos.

> [!WARNING]
>
> 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`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.