Documentação
API REST v1
Cadastre devedores e títulos, informe pagamentos, consulte acordos e receba webhooks. Especificação completa em OpenAPI 3.1.
Autenticação
Crie a chave em Integrações, no painel. O prefixo fica visível; o segredo aparece uma única vez. Envie em `Authorization: Bearer nh_live_xxxxxxxx_...`. Restrinja por escopos e, se quiser, por IP.
Endpoints principais
| Método e rota | Uso |
|---|---|
| POST /v1/debtors | Criar devedor com contatos |
| POST /v1/debts | Criar título (unitário ou lote de até 1.000) |
| GET /v1/debts/{id} | Consultar título com valor atualizado |
| PATCH /v1/debts/{id} | Atualizar valor, suspender ou cancelar |
| POST /v1/debts/{id}/payments | Informar pagamento recebido por fora |
| GET /v1/agreements | Listar acordos |
| GET /v1/reports/portfolio | Resumo da carteira |
| POST /v1/imports | Enviar planilha |
| GET /v1/openapi.json | Especificação OpenAPI 3.1 |
Idempotência e paginação
Todo POST exige `Idempotency-Key`. A mesma chave com o mesmo corpo devolve a mesma resposta por 24 horas; corpo diferente devolve 409. Listagens usam `?cursor=` e `?limit=`.
Webhooks
Cada entrega leva `X-NegociarHoje-Signature: t=<unix>,v1=<hmac-sha256>`. Calcule o HMAC do texto `t + "." + corpo` com o segredo do endpoint e compare em tempo constante. Rejeite timestamps com mais de 5 minutos. Retentativas por 72 horas com painel de reenvio.
Exemplo em curl
curl -X POST https://api.negociarhoje.com.br/v1/debts \
-H "Authorization: Bearer nh_live_xxxxxxxx_SEGREDO" \
-H "Idempotency-Key: 7c2c0a9e-1" \
-H "Content-Type: application/json" \
-d '{"debtor":{"nome":"Ana Souza","documento":"52998224725","contatos":[{"tipo":"telefone","valor":"+5511987654321"}]},"debt":{"numero":"NF-1021","vencimento":"2026-08-10","valorOriginalCentavos":28920}}'Atualizado em 2026-09-29. Versão em Markdown.
Comece hoje. A carteira roda amanhã.
14 dias grátis com R$ 50 em disparos e sem taxa de êxito sobre os primeiros R$ 2.000 recuperados. Sem cartão para começar.