# Payment Link Webhooks

Payment Link webhooks notify you about events related to payment links.

> **Note:** The sample payloads on this page are pretty-printed. The body Glomo sends is the RFC 8785 canonical form of the same object, and the `X-Glomopay-Signature` header is computed over those bytes. See [Webhook Authentication & Security](/platform/webhooks#webhook-authentication--security).


Payment links with `payin_type: add_funds` are created to fund a wallet and fire only as `event_type: paid`.

| Event Type | Description |
|  --- | --- |
|  active  | The payment link has been created and is awaiting payment. |
|  paid  | The payment link has been paid successfully. |
|  action_required  | The payment link needs more details to be processed.. |
|  expired  | The payment link has expired. |
|  under_review  | The payment link is under review. |
|  cancelled  | The payment link has been cancelled. |
|  failed  | The payment link couldn't be created. |


## Sample Payload

```Sample
{
  "entity_type": "payment_link",
  "event_type": "success",
  "data": {
    "id": "plink_6819d8046mpKt",
    "customer_id": "cust_6819d7d0lrLvP",
    "document_id": null,
    "status": "paid",
    "currency": "USD",
    "amount": 10000,
    "purpose_code": "P0014",
    "expires_at": "2025-05-15T18:30:00Z",
    "last_reminder_sent_at": "2025-05-06T09:36:12Z",
    "invoice_amount": 0,
    "invoice_description": "",
    "invoice_number": null,
    "payment_link": "https://glomopay.com/payment-links/plink_6819d8046mpKt",
    "reminder_frequency": 0,
    "created_at": "2025-05-06T09:36:04Z",
    "updated_at": "2025-05-08T13:12:54Z",
    "notes": {
      "key1":"value1",
      "key2":"value2"
    }
  }
}
```