> For the complete documentation index, see [llms.txt](https://pivot-payment.gitbook.io/pivot-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://pivot-payment.gitbook.io/pivot-docs/payments/after-the-payment/payment-notify.md).

# Payment Notify

Payment Notify enables your system to react to real-time payment events such as when a payment is being processed, successfully paid, or canceled.

## Create a Callback endpoint

Before handling payment events, you must register the endpoint in the Dashboard so that we can notify you.

Follow these steps:

1. Log in to your Dashboard
2. Navigate to Settings > Choose Developer Setting

   <figure><img src="https://3640688391-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbRczl3VT35wkmuP4KTzZ%2Fuploads%2FexOyorhchpMTgGQ3Yq6u%2FScreenshot%202025-07-19%20at%2012.43.56.png?alt=media&amp;token=ee969514-4bd4-45ee-ac3a-a0ad44f5cde2" alt=""><figcaption></figcaption></figure>
3. Go to Callbacks, then register your Payment Callback URLs

   <figure><img src="https://3640688391-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbRczl3VT35wkmuP4KTzZ%2Fuploads%2FT7MQ2zUVI9674OYGy5yq%2FScreenshot%202025-07-19%20at%2012.44.35.png?alt=media&amp;token=99334cb8-57ba-4306-b557-ac71e600ee0f" alt=""><figcaption></figcaption></figure>
4. Return only HTTP Response 200 for registering the Callback URLs

   <figure><img src="https://3640688391-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbRczl3VT35wkmuP4KTzZ%2Fuploads%2Fm9JtpGrQWvDn5IS1f1nt%2FScreenshot%202025-07-19%20at%2012.45.17.png?alt=media&amp;token=e3a81568-55ec-48c2-9c4e-613e8e50ae53" alt=""><figcaption></figcaption></figure>

## Create a payment event handler

You need to create a handler in your server to receive and process incoming payment event notifications. There are four key event types you need to handle:

| Event Name         | Description                                                                                    | Action                                                                                        |
| ------------------ | ---------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------- |
| PAYMENT.PROCESSING | The Payment has been initiated and is currently in progress                                    | Update the transaction status in your system to "Processing" or "Pending Payment."            |
| PAYMENT.PAID       | The payment was successfully completed                                                         | Fulfill the order, update the transaction status to "Paid", and notify the customer if needed |
| PAYMENT.CANCELLED  | The payment has been cancelled, either by the Customer, system timeout, or manual intervention | Update the transaction status to "Cancelled" or "Failed" and  inform the customer if needed   |
| CHARGE.SUCCESS     | Charge was successfully completed in Multiple Payment Type                                     | Fulfill the order, update the transaction status to "Paid", and notify the customer if needed |
