Skip to main content

Como autentico?

Header X-API-Key: gp_live_.... Veja Chaves de API.

Existe sandbox?

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

PADRAO e LIVRE?

Trilhos de saldo separados na conta. PADRAO = conta verificada (trilho principal). LIVRE = PIX Livre.

Receber PIX vs enviar PIX?

  • Receber (payment-pix/*): gera QR Code / copia e cola.
  • 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.

O que não está na doc v1?

Cobranças PJ (cartão/boleto), PIX Pay, assinaturas, recarga e bureau estão previstos para documentação futura. Veja Rotas da API.

Webhook não chega?

Confira URL HTTPS, eventos inscritos e se a transação foi criada pela mesma API key do endpoint. Detalhes em Webhooks.

SDK oficial?

Não. Use HTTP direto; a API Reference traz OpenAPI e exemplos cURL.