Skip to main content
WEBHOOK

Headers

X-Meridian-Resource-Type
string
required

Resource type carried by the webhook.

Allowed value: "payment_link"
X-Meridian-Event-Type
enum<string>
required

The payment link event that occurred.

Available options:
payment_link_created,
payment_link_completed,
payment_link_archived
X-Meridian-Api-Key
string

API key issued by Meridian, sent so you can authenticate the webhook. Sent only when your webhook endpoint is configured for Meridian HMAC signing.

X-Meridian-Timestamp
string

Time the webhook was generated, in milliseconds since the Unix epoch. Sent only when your webhook endpoint is configured for Meridian HMAC signing.

X-Meridian-Signature
string

HMAC SHA-256 signature of the webhook request, for verifying that Meridian sent it. Sent only when your webhook endpoint is configured for Meridian HMAC signing.

Body

application/json

The payment link the event relates to.

Webhook payload sent when a payment link is created, completed, or archived.

The payment link the event relates to, in its state at the time of the event.

Response

200

Return any 2xx status to acknowledge the webhook. Any other status causes Meridian to retry.