Integre Com IA

Leia o contexto oficial em https://snakepay.com.br/llms.txt e a documentação em https://snakepay.com.br/docs.
Prepare uma integração SnakePay para meu sistema usando a API https://snakepay.com.br/api/public/v1.
Implemente criação e consulta de cobranças Pix, exibição do Copia e Cola e confirmação por webhook com HMAC-SHA256 sobre o corpo bruto.
Guarde a chave secreta e o segredo de webhook em variáveis de ambiente no servidor. Use placeholders, nunca solicite minhas credenciais no chat.
Não libere pedidos pelo simulador nem pela ação do comprador. Evite cobranças duplicadas e processe confirmações de forma idempotente.
Antes de gerar o código, pergunte qual sistema ou linguagem eu uso e como os pedidos são entregues.

# SnakePay

> Gateway brasileiro de pagamentos Pix para lojistas, com API REST, webhooks assinados, checkout público e split entre contas SnakePay.

Domínio oficial: https://snakepay.com.br. A API usa https://snakepay.com.br/api/public/v1. Integrações exigem uma chave secreta de uma conta registrada; mantenha a chave exclusivamente no servidor e nunca em páginas públicas, aplicativos clientes ou prompts de IA.

Criação de cobrança: POST /api/public/v1/charges com Authorization: Bearer SUA_CHAVE_SECRETA e Content-Type: application/json. O corpo aceita amount em reais (mínimo 1, máximo 100000), description opcional, external_reference opcional e payer com name, document (CPF) e email opcional. Exemplo de corpo: {"amount":10.00,"external_reference":"pedido_123","payer":{"name":"Cliente de Teste","document":"52998224725"}}. Os dados de exemplo não identificam um comprador real.

Uma criação bem-sucedida responde HTTP 201 com id, status pending, amount e net_amount em centavos, currency BRL, qrcode (Pix Copia e Cola) e expires_in em segundos. Consulta: GET /api/public/v1/charges/ID_DA_COBRANCA com a mesma autenticação. As consultas são restritas à conta dona da chave. Não presuma idempotência na criação por external_reference: guarde o id e consulte antes de tentar criar novamente após uma falha incerta.

Para split, inclua split como lista de objetos {"recipient_id":"SHOPID_REAL","percentage":50}. Use ShopIDs completos de contas ativas registradas na SnakePay, obtidos na área Split. Os percentuais distribuem o valor líquido após as taxas; porcentagens não distribuídas e restos de centavos ficam na conta criadora. Não invente recebedores nem considere split um envio direto para contas PixUp externas.

Configure a URL de webhook na área Desenvolvedor. Eventos de entrega atuais incluem pix.paid, pix.expired e pix.failed. Confira X-SnakePay-Signature no formato sha256=HEX: calcule HMAC-SHA256 sobre o corpo bruto com o segredo de webhook e compare em tempo constante. O evento identifica a cobrança em data.charge_id. Trate notificações repetidas de forma idempotente por cobrança/status; só libere pedidos depois de confirmação confiável de pagamento. O simulador não constitui pagamento real. Não prometa eventos ou reembolsos não documentados como operacionais.

Checkouts públicos permitem compra sem cadastro, produtos com preços validados no servidor, descontos, prazo real de oferta e Order Bump opcional. A confirmação real depende da adquirente PixUp. Saques estão temporariamente sujeitos ao processamento administrativo; não prometa saque automático ou prazo garantido sem confirmação operacional.

## Páginas

- [SnakePay](https://snakepay.com.br/): Apresentação da plataforma e destaque da Corrida Pra Vencer.
- [Documentação](https://snakepay.com.br/docs): API Pix, autenticação, webhooks, split e orientações de WooCommerce.
- [Integre Com IA](https://snakepay.com.br/integre-com-ia): Contexto copiável e instruções para preparar uma integração com assistentes de IA.