Payload

All webhook payloads follow a consistent top-level structure with event-specific data nested within the data object.

paymentIdstring

The payment link ID.

statusstring

The link status. Always "failed" for this event.

amountnumber

The amount that was attempted in cents (100 = $1.00).

currencystring

The payment currency code.

descriptionstring

The payment description shown to the customer.

customerIdstring | null

The customer ID, or null when the link is not tied to a customer. Returns your externalId if you provided one when creating the customer, otherwise returns the Commet publicId.

failureCodestring

The failure code from the payment processor.

failureMessagestring

A human-readable failure message.

{
  "event": "payment_link.failed",
  "timestamp": "2026-06-23T14:30:00.000Z",
  "organizationId": "8f14e45f-ceea-4e7a-9c3d-1c2b3a4d5e6f",
  "mode": "live",
  "apiVersion": "2026-06-23",
  "data": {
    "paymentId": "pay_l1m2n3",
    "status": "failed",
    "amount": 5000,
    "currency": "usd",
    "description": "One-time onboarding fee",
    "customerId": "user_123",
    "failureCode": "card_declined",
    "failureMessage": "Your card was declined."
  }
}

When this fires

When a charge attempt on a payment link is declined. The link stays open — a failed link is retryable, and the customer can pay it again. A later successful attempt fires payment_link.completed.

failureCode is the processor's code (for example card_declined) and failureMessage is the human-readable reason, or null when the provider gives none.

The event fires the same way regardless of which payment provider processes the charge.