> ## 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.

# Integração com IA e no-code

> Use a API em agentes e automações sem expor credenciais.

Use os arquivos preparados para agentes:

* [`/llms.txt`](https://docs.mingopay.com.br/llms.txt?v=1) com um prompt pronto e as regras essenciais da integração.
* `/llms-full.txt` com o conteúdo completo para contexto de agentes.
* Uma versão Markdown de cada página ao adicionar `.md` à URL.

## Ferramentas HTTP

Em n8n, Make, Zapier ou outra ferramenta com requisição HTTP, use:

```text theme={"system"}
Base URL: https://api.mingopay.com.br
Authorization: Bearer {{MINGOPAY_API_KEY}}
Content-Type: application/json
Idempotency-Key: pedido-{{ID_UNICO}}
```

Armazene `MINGOPAY_API_KEY` no cofre de credenciais da ferramenta. Não coloque a chave em campos públicos, prompts compartilhados ou automações executadas no navegador.

## Prompt de integração completa

```text theme={"system"}
Integre a MingoPay neste projeto. Leia primeiro:
https://docs.mingopay.com.br/llms.txt?v=1

Depois leia o contrato da API:
https://docs.mingopay.com.br/openapi.json

Siga integralmente o prompt pronto do llms.txt. Inspecione a stack existente,
implemente o fluxo no backend, mantenha credenciais fora do navegador, use
Idempotency-Key, valide o webhook assinado pelo corpo bruto, deduplique eventos
e crie testes no sandbox. Não marque uma cobrança como paga pela resposta de
criação. Liste no fim tudo que ainda depende de credenciais ou homologação.
```

> [!WARNING]
>
> Revise o fluxo gerado antes de usar produção. Uma automação não deve marcar a
> venda como paga pela resposta de criação da cobrança.

## Transferências pelo painel

No formulário principal, o valor informado inclui a tarifa: R$ 10,20 com tarifa de R$ 0,45 envia R\$ 9,75 ao destino. No saque de subconta, o valor informado é o líquido do destinatário; a revisão acrescenta tarifa e eventual comissão ao débito total.

A revisão abre antes de qualquer envio e mostra a chave mascarada, o valor líquido, a tarifa Mingo, a comissão quando houver e o débito total. Você pode voltar para corrigir o destino ou salvar um apelido nos favoritos. Escolher um favorito preenche apenas o destino; valor, confirmação e autenticação continuam obrigatórios.

Contatos são separados por organização e ambiente. A chave fica criptografada no servidor e não é devolvida completa ao navegador. As seções Recentes e Contatos aparecem somente após saques Pix concluídos e mostram apenas destinos com um envio concluído. Um favorito salvo antes do envio fica disponível na lista após o primeiro Pix concluído para aquela chave. Salvar um favorito não cria uma transferência.

O provedor de pagamentos não disponibiliza consulta do titular e banco de uma chave Pix antes do pagamento. Quando um Pix concluído retorna nome, banco ou documento do destinatário, a revisão identifica esses dados como histórico, com a data da confirmação anterior. O CPF, quando disponível, mostra somente os seis dígitos centrais. Esse histórico não comprova a titularidade atual de uma chave que pode ter sido transferida a outra pessoa. Nunca use um apelido salvo como confirmação bancária.

Esses controles pertencem à sessão autenticada do painel. A API pública e o SDK não disponibilizam saques, consulta de titular de chave Pix ou gerenciamento de favoritos.


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