# API changelog

> What changed in the Rapid integration API, by date: new endpoints, behavior changes and what still works from the previous system.

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

Changes to the integration API, newest first. Dashboard-only changes are not listed here.

## October 2026: new API

The current version of the API, replacing the one from the previous system. If you already integrated with Rapid, this is the list of what changes.

### New

- **Transactions API** at `/api/v1/transactions`: [create](https://doc.rapidchargeback.com/en/canais/transactions/criar-transacao/), [send in batch](https://doc.rapidchargeback.com/en/canais/transactions/envio-em-lote/) (up to 1000 per call), [retrieve](https://doc.rapidchargeback.com/en/canais/transactions/consultar-transacao/) by Rapid's ID or by your system's ID, [update](https://doc.rapidchargeback.com/en/canais/transactions/atualizar-transacao/) and [delete](https://doc.rapidchargeback.com/en/canais/transactions/deletar-transacao/).
- **[List merchants](https://doc.rapidchargeback.com/en/canais/merchants/listar-merchants/)**, to find the `merchant_id` through the API.
- **[List alerts](https://doc.rapidchargeback.com/en/callback/consultar-alertas/)** with filters (status, dates, card, provider ID) and pagination.
- **[Update status](https://doc.rapidchargeback.com/en/callback/atualizar-status/)** of the alert at `PATCH /api/v1/chargeback-alert/alerts/:id/status`.
- **`v2` webhook format**: delivery [signed](https://doc.rapidchargeback.com/en/canais/webhook/autenticacao/) with HMAC-SHA256 and a timestamp, event identified in the body and in a header, and a single channel for every product.
- **[Evidence](https://doc.rapidchargeback.com/en/canais/evidence/visao-geral/) and [Capture](https://doc.rapidchargeback.com/en/canais/capture/visao-geral/)**, which feed the Dispute defense.
- **A single error format** across the whole API, including routes that do not exist (`404 NOT_FOUND`). The `message` is in English; decide by the `code` (see [Response codes](https://doc.rapidchargeback.com/en/referencia/codigos-de-resposta/)).
- **[Developer tools](https://doc.rapidchargeback.com/en/referencia/ferramentas-para-devs/)**: the documentation in your AI assistant (MCP), in Markdown and in `llms.txt`, and the Postman collection.

### Changed

- **Webhook only over HTTPS and to a public internet address.** A redirect that turns the POST into a GET (`301`, `302`, `303`) is not followed. See [Retries and logs](https://doc.rapidchargeback.com/en/canais/webhook/retries-e-logs/).
- **Request limit** per IP, also counting `401` responses, with `Retry-After` on the `429`. See [Response codes](https://doc.rapidchargeback.com/en/referencia/codigos-de-resposta/#rate-limit).
- **Webhook retries** at defined intervals. See [Retries and logs](https://doc.rapidchargeback.com/en/canais/webhook/retries-e-logs/).

### Still works, from the previous system

Kept for those who already integrated, with no change on your side. For a new integration, use the endpoints in the right column.

| From the previous system | Use in a new integration |
|---|---|
| `POST /chargeback-alert/update/status` | [`PATCH /api/v1/chargeback-alert/alerts/:id/status`](https://doc.rapidchargeback.com/en/callback/atualizar-status/) |
| `POST /chargeback-alert/get` | [`GET /api/v1/chargeback-alert/alerts`](https://doc.rapidchargeback.com/en/callback/consultar-alertas/) |
| Webhook in the [`legacy` format](https://doc.rapidchargeback.com/en/canais/webhook/payload/#legacy-format), with `clientid`/`clientkey` | Webhook in the `v2` format, with a [signature](https://doc.rapidchargeback.com/en/canais/webhook/autenticacao/) |

These old endpoints will be removed once there are no more calls to them.

### No equivalent

The **previous system's Transactions API** (`/transactions/create`, `/transactions/update` and `/transactions/delete`, without `/api/v1`) does not exist in the new API. The path and the fields changed: the integration needs to move to the new [Transactions API](https://doc.rapidchargeback.com/en/canais/transactions/visao-geral/).