Payment Links🔗

The table below lists the various Webhook events available for Payment Links.

Webhook Event	Description	Payment Link Type
`payment_link.paid`	Triggered when a Payment Link is paid.	Standard Payment Links UPI Payment Links
`payment_link.partially_paid`	Triggered when a partial payment is made on a Standard Payment Link.	Standard Payment Link
`payment_link.cancelled`	Triggered when a Payment Link is cancelled by you.	Standard Payment Links UPI Payment Links
`payment_link.expired`	Triggered when a Payment Link expires.	Standard Payment Links UPI Payment Links

Payment Link Paid🔗

 payment_link.paid (Standard) payment_link.paid (UPI)
Copy{
  "account_id": "acc_DKoeHMNpi0nC7k",
  "contains": [
    "payment",
    "order",
    "payment_link"
  ],
  "created_at": 1596890208,
  "entity": "event",
  "event": "payment_link.paid",
  "payload": {
    "order": {
      "entity": {
        "amount": 10000,
        "amount_due": 0,
        "amount_paid": 10000,
        "attempts": 1,
        "created_at": 1596890282,
        "currency": "INR",
        "entity": "order",
        "id": "order_FOGs9Hz3ZaAjsm",
        "notes": {
          "Policy Name": "Jeevan Saral"
        },
        "offer_id": null,
        "offers": [
          "offer_FMdr9OHMx4sJTd",
          "offer_FMfpNfZzDhKWzZ"
        ],
        "receipt": "242324",
        "status": "paid"
      }
    },
    "payment": {
      "entity": {
        "acquirer_data": {
          "bank_transaction_id": "5786838"
        },
        "amount": 10000,
        "amount_refunded": 0,
        "amount_transferred": 0,
        "bank": "HDFC",
        "base_amount": 10000,
        "captured": true,
        "card_id": null,
        "contact": "+919988998899",
        "created_at": 1596890289,
        "currency": "INR",
        "description": "#FOGqq3O6E5bkml",
        "email": "gaurav.kumar@example.com",
        "entity": "payment",
        "error_code": null,
        "error_description": null,
        "error_reason": null,
        "error_source": null,
        "error_step": null,
        "fee": 236,
        "fee_bearer": "platform",
        "id": "pay_FOGsH8uHkF2FbR",
        "international": false,
        "invoice_id": null,
        "method": "netbanking",
        "notes": [],
        "order_id": "order_FOGs9Hz3ZaAjsm",
        "refund_status": null,
        "status": "captured",
        "tax": 36,
        "vpa": null,
        "wallet": null
      }
    },
    "payment_link": {
      "entity": {
        "accept_partial": false,
        "amount": 10000,
        "amount_paid": 10000,
        "callback_method": "",
        "callback_url": "",
        "cancelled_at": 0,
        "created_at": 1596890208,
        "currency": "INR",
        "customer": {
          "contact": "+919988998899",
          "email": "gaurav.kumar@example.com"
        },
        "description": "Payment Link created for policy no #222344",
        "expire_by": 1598898599,
        "expired_at": 0,
        "first_min_partial_amount": 0,
        "id": "plink_FOGqq3O6E5bkml",
        "notes": {
          "Policy Name": "Jeevan Saral"
        },
        "notify": {
          "email": true,
          "sms": true
        },
        "order_id": "order_FOGs9Hz3ZaAjsm",
        "payments": null,
        "reference_id": "242324",
        "reminder_enable": true,
        "reminders": {},
        "short_url": "https://rzp.io/i/vw4jjVn",
        "source": "",
        "source_id": "",
        "status": "paid",
        "updated_at": 1596890291,
        "user_id": "CJoeHHJLF5hsWe"
      }
    }
  }
}
Copy{
  "account_id": "acc_FmjfFVdp6tBLow",
  "contains": [
    "payment",
    "order",
    "payment_link"
  ],
  "created_at": 1602522293,
  "entity": "event",
  "event": "payment_link.paid",
  "payload": {
    "order": {
      "entity": {
        "amount": 100,
        "amount_due": 0,
        "amount_paid": 100,
        "attempts": 1,
        "created_at": 1602522302,
        "currency": "INR",
        "entity": "order",
        "id": "order_Fo491cL6NGAjkI",
        "notes": [],
        "offer_id": null,
        "receipt": null,
        "status": "paid"
      }
    },
    "payment": {
      "entity": {
        "acquirer_data": {
          "rrn": "028622280402"
        },
        "amount": 100,
        "amount_refunded": 0,
        "amount_transferred": 0,
        "bank": null,
        "base_amount": 100,
        "captured": true,
        "card_id": null,
        "contact": null,
        "created_at": 1602522350,
        "currency": "INR",
        "description": null,
        "email": null,
        "entity": "payment",
        "error_code": null,
        "error_description": null,
        "error_reason": null,
        "error_source": null,
        "error_step": null,
        "fee": 1,
        "fee_bearer": "platform",
        "id": "pay_Fo49sHbQ78PCMI",
        "international": false,
        "invoice_id": null,
        "method": "upi",
        "notes": [],
        "order_id": "order_Fo491cL6NGAjkI",
        "refund_status": null,
        "status": "captured",
        "tax": 0,
        "vpa": "example@okhdfcbank",
        "wallet": null
      }
    },
    "payment_link": {
      "entity": {
        "accept_partial": false,
        "amount": 100,
        "amount_paid": 100,
        "cancelled_at": 0,
        "created_at": 1602522293,
        "currency": "INR",
        "customer": {
          "contact": "9999999999",
          "email": "gaurav.kumar@razorpay.com"
        },
        "description": "Payment for Acme Inc",
        "expire_by": 0,
        "expired_at": 0,
        "first_min_partial_amount": 0,
        "id": "plink_Fo48rl281ENAg9",
        "notes": null,
        "notify": {
          "email": true,
          "sms": true
        },
        "order_id": "order_Fo491cL6NGAjkI",
        "reference_id": "",
        "reminder_enable": false,
        "reminders": {},
        "short_url": "https://rzp.io/i/XQiMe4w",
        "status": "paid",
        "updated_at": 1602522351,
        "upi_link": true,
        "user_id": "FmjfFPCOUOAcSH"
      }
    }
  }
}

