Webhook Configuration
Location: Settings → Payments → Webhook
Location: Settings → Payments → Webhook
Webhooks allow QuantaPay to notify your server in real time when a payment is completed.
Fields
| Field | Description |
|---|---|
| Webhook URL | The HTTPS endpoint on your server that will receive POST requests when payment events occur. Must be a publicly accessible URL. |
| Webhook Secret Key | Auto-generated secret included in the webhook JSON payload as the key field. Use this to verify that incoming webhooks are genuinely from QuantaPay. |
Setup
- Enter your webhook endpoint URL (e.g.,
https://yoursite.com/webhook/quantapay) - The Webhook Secret Key is automatically generated. Click the refresh button to regenerate if needed.
- Save settings.
How It Works
When a payment is completed (status C), QuantaPay sends an HTTP POST request to your Webhook URL with:
- A JSON body containing
{ "key": "your-secret", "transaction": { ... } } - Verify the
keyfield matches your Webhook Secret Key to confirm authenticity
For the full webhook payload format, signature verification code, and best practices, see API Reference: Webhooks.
Testing
To test your webhook:
- Create a test checkout session via the API
- Complete a small payment
- Check your server logs for the incoming webhook
Tip: Use a service like webhook.site during development to inspect incoming webhook payloads.