# SinapsePay

> Emita cobranças PIX e boleto pela conta da sua empresa, saiba do pagamento na hora e devolva quando precisar. API REST simples, avisos assinados e segurança de nível bancário.

A SinapsePay é uma plataforma brasileira de cobranças: emite PIX Cobrança (imediata e com vencimento) e boleto registrado pela conta bancária da própria empresa cliente, acompanha cada pagamento, avisa o sistema do cliente por webhook assinado (HMAC-SHA256) e devolve PIX (total ou parcial, em até 90 dias). O dinheiro cai direto na conta da empresa; a SinapsePay não guarda saldo.

- Bancos: Sicoob (PIX Cobrança e boleto) disponível; Itaú, Banco do Brasil, Santander e Sicredi em breve; Simulador para testes.
- API REST em português, valores em centavos, chaves sk_test_ e sk_live_, Idempotency-Key obrigatória em todo POST.
- Base da API: https://api.sinapsepay.com.br/v1
- Cadastro: em breve (interesse: contato@sinapsepay.com.br)
- Texto completo da documentação: https://sinapsepay.com.br/llms-full.txt

## Documentação da API

- [Introdução à API](https://sinapsepay.com.br/docs/introducao.md): Como a API da SinapsePay funciona, os ambientes de teste e produção e a sua primeira cobrança PIX em poucos minutos.
- [Autenticação e chaves de API](https://sinapsepay.com.br/docs/autenticacao.md): Como autenticar na API da SinapsePay com chaves sk_test e sk_live, escopos, IPs permitidos, validade, revogação e limite de requisições.
- [Cobranças](https://sinapsepay.com.br/docs/cobrancas.md): Referência das cobranças PIX e boleto na API da SinapsePay — criar, consultar, o objeto Cobrança, situações e respostas.
- [Devoluções de PIX](https://sinapsepay.com.br/docs/devolucoes.md): Como devolver um PIX recebido pela API da SinapsePay, total ou parcialmente, em até 90 dias, e acompanhar a devolução até o banco concluir.
- [Avisos ao seu sistema (webhooks)](https://sinapsepay.com.br/docs/avisos.md): Receba cobranca.paga e cobranca.devolvida no seu sistema com avisos assinados (HMAC-SHA256), novas tentativas automáticas e exemplos de verificação.
- [Idempotência](https://sinapsepay.com.br/docs/idempotencia.md): Como usar o cabeçalho Idempotency-Key para repetir chamadas à API da SinapsePay com segurança, sem criar cobranças ou devoluções em dobro.
- [Erros](https://sinapsepay.com.br/docs/erros.md): O formato dos erros da API da SinapsePay, os códigos HTTP e os principais códigos de erro, com o que fazer em cada caso.

## Produtos

- [PIX Cobrança](https://sinapsepay.com.br/produtos/pix): QR Code na hora, aviso em segundos, devolução.
- [Boleto](https://sinapsepay.com.br/produtos/boleto): boleto registrado, multa, juros, desconto, baixa e cancelamento.
- [Bancos e integrações](https://sinapsepay.com.br/integracoes): o que está disponível em cada banco.
- [Segurança e disponibilidade](https://sinapsepay.com.br/seguranca): como os dados e as credenciais são protegidos.

## Blog

- [PIX Cobrança: como receber e saber do pagamento na hora](https://sinapsepay.com.br/blog/pix-cobranca-aviso-na-hora): O que é o PIX Cobrança, a diferença entre cobrança imediata e com vencimento, e como a sua empresa fica sabendo do pagamento em segundos, sem conferir extrato.
- [Webhooks assinados: como ter certeza de que o aviso veio da SinapsePay](https://sinapsepay.com.br/blog/webhooks-assinados): Por que conferir a assinatura de cada webhook, como a assinatura HMAC-SHA256 funciona e como validar em Node.js e Python em poucas linhas.
- [Devolução de PIX: quando, quanto e como devolver](https://sinapsepay.com.br/blog/devolucao-de-pix): As regras da devolução de PIX (prazo de 90 dias, devolução total ou parcial), os cuidados para não devolver em dobro e como fazer pelo painel ou pela API.

## Contato

- contato@sinapsepay.com.br