Payment Link Partially Paid🔗

 payment_link.partially_paid
Copy{
  "account_id": "acc_DKoeHMNpi0nC7k",
  "contains": [
    "payment",
    "order",
    "payment_link"
  ],
  "created_at": 1596890514,
  "entity": "event",
  "event": "payment_link.partially_paid",
  "payload": {
    "order": {
      "entity": {
        "amount": 10000,
        "amount_due": 5000,
        "amount_paid": 5000,
        "attempts": 1,
        "created_at": 1596890536,
        "currency": "INR",
        "entity": "order",
        "id": "order_FOGwcUPfHfHmzW",
        "notes": {
          "Policy Name": "Jeevan Saral"
        },
        "offer_id": null,
        "offers": [
          "offer_FMdr9OHMx4sJTd",
          "offer_FMfpNfZzDhKWzZ"
        ],
        "receipt": "876767",
        "status": "attempted"
      }
    },
    "payment": {
      "entity": {
        "acquirer_data": {
          "rrn": "641070969475",
          "upi_transaction_id": "C9699F682E23B8121AD8C61DE1041EAE"
        },
        "amount": 5000,
        "amount_refunded": 0,
        "amount_transferred": 0,
        "bank": null,
        "base_amount": 5000,
        "captured": true,
        "card_id": null,
        "contact": "+919988998889",
        "created_at": 1596890944,
        "currency": "INR",
        "description": "#FOGwFAQyP9p5RT",
        "email": "gaurav.kumar@example.com",
        "entity": "payment",
        "error_code": null,
        "error_description": null,
        "error_reason": null,
        "error_source": null,
        "error_step": null,
        "fee": 118,
        "fee_bearer": "platform",
        "id": "pay_FOH3o1bAREIX1h",
        "international": false,
        "invoice_id": null,
        "method": "upi",
        "notes": [],
        "order_id": "order_FOGwcUPfHfHmzW",
        "refund_status": null,
        "status": "captured",
        "tax": 18,
        "vpa": "gaurav.kumar@exampleupi",
        "wallet": null
      }
    },
    "payment_link": {
      "entity": {
        "accept_partial": true,
        "amount": 10000,
        "amount_paid": 5000,
        "callback_method": "",
        "callback_url": "",
        "cancelled_at": 0,
        "created_at": 1596890514,
        "currency": "INR",
        "customer": {
          "contact": "+919988998899",
          "email": "gaurav.kumar@example.com"
        },
        "description": "Payment Link created for policy no #222344",
        "expire_by": 1598898599,
        "expired_at": 0,
        "first_min_partial_amount": 100,
        "id": "plink_FOGwFAQyP9p5RT",
        "notes": {
          "Policy Name": "Jeevan Saral"
        },
        "notify": {
          "email": true,
          "sms": true
        },
        "order_id": "order_FOGwcUPfHfHmzW",
        "payments": null,
        "reference_id": "876767",
        "reminder_enable": true,
        "reminders": {},
        "short_url": "https://rzp.io/i/t72ubmb",
        "source": "",
        "source_id": "",
        "status": "partially_paid",
        "updated_at": 1596890944,
        "user_id": "DKoeHHJLF5hsWe"
      }
    }
  }
}

