# Rapid Documentation

> Rapid integration documentation: dispute prevention, chargeback alerts, chargeback defense, transaction upload, webhooks, capture and evidence. The public API is at https://api.rapidchargeback.com and uses Basic Auth with client_id and client_secret.

Every page is available as Markdown: replace the trailing slash of the URL with `.md`. The whole documentation in one file: https://doc.rapidchargeback.com/en/llms-full.txt. MCP server for AI assistants: https://doc.rapidchargeback.com/mcp/. Postman collection: https://doc.rapidchargeback.com/en/rapid.postman_collection.json.

Also in Portuguese (https://doc.rapidchargeback.com/llms.txt) and Spanish (https://doc.rapidchargeback.com/es/llms.txt).

## Get started

- [Rapid Documentation](https://doc.rapidchargeback.com/en/index.md): Rapid integration documentation, covering dispute prevention, chargeback alerts, transaction upload, webhooks and evidence capture.
- [First integration](https://doc.rapidchargeback.com/en/primeira-integracao.md): From zero to the first alert answered: credentials, webhook with validated signature, first transaction and the status callback, with ready-to-run commands.

## Products

- [Prevention](https://doc.rapidchargeback.com/en/produtos/prevencao/visao-geral.md): How Prevention resolves the dispute before the chargeback, answering the issuing bank with the order data from the transactions you already send.
- [Prevention › Integration](https://doc.rapidchargeback.com/en/produtos/prevencao/integracao.md): What to send to enable Prevention: merchant data, minimum transaction fields and the ones that enable fraud protection.
- [Alert](https://doc.rapidchargeback.com/en/produtos/alerta/visao-geral.md): How Alert warns you of a dispute before it becomes a chargeback, how the alert reaches your company and what to respond for each card network.
- [Alert › Rules and deadlines](https://doc.rapidchargeback.com/en/produtos/alerta/regras-e-prazos.md): The statuses of an alert, the response deadline for each card network, converting other to account_suspended and when the alert expires.
- [Dispute](https://doc.rapidchargeback.com/en/produtos/disputa/visao-geral.md): How Dispute builds and submits the chargeback defense, what Rapid needs from you and the access revocation in fraud disputes.

## Integration channels

- [Merchants › List merchants](https://doc.rapidchargeback.com/en/canais/merchants/listar-merchants.md): Lists your company's merchants, paginated, with the merchant_id that creating a transaction and sending a capture event require.
- [Transactions › Overview](https://doc.rapidchargeback.com/en/canais/transactions/visao-geral.md): Send, retrieve, update and remove the sales transactions that feed Prevention and Dispute, with Basic Auth and JSON.
- [Transactions › Create transaction](https://doc.rapidchargeback.com/en/canais/transactions/criar-transacao.md): Creates a single sales transaction. To create several transactions at once, see the Batch upload page.
- [Transactions › Batch upload](https://doc.rapidchargeback.com/en/canais/transactions/envio-em-lote.md): Creates multiple transactions in a single request (up to 1000 per call).
- [Transactions › Retrieve transaction](https://doc.rapidchargeback.com/en/canais/transactions/consultar-transacao.md): Returns the full data of a transaction, by Rapid's ID or by your system's ID, including items, customer, addresses, payments and refunds.
- [Transactions › Update transaction](https://doc.rapidchargeback.com/en/canais/transactions/atualizar-transacao.md): Updates an existing transaction. Every field is optional: send only what you want to change.
- [Transactions › Delete transaction](https://doc.rapidchargeback.com/en/canais/transactions/deletar-transacao.md): Deletes a transaction and all its related data (items, customer, addresses, payments, refunds).
- [Transactions › Error codes](https://doc.rapidchargeback.com/en/canais/transactions/codigos-de-erro.md): The HTTP statuses and error codes of the Transactions API, with the exact messages and the error format in batch upload.
- [Transactions › Best practices](https://doc.rapidchargeback.com/en/canais/transactions/boas-praticas.md): How to send transactions reliably: what to send, data format, credential security, response handling and immutability.
- [Webhook › Overview](https://doc.rapidchargeback.com/en/canais/webhook/visao-geral.md): How Rapid delivers alerts and events to your system by HTTPS webhook: URL registration, signing key and delivery flow.
- [Webhook › Payload](https://doc.rapidchargeback.com/en/canais/webhook/payload.md): The events Rapid sends by webhook: headers, the fields of each body, full examples and the difference between the v2 and legacy formats.
- [Webhook › Authentication](https://doc.rapidchargeback.com/en/canais/webhook/autenticacao.md): How to validate the HMAC-SHA256 signature of Rapid webhooks, with replay protection and ready-made examples in Node.js, Python and PHP.
- [Webhook › Retries and logs](https://doc.rapidchargeback.com/en/canais/webhook/retries-e-logs.md): When Rapid tries to deliver the webhook again, at what intervals, what counts as success and how to read the delivery log.
- [Webhook › Best practices](https://doc.rapidchargeback.com/en/canais/webhook/boas-praticas.md): What a webhook endpoint needs to do: validate the signature, respond fast, be idempotent, use HTTPS and a public address.
- [Capture › Overview](https://doc.rapidchargeback.com/en/canais/capture/visao-geral.md): How Rapid records, at the moment they happen, the signals that back a sale: terms acceptance, device, access, delivery and usage.
- [Capture › Install the snippet](https://doc.rapidchargeback.com/en/canais/capture/instalar-o-snippet.md): The snippet is the shortest way to capture evidence: two tags in your checkout and one call per event. It talks to the browser channel for you.
- [Capture › Send an event from the browser](https://doc.rapidchargeback.com/en/canais/capture/enviar-evento-navegador.md): Records a capture event using the publishable token. It is the endpoint the snippet calls, and you can call it directly if you prefer not to load the script.
- [Capture › Send an event from the server](https://doc.rapidchargeback.com/en/canais/capture/enviar-evento-servidor.md): Record capture events from your backend: confirmed delivery, tracking, service usage and backdated events.
- [Capture › Types and payload](https://doc.rapidchargeback.com/en/canais/capture/payload.md): Reference of the values accepted in the two capture channels. Applies to POST /capture/{token}/events and POST /capture/events.
- [Capture › Snippet configuration](https://doc.rapidchargeback.com/en/canais/capture/config-do-snippet.md): Endpoint that returns the account's identification configuration, read by the snippet when it loads. Only needed if you write your own collector.
- [Evidence › Overview](https://doc.rapidchargeback.com/en/canais/evidence/visao-geral.md): The Evidence API attaches to an already sent transaction the facts that back the defense: acceptance, access, delivery, usage and conversation with the customer.
- [Evidence › Record evidence](https://doc.rapidchargeback.com/en/canais/evidence/registrar-evidencia.md): Attaches an evidence record to a transaction already sent to Rapid.
- [Evidence › List evidence](https://doc.rapidchargeback.com/en/canais/evidence/consultar-evidencias.md): Lists the evidence recorded on a transaction, from oldest to newest.

## Status callback

- [Overview](https://doc.rapidchargeback.com/en/callback/visao-geral.md): The status callback: the answer your application sends back to Rapid after analyzing an alert, and when it is mandatory.
- [Update status](https://doc.rapidchargeback.com/en/callback/atualizar-status.md): Updates the status of an alert received by webhook.
- [List alerts](https://doc.rapidchargeback.com/en/callback/consultar-alertas.md): Lists your company's chargeback alerts, with optional filters and pagination.

## Technical reference

- [Authentication](https://doc.rapidchargeback.com/en/referencia/autenticacao.md): Technical reference for every Rapid authentication mechanism: Basic Auth for your calls and the webhook signature for Rapid's calls.
- [Response codes](https://doc.rapidchargeback.com/en/referencia/codigos-de-resposta.md): Reference of the HTTP codes used across the whole Rapid API.
- [Common problems](https://doc.rapidchargeback.com/en/referencia/problemas-comuns.md): Index by symptom of the most common integration problems, with the likely cause and the page that solves each one.
- [Glossary](https://doc.rapidchargeback.com/en/referencia/glossario.md): The payment and integration terms used in this documentation, from ARN to webhook, with what each one means for whoever integrates with Rapid.
- [Canonical examples](https://doc.rapidchargeback.com/en/referencia/exemplos-canonicos.md): The fixed IDs, values and credentials of every example in the documentation, so that one page's example connects to another's.
- [Developer tools](https://doc.rapidchargeback.com/en/referencia/ferramentas-para-devs.md): The documentation in your AI assistant (MCP), as Markdown and llms.txt, and the Postman collection with every request ready to use.
- [API changelog](https://doc.rapidchargeback.com/en/referencia/novidades-da-api.md): What changed in the Rapid integration API, by date: new endpoints, behavior changes and what still works from the previous system.