# Novidades da API

> O que mudou na API de integração da Rapid, por data: endpoints novos, mudanças de comportamento e o que continua valendo do sistema anterior.

Página: https://doc.rapidchargeback.com/referencia/novidades-da-api/

Mudanças na API de integração, da mais recente para a mais antiga. Mudança só no painel não entra aqui.

## Outubro de 2026: nova API

A versão atual da API, que substitui a do sistema anterior. Se você já integrava com a Rapid, esta é a lista do que muda.

### Novo

- **API de Transações** em `/api/v1/transactions`: [criar](https://doc.rapidchargeback.com/canais/transactions/criar-transacao/), [enviar em lote](https://doc.rapidchargeback.com/canais/transactions/envio-em-lote/) (até 1000 por chamada), [consultar](https://doc.rapidchargeback.com/canais/transactions/consultar-transacao/) pelo ID da Rapid ou pelo ID do seu sistema, [atualizar](https://doc.rapidchargeback.com/canais/transactions/atualizar-transacao/) e [deletar](https://doc.rapidchargeback.com/canais/transactions/deletar-transacao/).
- **[Listar merchants](https://doc.rapidchargeback.com/canais/merchants/listar-merchants/)**, para achar o `merchant_id` pela API.
- **[Consultar alertas](https://doc.rapidchargeback.com/callback/consultar-alertas/)** com filtros (status, datas, cartão, ID do provedor) e paginação.
- **[Atualizar status](https://doc.rapidchargeback.com/callback/atualizar-status/)** do alerta em `PATCH /api/v1/chargeback-alert/alerts/:id/status`.
- **Webhook no formato `v2`**: entrega [assinada](https://doc.rapidchargeback.com/canais/webhook/autenticacao/) com HMAC-SHA256 e timestamp, evento identificado no corpo e no header, e um canal só para todos os produtos.
- **[Evidência](https://doc.rapidchargeback.com/canais/evidence/visao-geral/) e [Captura](https://doc.rapidchargeback.com/canais/capture/visao-geral/)**, que alimentam a defesa da Disputa.
- **Erros num formato único** em toda a API, inclusive em rota que não existe (`404 NOT_FOUND`). O `message` vem em inglês; decida pelo `code` (ver [Códigos de resposta](https://doc.rapidchargeback.com/referencia/codigos-de-resposta/)).
- **[Ferramentas para devs](https://doc.rapidchargeback.com/referencia/ferramentas-para-devs/)**: a documentação no seu assistente de IA (MCP), em Markdown e em `llms.txt`, e a coleção do Postman.

### Mudou

- **Webhook só em HTTPS e em endereço público de internet.** Redirecionamento que troca o POST por GET (`301`, `302`, `303`) não é seguido. Ver [Retries e logs](https://doc.rapidchargeback.com/canais/webhook/retries-e-logs/).
- **Limite de requisições** por IP, contado também nas respostas `401`, com `Retry-After` no `429`. Ver [Códigos de resposta](https://doc.rapidchargeback.com/referencia/codigos-de-resposta/#rate-limit).
- **Retentativas do webhook** com intervalos definidos. Ver [Retries e logs](https://doc.rapidchargeback.com/canais/webhook/retries-e-logs/).

### Continua funcionando, do sistema anterior

Mantidos para quem já integrava, sem mudança do seu lado. Para integração nova, use os endpoints da coluna da direita.

| Do sistema anterior | Use em integração nova |
|---|---|
| `POST /chargeback-alert/update/status` | [`PATCH /api/v1/chargeback-alert/alerts/:id/status`](https://doc.rapidchargeback.com/callback/atualizar-status/) |
| `POST /chargeback-alert/get` | [`GET /api/v1/chargeback-alert/alerts`](https://doc.rapidchargeback.com/callback/consultar-alertas/) |
| Webhook no [formato `legacy`](https://doc.rapidchargeback.com/canais/webhook/payload/#formato-legacy), com `clientid`/`clientkey` | Webhook no formato `v2`, com [assinatura](https://doc.rapidchargeback.com/canais/webhook/autenticacao/) |

Esses endpoints antigos serão removidos quando não houver mais chamadas a eles.

### Sem equivalente

A **API de Transações do sistema anterior** (`/transactions/create`, `/transactions/update` e `/transactions/delete`, sem `/api/v1`) não existe na nova API. Mudaram o caminho e os campos: a integração precisa passar para a [API de Transações](https://doc.rapidchargeback.com/canais/transactions/visao-geral/) nova.