Prompts para IA

Copie o prompt, cole na sua ferramenta de IA e gere a integração. Cada prompt já traz a base URL, a autenticação e o formato de resposta reais da API.

Criar cobrança Pix#

Gera uma cobrança com QR Code dinâmico e Pix Copia e Cola.

Use a API Pitra (https://pitra.com.br/api/public/v1) e a OpenAPI oficial em https://pitra.com.br/api/public/v1/openapi.json.
Implemente no meu backend uma função que cria uma cobrança Pix com POST /payments/pix.
Envie Authorization: Bearer <PITRA_API_KEY>, Content-Type: application/json e Idempotency-Key.
Corpo: amount (número em reais), description, external_id (meu identificador único) e expires_in em segundos.
Retorne para o meu app o id, o status, o qr_code (Copia e Cola) e a imagem do QR Code exatamente como vierem na resposta.
Não invente campos que não estejam na OpenAPI.

Consultar cobrança Pix#

Consulta por id da Pitra ou pelo seu external_id.

Use a API Pitra (https://pitra.com.br/api/public/v1).
Implemente duas funções de consulta de cobrança Pix:
1) GET /payments/pix/{id}
2) GET /payments/pix/external/{external_id}
Ambas com Authorization: Bearer <PITRA_API_KEY>.
Trate 404 como cobrança inexistente e devolva o status da cobrança sem inventar estados fora dos documentados.

Listar cobranças Pix#

Paginação por cursor com filtros de status e external_id.

Use a API Pitra (https://pitra.com.br/api/public/v1).
Implemente a listagem de cobranças Pix com GET /payments/pix usando paginação por cursor.
Parâmetros: limit (máx. 100), starting_after, status e external_id.
Percorra todas as páginas enquanto has_more for true, usando next_cursor em starting_after.
Autenticação: Authorization: Bearer <PITRA_API_KEY>.

Encerrar uma cobrança#

Como a Pitra trata o fim de vida da cobrança Pix.

Na API Pitra não existe endpoint de cancelamento de cobrança Pix: a cobrança expira automaticamente conforme o expires_in informado na criação.
Implemente no meu sistema o encerramento de um pedido assim:
1) pare de exibir o QR Code quando expires_at passar;
2) trate o evento de webhook pix.expired como cobrança encerrada;
3) para cobrar de novo, crie uma nova cobrança com um novo external_id.
Não invente rotas de cancelamento.

Receber webhook#

Endpoint assinado, verificado e idempotente.

Implemente um endpoint HTTP que recebe webhooks da Pitra.
Requisitos:
- leia o corpo bruto antes de fazer parse;
- valide o header Pitra-Signature (HMAC SHA-256 do corpo bruto com o secret do endpoint), em comparação de tempo constante;
- rejeite requisições com assinatura inválida usando 401;
- deduplique pelo event_id;
- responda 2xx rapidamente e processe de forma assíncrona;
- trate apenas os eventos documentados: product.created, product.updated, product.archived, checkout.created, checkout.updated, checkout.archived, sale.created, sale.approved, sale.refused, sale.canceled, sale.refunded, delivery.sent, pix.created, pix.paid, pix.expired.

Criar integração completa#

Do zero: cobrança, consulta, webhook e conciliação.

Construa uma integração completa com a API Pitra (https://pitra.com.br/api/public/v1), baseada exclusivamente na OpenAPI oficial em https://pitra.com.br/api/public/v1/openapi.json.
Entregue:
1) um cliente HTTP no backend com a chave em variável de ambiente PITRA_API_KEY e header Authorization: Bearer;
2) criação de cobrança Pix (POST /payments/pix) com Idempotency-Key e external_id do meu pedido;
3) consulta por external_id (GET /payments/pix/external/{external_id}) para conciliação;
4) endpoint de webhook com verificação de assinatura Pitra-Signature e deduplicação por event_id;
5) tratamento de erros pelo campo error.code documentado e retentativa com backoff em 429 e 5xx.
Não invente endpoints, parâmetros ou eventos.

API v1 · OpenAPI 1.0.0 · SDK 0.1.0