Payment link webhooks

Payment link notifications sent to your webhook URI registered in Console.

There are two situations where the Payments v3 API sends a webhook notification for a payment link:

  • When a payment is created through a payment link
  • When a payment link is disabled

Learn more about the payment link lifecycle .

payment_link_payment_created

You receive this webhook when a payment is created through a payment link. Creation occurs when the user clicks Pay Now on the first page of the payment link.

This table displays the different fields you receive in the payment_link_payment_created webhook notification:

FieldTypeDescription
typestringThe type of the event, in this case payment_link_payment_created.
event_versionintegerThe version of the event schema.
event_idstringThe unique ID of the event.
payment_link_idstringThe unique ID for the payment link.
paymentobjectInformation about the payment created through the payment link.

Includes two fields:

- id: The unique ID for the payment, independent of the payment link.
- created_at: The date and time at which the payment was created.
{
  "type": "payment_link_payment_created",
  "event_version": 1,
  "event_id": "b8d4dda0-ff2c-4d77-a6da-4615e4bad941",
  "payment_link_id": "aKiW35RWSyF",
  "payment": {
    "id": "60c0a60ed8d7-4e5b-ac79-401b1d8a8633",
    "created_at": "2021-12-25T15:00:00.000Z"
  }
}

payment_link_disabled

This table displays the different fields you receive in the payment_link_disabled webhook notification:

FieldTypeDescription
typeStringThe type of the event, in this case payment_link_disabled.
event_versionIntegerThe version of the event schema.
event_idStringThe unique ID of the event.
payment_link_idStringThe unique ID for the payment link.
disabled_reasonAnyThe reason that the payment link was disabled. Can be one of three reasons:

- expired: The time specified in expires_at at payment link creation has passed.
- fulfilled: The payment created through the payment link was completed successfully.
- cancelled: This is not yet implemented, so the only way a payment link can be disabled is if it's expired or fulfilled.
disabled_atStringAn RFC-3339 timestamp that states the date and time the payment link was disabled at.
{
"type": "payment_link_disabled",
"event_version": 1,
"event_id": "b8d4dda0-ff2c-4d77-a6da-4615e4bad941",
"payment_link_id": "aKiW35RWSyF",
"disabled_reason": "expired",
"disabled_at": "2021-12-25T15:00:00.000Z"
}