Replay webhook events

Use this when your endpoint missed an event or returned a non-2xx response and you want Bachs to deliver the event again.

When to use this endpoint

Replay webhooks when:

Your endpoint was temporarily unavailable during earlier delivery attempts.
You fixed signature verification or payload handling and need a resend.
You need to re-drive downstream processing for a specific event.

Request

Method & Path

POST /v1/webhooks/replay

Required headers

Header	Required	Description
`Authorization`	Yes	API key bearer token or dashboard bearer token.
`Content-Type`	Yes	Must be `application/json`.

Request fields

View request fields

At least one lookup field is required.

string

Required: NoReplay this exact event ID directly.

string

Required: NoResolve the latest webhook event linked to this charge and replay it.

string

Required: NoResolve checkout by reference, then replay the latest event for the linked charge.

Resolution priority

When multiple fields are provided, replay resolution behaves as:

event_id (direct event lookup)
charge_id
reference

Request example

{
  "event_id": "evt_3ab4e0d5d27445cf8a52ab3d8cb8f0b1"
}

Response

200 - Success

{
  "event_id": "evt_3ab4e0d5d27445cf8a52ab3d8cb8f0b1",
  "attempt_id": "wha_6f1e40f6bdf84c1980e1e1f6407f3f8a",
  "attempt_no": 3,
  "event_type": "collection.failed"
}

Response fields

View response fields

string

Webhook event selected for replay.

string

Newly created delivery attempt ID.

integer

Attempt sequence number for this event after replay was created.

string

Event type associated with the replayed event.

Error responses

400 · BAD_REQUEST

Cause: No supported lookup field was provided.Resolution: Provide at least one of event_id, charge_id, reference, or transaction_id.

401 · UNAUTHORIZED

Cause: Authorization is missing, invalid, or revoked.Resolution: Send a valid bearer credential.

404 · NOT_FOUND

Cause: No matching webhook event could be resolved for your lookup values.Resolution: Verify IDs/references and retry.

Overview

Developer portal

Webhooks

SDKs

CLI

Changelog

Replay webhook events

When to use this endpoint

Request

Method & Path

Required headers

Request fields

Resolution priority

Request example

Response

200 - Success

Response fields

Error responses

When to use this endpoint

Request

Method & Path

Required headers

Request fields

Resolution priority

Request example

Response

200 - Success

Response fields

Error responses

Related pages