Rules and deadlines
Possible statuses
Section titled “Possible statuses”Every alert starts with the pending status and changes according to the customer’s response or as time passes.
Statuses you can send through the callback
Section titled “Statuses you can send through the callback”| Status | When to use |
|---|---|
notfound | The transaction was not found in your system |
account_suspended | The transaction was found and is already resolved (e.g. account suspended, refund made) |
other | The transaction was found but is not resolved yet |
See Update status for the endpoint details.
Statuses visible in the webhook payload
Section titled “Statuses visible in the webhook payload”Besides the three above that you send, the alert status in the webhook can appear as:
| Status | Meaning |
|---|---|
pending | Initial status of every alert received |
expired | Ethoca alert whose deadline passed with no response |
Deadlines by provider
Section titled “Deadlines by provider”pending You respond within 24 hours
-
notfoundfinal -
account_suspendedfinal -
othercan becomeaccount_suspendedwithin 6 days
No response within 24 hours
-
expiredfinal; the dispute proceeds and usually becomes a chargeback
Ethoca (Mastercard)
Section titled “Ethoca (Mastercard)”Response deadline: 24 hours from receipt.
- You must send
notfound,account_suspendedorotherthrough the callback within this deadline - If the deadline passes with no response, the alert automatically becomes
expired. Ethoca reads this as inaction and the dispute follows its normal course (it usually becomes a chargeback).
Converting other → account_suspended: up to 6 days
- If you first sent
otherbecause you were still investigating, you can later update it toaccount_suspendedwithin 6 days of the original alert - This is the only transition allowed after an initial response
Final statuses cannot be changed:
notfoundis finalaccount_suspendedis finalexpiredis final
Verifi RDR (Visa)
Section titled “Verifi RDR (Visa)”No mandatory deadline.
- The refund was already made automatically by the acquirer before the alert even arrived
- The status you send is only for internal organization in the dashboard
- You can send any of the three statuses (
notfound,account_suspended,other) at any time
Expiration
Section titled “Expiration”Rapid automatically marks Ethoca alerts as expired after 24h with no response. Verifi RDR alerts do not expire: they stay available in the dashboard indefinitely.
Redelivery
Section titled “Redelivery”If the webhook delivery fails, Rapid makes up to 4 attempts (1 initial + 3 retries) at intervals of 5, 15 and 30 minutes (see Retries and logs). If every attempt fails, the alert stays available in the dashboard and you can redeliver it from there (see Manual redelivery).
Redelivered alerts keep the same alert_id, so your application needs to be idempotent.