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.