Set Webhook URL

Use this endpoint to register or update the webhook URL where you want Paynote to send real-time event notifications. Webhooks allow your system to automatically receive updates on payment statuses, customer activity, funding source verification, and more.

Set Webhook URL

Endpoint: POST /webhooks

Use this endpoint to register or update the webhook URL where you want Paynote to send real-time event notifications. Webhooks allow your system to automatically receive updates on payment statuses, customer activity, funding source verification, and more.

Only one webhook URL can be active per API key. Sending a new request to this endpoint will overwrite the previous URL.


Request

Headers:

  • Authorization: Bearer YOUR_API_KEY
  • Content-Type: application/json

Body:
{
"url": "https://yourdomain.com/paynote-webhook"
}


Response

{
"success": true,
"url": "https://yourdomain.com/paynote-webhook"
}


Example

curl -X POST https://api.paynote.io/v1/webhooks
-H "Authorization: Bearer YOUR_API_KEY"
-H "Content-Type: application/json"
-d '{"url": "https://yourdomain.com/paynote-webhook"}'


Next Steps

Once your webhook URL is set, check out the Webhook Events guide:
https://docs.paynote.io/docs/webhooks

Common event types you can subscribe to:

  • payment.success
  • payment.failed
  • funding_source.verified
  • subscription.created

You can test webhooks safely using your sandbox environment.

Language
Credentials
Header
URL
Click Try It! to start a request and see the response here!