# 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 opcional (name e email). Não é necessário CPF do comprador. Exemplo de corpo: {"amount":10.00,"external_reference":"pedido_123"}.

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.