Payment Link Cancelled🔗

 payment_link.cancelled (Standard) payment_link.cancelled (UPI)
Copy{
  "account_id": "acc_DKoeHMNpi0nC7k",
  "contains": [
    "payment",
    "order",
    "payment_link"
  ],
  "created_at": 1596891102,
  "entity": "event",
  "event": "payment_link.cancelled",
  "payload": {
    "order": {
      "entity": null
    },
    "payment": {
      "entity": null
    },
    "payment_link": {
      "entity": {
        "accept_partial": true,
        "amount": 10000,
        "amount_paid": 0,
        "callback_method": "",
        "callback_url": "",
        "cancelled_at": 1596891110,
        "created_at": 1596891102,
        "currency": "INR",
        "customer": {
          "contact": "9988999888",
          "email": "gaurav.kumar@example.com"
        },
        "description": "Payment Link created for policy no #222344",
        "expire_by": 1598898599,
        "expired_at": 0,
        "first_min_partial_amount": 100,
        "id": "plink_FOH6af7VB1nerE",
        "notes": {
          "Policy Name": "Jeevan Saral"
        },
        "notify": {
          "email": true,
          "sms": true
        },
        "payments": [],
        "reference_id": "343422",
        "reminder_enable": true,
        "reminders": {
          "status": "failed"
        },
        "short_url": "https://rzp.io/i/iM5nHMY",
        "source": "",
        "source_id": "",
        "status": "cancelled",
        "updated_at": 1596891110,
        "user_id": "DKoeHHJLF5hsWe"
      }
    }
  }
}
Copy{
  "account_id": "acc_FmjfFVdp6tBLow",
  "contains": [
    "payment",
    "order",
    "payment_link"
  ],
  "created_at": 1602522615,
  "entity": "event",
  "event": "payment_link.cancelled",
  "payload": {
    "order": {
      "entity": {
        "amount": 100,
        "amount_due": 100,
        "amount_paid": 0,
        "attempts": 0,
        "created_at": 1602522619,
        "currency": "INR",
        "entity": "order",
        "id": "order_Fo4EayQh1zSGxn",
        "notes": [],
        "offer_id": null,
        "receipt": null,
        "status": "created"
      }
    },
    "payment": {
      "entity": null
    },
    "payment_link": {
      "entity": {
        "accept_partial": false,
        "amount": 100,
        "amount_paid": 0,
        "cancelled_at": 1602522621,
        "created_at": 1602522615,
        "currency": "INR",
        "customer": {
          "contact": "9999999999",
          "email": "gaurav.kumar@razorpay.com"
        },
        "description": "Payment for Acme Inc",
        "expire_by": 0,
        "expired_at": 0,
        "first_min_partial_amount": 0,
        "id": "plink_Fo4EWsg3KmfWGW",
        "notes": null,
        "notify": {
          "email": true,
          "sms": true
        },
        "order_id": "order_Fo4EayQh1zSGxn",
        "reference_id": "",
        "reminder_enable": false,
        "reminders": {},
        "short_url": "https://rzp.io/i/2agF8tv",
        "status": "cancelled",
        "updated_at": 1602522621,
        "upi_link": true,
        "user_id": "FmjfFPCOUOAcSH"
      }
    }
  }
}

