Payment Links

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

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

Payment Link Paid

{
  "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": "MYR",
        "entity": "order",
        "id": "order_FOGs9Hz3ZaAjsm",
        "notes": {
          "Policy Name": "Jeevan Saral"
        },
        "receipt": "242324",
        "status": "paid"
      }
    },
    "payment": {
      "entity": {
        "acquirer_data": {
          "bank_transaction_id": "5786838"
        },
        "amount": 10000,
        "amount_refunded": 0,
        "amount_transferred": 0,
        "bank": "PHBM",
        "base_amount": 10000,
        "captured": true,
        "card_id": null,
        "contact": "+919988998899",
        "created_at": 1596890289,
        "currency": "MYR",
        "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": "fpx",
        "notes": [],
        "order_id": "order_FOGs9Hz3ZaAjsm",
        "refund_status": null,
        "status": "captured",
        "tax": 36,
        "wallet": null
      }
    },
    "payment_link": {
      "entity": {
        "accept_partial": false,
        "amount": 10000,
        "amount_paid": 10000,
        "callback_method": "",
        "callback_url": "",
        "cancelled_at": 0,
        "created_at": 1596890208,
        "currency": "MYR",
        "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"
      }
    }
  }
}

Payment Link Partially Paid

{
  "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": "MYR",
        "entity": "order",
        "id": "order_FOGwcUPfHfHmzW",
        "notes": {
          "Policy Name": "Jeevan Saral"
        },
        "receipt": "876767",
        "status": "attempted"
      }
    },
    "payment": {
      "entity": {
        "acquirer_data": {
          "rrn": "641070969475",
        },
        "amount": 5000,
        "amount_refunded": 0,
        "amount_transferred": 0,
        "bank": "PHBM",
        "base_amount": 5000,
        "captured": true,
        "card_id": null,
        "contact": "+919988998889",
        "created_at": 1596890944,
        "currency": "MYR",
        "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": "fpx",
        "notes": [],
        "order_id": "order_FOGwcUPfHfHmzW",
        "refund_status": null,
        "status": "captured",
        "tax": 18,
        "wallet": null
      }
    },
    "payment_link": {
      "entity": {
        "accept_partial": true,
        "amount": 10000,
        "amount_paid": 5000,
        "callback_method": "",
        "callback_url": "",
        "cancelled_at": 0,
        "created_at": 1596890514,
        "currency": "MYR",
        "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

{
  "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": "MYR",
        "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"
      }
    }
  }
}

Payment Link Expired

{
  "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": "MYR",
        "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"
      }
    }
  }
}

Watch Out!

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