Visão geral

A LeztyPay é um gateway de pagamentos PIX. A sua aplicação faz três coisas com esta API: cria uma cobrança e mostra o QR Code ao cliente, recebe um webhook assinado no instante em que a cobrança é paga e, quando quiser, saca o saldo para uma chave PIX.

Não existe SDK e não precisa: é HTTP com JSON, autenticação por header e um webhook. Todo exemplo desta documentação é curl ou fetch do Node, sem dependência nenhuma.

Base URL

Uma só, para os dois ambientes:

https://api.leztypay.com

Toda rota de integração fica sob /v1. A autenticação é Authorization: Bearer <sua chave>.

Teste e produção

Quem escolhe o ambiente é a chave, não a URL. Uma chave sk_test_ põe a requisição no ambiente de teste: nenhum dinheiro se move, o QR não é pagável por app de banco de verdade e você decide o resultado de cada cobrança pelos dois últimos dígitos do valor. Uma chave sk_live_ vale dinheiro.

Os dois ambientes não se enxergam. Um objeto criado no teste nunca aparece em produção, e consultar um id do outro ambiente devolve 404.

Por onde começar

• Integrando com a ajuda de uma IA? Comece por Integre com IA: tem um prompt pronto para colar no ChatGPT ou no Claude, que manda o assistente ler esta documentação antes de gerar código.
• Quer ver funcionando primeiro? O quickstart leva você de uma chave de teste até receber o evento transaction.paid.
• Procurando um campo? Ele está na referência da API, gerada do OpenAPI. Nenhuma página escrita à mão repete campo de request ou de response: existe uma fonte de verdade só, e é aquela.

Para máquinas

• /llms.txt: índice desta documentação no formato llmstxt.org.
• /llms-full.txt: a documentação inteira em um arquivo de texto.
• /openapi.json: o documento OpenAPI 3.1 completo.

Próximo passo

Quickstart: cinco minutos até a primeira cobrança paga no ambiente de teste.