Skip to main content

Como autentico?

Header X-API-Key: gp_live_.... Tutorial completo: Primeira integração · Chaves de API.

Existe sandbox?

Não. Use valores baixos em produção para testar.

Trilho PADRAO?

A GoatPay opera com um único trilho: PADRAO (conta verificada, PIX regulado, reembolso, MED, loja completa). O trilho vem da chave de API, não do body. Conceitos.

Receber PIX vs enviar PIX?

  • Receber (payment-pix/*): gera QR Code / copia e cola — tutorial
  • Enviar (transfer-pix/* ou alias payouts/*): debita sua conta e paga chave ou BR Code
  • Reembolsar (refunds/*): devolve depósito PIX recebido (trilho PADRAO)

transfer-pix e payouts?

Mesma operação. POST /payouts/create é alias de POST /transfer-pix/create.

Como usar com Cursor / ChatGPT / IA?

A GoatPay publica llms.txt e OpenAPI. Guia: Integração com IA.

O que está na doc v1?

Cobranças (billings/*), assinaturas, PIX automático, recarga, bureau de crédito, PIX, cripto, loja, conta e subcontas estão documentados. Veja Rotas da API e Produtos avançados.

Webhook não chega?

Confira URL HTTPS, eventos inscritos e se a transação foi criada pela mesma API key do endpoint. Webhooks na prática · Troubleshooting.

SDK oficial?

Não. Use HTTP direto; a API Reference traz OpenAPI e exemplos cURL. Assistentes de código podem usar llms.txt.