Connect VOWCH vouchers with your Pabau practice management system in under 15 minutes. This guide covers API configuration, webhook setup, testing, and troubleshooting.
Before you begin, ensure you have the following:
Your VOWCH API key authenticates requests from Pabau to validate and redeem vouchers. Each salon has a unique API key that must be kept secure.
Steps to generate your API key:
Security Note: Treat your API key like a password. Never share it publicly or commit it to version control. If compromised, regenerate it immediately from your dashboard.
Create a custom field in Pabau to capture VOWCH voucher codes during the booking process. This field will trigger the validation API call.
Configuration steps:
Text InputVOWCH Voucher Codevowch_voucher_codehttps://vouchsalon-x3xwdkwk.manus.space/api/pabau/vouchers/validateBearer YOUR_API_KEYWhat happens: When a customer enters a voucher code, Pabau sends a validation request to VOWCH. The API returns the voucher's remaining balance and expiry date, which Pabau displays to the staff member.
Webhooks notify VOWCH when appointments are completed or cancelled, triggering automatic voucher redemption or reservation release.
Webhook 1: Appointment Completed
| Event | appointment.completed |
| URL | https://vouchsalon-x3xwdkwk.manus.space/api/pabau/vouchers/confirm |
| Method | POST |
| Headers | Authorization: Bearer YOUR_API_KEY |
Webhook 2: Appointment Cancelled
| Event | appointment.cancelled |
| URL | https://vouchsalon-x3xwdkwk.manus.space/api/pabau/vouchers/release |
| Method | POST |
| Headers | Authorization: Bearer YOUR_API_KEY |
How it works: When an appointment is marked complete in Pabau, the webhook sends the voucher code and redemption amount to VOWCH. VOWCH deducts the amount from the voucher balance and triggers settlement to your salon account based on your configured settlement mode.
Before going live, test the integration end-to-end to ensure vouchers validate, redeem, and settle correctly.
Testing checklist:
🧪 Use Our Webhook Testing Tool
Before testing in Pabau, verify your API key and webhook configuration using our interactive testing tool. It simulates all webhook calls and provides instant feedback.
Success! If all steps complete without errors, your integration is working correctly. You can now start accepting VOWCH vouchers for real appointments.
Validate a voucher code and return its details.
Request Body:
{
"voucher_code": "VOWCH-XXXX-XXXX",
"requested_amount": 5000 // Optional, in pence
}Response:
{
"success": true,
"valid": true,
"voucher": {
"code": "VOWCH-XXXX-XXXX",
"remaining_balance": 5000,
"expires_at": "2026-06-01T00:00:00Z",
"message": "Voucher is valid"
}
}Reserve voucher balance for an upcoming appointment.
Request Body:
{
"voucher_code": "VOWCH-XXXX-XXXX",
"amount": 5000, // In pence
"appointment_id": "pabau_appointment_123",
"appointment_date": "2026-03-15T14:00:00Z"
}Confirm redemption when appointment is completed.
Request Body:
{
"voucher_code": "VOWCH-XXXX-XXXX",
"amount": 5000, // In pence
"appointment_id": "pabau_appointment_123"
}Release reservation if appointment is cancelled.
Request Body:
{
"voucher_code": "VOWCH-XXXX-XXXX",
"appointment_id": "pabau_appointment_123"
}Cause: The API key in Pabau's Authorization header doesn't match your VOWCH salon account.
Solution: Regenerate your API key from VOWCH dashboard → Settings → Integrations, then update the Authorization header in Pabau's custom field and webhook configurations.
Cause: The voucher code entered doesn't exist in VOWCH, or it belongs to a different salon.
Solution: Verify the voucher code is correct. Check that the voucher was purchased for your salon specifically (customers can only redeem vouchers at the salon they were purchased for).
Cause: The requested redemption amount exceeds the voucher's remaining balance.
Solution: Check the voucher's remaining balance in VOWCH. The customer may have already used part of the voucher. Adjust the redemption amount or ask the customer to pay the difference.
Cause: Pabau webhook configuration is incorrect or the webhook URL is unreachable.
Solution: In Pabau, go to Setup → Webhooks and verify the URLs match exactly (including https://). Check that the Authorization header is present. Test the webhook using Pabau's "Send Test" button.
Cause: Your settlement mode is set to "Monthly Drip" or "Deferred", so funds won't appear immediately.
Solution: Check your settlement mode in VOWCH dashboard → Settings → Settlement. If set to "On Redemption", funds should appear within 24 hours. For other modes, refer to your settlement schedule.
Still having issues? Contact our support team at [email protected] with your salon ID and a description of the problem. We typically respond within 2 hours during business hours.