A payment link was paid successfully.
All webhook payloads follow a consistent top-level structure with event-specific data nested within the data object.
The original reason for a charge and how this attempt was initiated. Recovery never replaces the original reason. Context can be null when it was not captured, including retries of historical invoices.
The payment link ID.
The link status. Always "succeeded" for this event.
The collected amount in cents (100 = $1.00).
The payment currency code.
The payment description shown to the customer.
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.
The one-time invoice generated for this payment.
The human-readable invoice number.
The payment transaction ID for the settled charge.
The payment method: card, oxxo, or mercado_pago. Null when unknown.
The source of funds for this charge, when reported by the provider. Null when unavailable or unknown.
{
"event": "payment_link.completed",
"timestamp": "2026-06-23T14:30:00.000Z",
"organizationId": "8f14e45f-ceea-4e7a-9c3d-1c2b3a4d5e6f",
"mode": "live",
"apiVersion": "2026-08-27",
"data": {
"paymentContext": {
"reason": "one_time_payment",
"paymentLinkId": "pay_l1m2n3",
"recovery": null
},
"paymentId": "pay_l1m2n3",
"status": "succeeded",
"amount": 5000,
"currency": "usd",
"description": "One-time onboarding fee",
"customerId": "user_123",
"invoiceId": "inv_n4o5p6",
"invoiceNumber": "INV-0044",
"paymentTransactionId": "txn_q7r8s9",
"paymentMethod": "card",
"subPaymentMethod": null
}
}When a customer pays a payment link on the hosted pay page and the charge settles. Commet generates a one-time invoice (invoiceType: "one_time_payment") and a payment transaction at the same time; the payload carries the invoiceId and paymentTransactionId.
This is the event to fulfill the purchase on — the money has been collected.
The event fires the same way regardless of which payment provider processes the charge.
How is this guide?