Skip to content

↑↓ navigate ↵ open Ctrl↵ new tab esc close

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

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.

  • Transactions API at /api/v1/transactions: create, send in batch (up to 1000 per call), retrieve by Rapid’s ID or by your system’s ID, update and delete.
  • List merchants, to find the merchant_id through the API.
  • List alerts with filters (status, dates, card, provider ID) and pagination.
  • Update status of the alert at PATCH /api/v1/chargeback-alert/alerts/:id/status.
  • v2 webhook format: delivery signed with HMAC-SHA256 and a timestamp, event identified in the body and in a header, and a single channel for every product.
  • Evidence and Capture, which feed the Dispute defense.
  • A single error format across the whole API (see Response codes).
  • Developer tools: the documentation in your AI assistant (MCP), in Markdown and in llms.txt, and the Postman collection.
  • 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.
  • Request limit per IP, also counting 401 responses, with Retry-After on the 429. See Response codes.
  • Webhook retries at defined intervals. See Retries and logs.

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 systemUse in a new integration
POST /chargeback-alert/update/statusPATCH /api/v1/chargeback-alert/alerts/:id/status
POST /chargeback-alert/getGET /api/v1/chargeback-alert/alerts
Webhook in the legacy format, with clientid/clientkeyWebhook in the v2 format, with a signature

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

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.