---
title: "Payment link webhooks"
method: POST
path: "payment_links"
tags: ["Payment links"]
---

# Payment link webhooks

`POST payment_links` (webhook)

Sent to the webhook URI you registered in Console when a payment is created from a payment link and when a payment link expires.

## Headers

- `Tl-Signature` string, required

## Payload

- union
  - WebhookPaymentLinkPaymentCreated
    - `type` 'payment_link_payment_created', required
    - `event_version` 1, required: The version of the event schema.
    - `event_id` string, required: Unique ID of the event.
    - `payment_link_id` string, required: Unique ID for the Payment Link
    - `payment` object, required
      - `id` string, required: Unique ID for the Payment
      - `created_at` string, datetime, required: Date and time the payment got created from the payment link
  - WebhookPaymentLinkDisabled
    - `type` 'payment_link_disabled', required
    - `event_version` 1, required: The version of the event schema.
    - `event_id` string, required: Unique ID of the event.
    - `payment_link_id` string, required: Unique ID for the Payment Link
    - `disabled_reason` 'expired' | 'cancelled' | 'fulfilled', required
    - `disabled_at` string, datetime, required: Date and time the payment link was disabled

## Acknowledgement `200`

Webhook Handled

---

[API](https://skmtc.dev/truelayer/apis/payments-api-v3.md) - [All operations](https://skmtc.dev/truelayer/apis/payments-api-v3/llms.txt) - [OpenAPI document](https://skmtc.dev/truelayer/apis/payments-api-v3/revisions/a7c585fc9b84?raw)