Step 1: Configure the Webhook URL in Your WooCommerce Site

1. Open thePaynote Plugin in your admin panel.
2. Navigate to Orders Settings → Update Order Statuses.
3. Select Webhook from the dropdown.
4. Copy the Webhook URL generated by the plugin.

Choosing the Correct Webhook Portal
Depending on your selected mode, use the corresponding portal to configure the webhook URL:

Test Mode → https://paynote-sandbox.seamlesschex.com/
Live Mode → https://paynote.seamlesschex.com/

Step 2: Configure Webhooks in Paynote

1. Log in to your Paynote Dashboard.
2. Navigate to Account Settings → API Tab.
3. Paste the copied Webhook URL into the designated field.
4. Click Save to apply changes.

Note: If you encounter a 400 or 401 error when saving, refer to the Common Webhook Issues and Solutions section below.

Once configured, this setup ensures that order status updates from Paynote are automatically reflected in your WooCommerce store.

---

Common Webhook Issues and Solutions

1. Firewall Restrictions and IP Whitelisting

Issue: Webhook requests may be blocked due to strict firewall rules or missing IP whitelisting.

Solution: Update your security settings to allow Paynote’s IPs and domains.

Whitelist Paynote IPs and Domains

Domains:

https://api-paynote.seamlesschex.com/
https://paynote-wapi.seamlesschex.com/
https://sandbox-paynote.seamlesschex.com/

IP Addresses:

54.91.177.147
35.168.136.199
52.86.225.5
52.54.42.180

2. Incorrect Webhook Environment Configuration

Issue: Your webhook is set up in Test Mode (sandbox portal), but Paynote is sending requests from the Live Mode (production environment) — or vice versa.

Solution: Ensure your webhook URL matches the correct portal:

Use the sandbox portal if testing.
Use the production portal if handling real transactions.

3. Authentication Errors Due to API Key Mismatch

Issue: Your Live API key is being used while the webhook is set in Test Mode (sandbox) — or vice versa.

Solution: Verify that both your API key and Webhook URL match the intended environment.

---

Understanding Paynote Modes

Paynote offers two API modes to support your business operations:

Sandbox Mode

• Prefix: sk_test_
• Purpose: For testing transactions, creating mock data, and simulating different scenarios.
• Security: Provides access to the test environment only.

Live Mode

• Prefix: sk_
• Purpose: Used for real transactions and payment processing.
• Security: Requires strict protection as it grants access to sensitive customer data.

Key Differences Between Sandbox and Live Mode

---

Important Security Notice

⚠ Never expose secret API keys in client-side code.
⚠ Live API keys must be handled with extreme caution to prevent unauthorized access or financial loss.

By following this guide, you can ensure a seamless integration between Paynote and your WooCommerce store.