X-SIGNATURE, which is signed using the Waffo private key. Merchants must use the Waffo public key to verify the signature.
Get the Waffo public key
Log in to Merchant Portal → Integration menu to view and copy the Waffo public key.Dev or Admin role permissions are required to access this page.
Recommended approach: use the SDK
The SDK’shandleWebhook() method automatically performs signature verification, event parsing, routing, and response body construction:
Manual verification
If you need to handle this manually (without the SDK), the verification steps are:1
Get the signature
Get
X-SIGNATURE from the request header.2
Get the raw body
Get the raw request body string (do not JSON parse and then stringify).
3
Verify the signature
Use the Waffo public key + SHA256WithRSA to verify the signature.
4
Process the event
Process the event after the signature verification passes.