Testing

Learn how to test your webhooks and troubleshoot common issues.

Built-in Testing

Use our built-in webhook testing feature to verify your configuration:

1

Open Test Modal

Click the "Test Webhook" button on any webhook in your dashboard.

2

Customize Payload

Modify the test payload to match your expected webhook data.

3

Execute Test

Click "Execute Test" to send the webhook with proper HMAC signature.

4

Review Response

Check the response status, headers, and generated keys.

Common Issues & Solutions

1. HMAC Signature Mismatch

   Error: "Invalid signature"

   • Check that your HMAC secret matches exactly

   • Verify the HMAC algorithm (SHA-1, SHA-256, SHA-512)

   • Ensure the header name is correct (X-Signature, X-Webhook-Signature, etc.)

   • Make sure the raw body is used for signature calculation

2. Conditions Not Met

   Error: "Conditions not met, webhook skipped"

   • Check your custom conditions logic

   • Verify field paths are correct (use dot notation)

   • Test with different payload values

   • Use the test feature to debug conditions

3. Key Generation Failed

   Error: "Key generation failed"

   • Verify your provider and service are correctly configured

   • Check that you have sufficient API credits

   • Ensure the service is active and not disabled

   • Check the quantity field path (e.g., item.quantity)

Status Codes

200 - Success

Keys generated successfully

204 - No Content

Conditions not met, webhook skipped

400 - Bad Request

Missing signature or invalid payload

500 - Server Error

Internal error or key generation failed

Pro Tip: Always test your webhooks thoroughly before going live. Use the built-in testing feature to verify HMAC signatures, custom conditions, and key generation.