logo
Merchant Invoices Webhooks APIManually resend the latest webhook for an invoice

Manually resend the latest webhook for an invoice

Triggers an immediate delivery attempt for the latest webhook event of this invoice (regardless of its current status: pending, success, or dead). A new WebhookEventAttempt row with trigger=manual is recorded; the auto-retry schedule is not modified.

If the latest event is in the worker queue and currently being processed, the request is rejected with WEBHOOK_RESEND_CONFLICT (409) — try again in a few seconds.

A short cooldown is enforced between manual resends per event (default: 15s). On cooldown violation the response is WEBHOOK_RESEND_COOLDOWN (429) with retry_after_sec and next_allowed_at in the error meta.

invoice_ref accepts either our order_id (UUID) or the merchant's external_id. The response always echoes back our internal order_id and the new attempt's outcome (ok, http_status, duration_ms, attempt_id).

curl -X POST "https://api.example.com/v1/api/v1/invoices/example_string/webhooks/resend" \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: YOUR_API_KEY"
{
  "successful": true,
  "invoice_id": "example_string",
  "event_id": 123,
  "resend": {
    "ok": true,
    "http_status": 42,
    "duration_ms": 42,
    "attempt_id": 123
  }
}
POST
/api/v1/invoices/{invoice_ref}/webhooks/resend
POST
API Key (header: X-Api-Key)
X-Api-Keystring
Required

Merchant API Key.

Merchant API Key.
path
invoice_refstring
Required

Invoice identifier — either our order_id (UUID) or the merchant's external_id

Request Preview
Response

Response will appear here after sending the request

Authentication

header
X-Api-Keystring
Required

API Key for authentication. Merchant API Key.

Path Parameters

invoice_refstring
Required

Invoice identifier — either our order_id (UUID) or the merchant's external_id

Responses

successfulboolean
invoice_idstring
Required

Internal invoice order_id (UUID)

event_idinteger
Required

The webhook event that was resent

resendobject
Required