Payment Link Expired🔗

 payment_link.expired (Standard) payment_link.expired (UPI)
Copy{
  "account_id": "acc_DKoeHMNpi0nC7k",
  "contains": [
    "payment",
    "order",
    "payment_link"
  ],
  "created_at": 1596891102,
  "entity": "event",
  "event": "payment_link.expired",
  "payload": {
    "order": {
      "entity": null
    },
    "payment": {
      "entity": null
    },
    "payment_link": {
      "entity": {
        "accept_partial": true,
        "amount": 10000,
        "amount_paid": 0,
        "callback_method": "",
        "callback_url": "",
        "cancelled_at": 1596891110,
        "created_at": 1596891102,
        "currency": "INR",
        "customer": {
          "contact": "9988999888",
          "email": "gaurav.kumar@example.com"
        },
        "description": "Payment Link created for policy no #222344",
        "expire_by": 1598898599,
        "expired_at": 1598898599,
        "first_min_partial_amount": 100,
        "id": "plink_FOH6af7VB1nerE",
        "notes": {
          "Policy Name": "Jeevan Saral"
        },
        "notify": {
          "email": true,
          "sms": true
        },
        "payments": [],
        "reference_id": "343422",
        "reminder_enable": true,
        "reminders": {
          "status": "failed"
        },
        "short_url": "https://rzp.io/i/iM5nHMY",
        "source": "",
        "source_id": "",
        "status": "expired",
        "updated_at": 1596891110,
        "user_id": "DKoeHHJLF5hsWe"
      }
    }
  }
}
Copy{
  "account_id": "acc_DKoeHMNpi0nC7k",
  "contains": [
    "payment",
    "order",
    "payment_link"
  ],
  "created_at": 1596891102,
  "entity": "event",
  "event": "payment_link.expired",
  "payload": {
    "order": {
      "entity": null
    },
    "payment": {
      "entity": null
    },
    "payment_link": {
      "entity": {
        "amount": 10000,
        "amount_paid": 0,
        "cancelled_at": 1596891110,
        "created_at": 1596891102,
        "currency": "INR",
        "customer": {
          "contact": "9988999888",
          "email": "gaurav.kumar@example.com"
        },
        "description": "Payment Link created for policy no #222344",
        "expire_by": 1598898599,
        "expired_at": 1598898599,
        "first_min_partial_amount": 0,
        "id": "plink_FOH6af7VB1nerE",
        "notes": {
          "Policy Name": "Jeevan Saral"
        },
        "notify": {
          "email": true,
          "sms": true
        },
        "payments": [],
        "reference_id": "343422",
        "reminder_enable": true,
        "reminders": {
          "status": "failed"
        },
        "short_url": "https://rzp.io/i/iM5nHMY",
        "source": "",
        "source_id": "",
        "status": "expired",
        "updated_at": 1596891110,
        "user_id": "DKoeHHJLF5hsWe"
      }
    }
  }
}

Handy Tips
If you have changed your webhook secret, remember to use the old secret for webhook signature validation while retrying older requests. Using the new secret will lead to signature mismatch.

Do Not Parse or Cast the Webhook Request Body
While generating a signature at your end, ensure that the webhook body is passed as an argument in the raw webhook request body. Do not parse or cast the webhook request body.

Payment Links - Sample Payload

Payment Links🔗

Payment Link Paid🔗

Payment Link Partially Paid🔗

Payment Link Cancelled🔗

Payment Link Expired🔗