How to Set Up Paystack Payments in Accurate Scheduler
Updated October 31, 2026 · 8 min read
In this guide
- Accept Booking Payments with Paystack
- Before you begin
- Step 1 — Get your API keys
- Step 2 — Add Your Paystack Webhook URL
- Step 3 — Test the connection and save settings
- Step 4 — Test a booking payment
- How Paystack booking payments work
- Understanding Pending Payments
- Can I Use Paystack for Deposit Payments?
- How Paystack Refunds Work
- Troubleshooting Paystack Payment Integration
- Related payment guides
Accept Booking Payments with Paystack
The Paystack Payment Integration lets Accurate Scheduler customers pay for appointments through Paystack’s hosted checkout in supported countries and currencies. Customers select Paystack during booking, complete checkout on Paystack and return to the booking page. Accurate Scheduler verifies payment results with Paystack before recording successful payments.
Paystack is included in paid Accurate Scheduler plans. A compatible Paystack merchant account, currency and payment channel are also required. Provider transaction fees and regional restrictions are separate from your scheduling subscription.
Before you begin
- An Accurate Scheduler account on a paid plan, with permission to manage payment settings.
- A Paystack merchant account and access to its API settings.
- The Paystack Secret Key for the environment you want to use.
- A business currency supported by the connected Paystack account.
- A webhook configuration for subsequent payment-status updates.
The Public Key is optional for the current Accurate Scheduler redirect checkout implementation. Customers enter payment details through Paystack’s hosted checkout, rather than a recreated card form in Accurate Scheduler.
Step 1 — Get your API keys
- Sign in to the Paystack Dashboard ↗.
- Open Settings → API Keys & Webhooks.
- Select the appropriate Test or Live environment and locate its API keys.
- Copy the Secret Key. Optionally copy the matching Public Key.
- In Accurate Scheduler, open Settings → Payments and enable Paystack.
- Keep or update the customer-facing Label, then paste the keys into the corresponding fields.
sk_test_…— Test Secret Key.sk_live_…— Live Secret Key.pk_test_…— Test Public Key.pk_live_…— Live Public Key.
The Secret Key determines whether this integration uses Test or Live mode. Do not mix credentials from different environments. If you provide a Public Key, use the one from the same environment and account as the Secret Key. See Paystack’s API-key guidance ↗.
Keep your Secret Key private. Never publish it, send it in support messages or expose it in screenshots. The examples above are prefix placeholders, not usable credentials. The supplied screenshot contains empty key fields; its workspace URL has been redacted.

Step 2 — Add Your Paystack Webhook URL
Webhooks help Accurate Scheduler receive later payment updates, including payments that are not confirmed immediately. Use the URL generated by your workspace.
- In Accurate Scheduler, open Settings → Payments → Paystack.
- Find Webhook URL and select Copy.
- Open Paystack Dashboard → Settings → API Keys & Webhooks.
- Find the Webhook URL setting for the intended environment.
- Paste the exact URL copied from your Accurate Scheduler workspace.
- Save the webhook settings in Paystack.
Match the environment. Paystack has separate Test and Live webhook settings. Configure the field for the same mode as the Secret Key in Accurate Scheduler. When moving to Live, review the Live webhook field as well as the Live key.
No workspace endpoint is hardcoded in this guide. Copy your own generated URL; do not use another business’s endpoint or enter a localhost address for Paystack to call.
Webhook origin and payment results must be validated server-side before a payment status changes. Paystack documents signature validation using the account’s Secret Key; this is handled by the application integration, not by pasting verification code into WordPress. The Paystack settings shown do not ask for a separate webhook-secret field. See Paystack’s webhook documentation ↗.
Step 3 — Test the connection and save settings
- Return to Accurate Scheduler’s Paystack settings.
- Select Test connection and review the result.
- Confirm that the configured business currency is supported by the connected Paystack account.
- Select Save Payment Settings.
- Check the public booking form to confirm Paystack is offered for an eligible booking.
Paystack is shown only when the account, business currency and booking payment flow are compatible. The following are potential currency examples, not a guarantee of availability for every account:
- NGN — Nigerian Naira.
- GHS — Ghanaian Cedi.
- ZAR — South African Rand.
- KES — Kenyan Shilling.
- USD — US Dollar, only where enabled for the connected account.
- XOF — West African CFA Franc.
- EGP — Egyptian Pound.
Country, merchant approval, account configuration and the current integration determine eligibility. Paystack’s country-specific transaction information ↗ describes regional differences; confirm your enabled currencies in the dashboard. A customer’s card currency does not itself enable your business to charge in that currency.
An unsupported business currency keeps Paystack hidden on the public booking form. Review existing prices, bookings and payment records before changing currency. Changing a currency setting is not a conversion of historical amounts.
Step 4 — Test a booking payment
- Configure the Paystack Test Secret Key and, if supplied, the matching Test Public Key.
- Configure the Test webhook URL and save the payment settings.
- Open the public Accurate Scheduler booking page.
- Choose a service and appointment time.
- Select Paystack as the payment method.
- Complete the hosted checkout using Paystack’s official test-payment instructions ↗ for a channel available to your test account.
- Return to Accurate Scheduler and inspect the appointment payment status and payment record.
- Check successful, unsuccessful and pending scenarios that are available in the provider’s testing guidance.
Use only Paystack’s documented test data and methods. No card numbers are reproduced here. Do not use real card details for test payments, or assume every Live payment channel is available in Test mode.
A redirect back to the booking page does not prove payment success. The payment must be verified before it is marked paid. Before accepting real payments, review account activation, replace Test credentials with the appropriate Live credentials and configure the Live webhook settings. Do not mix the environments.
How Paystack booking payments work
- 01Customer selects an appointment
- 02Chooses Paystack
- 03Completes hosted checkout
- 04Accurate Scheduler verifies and records the payment
The customer-facing return page and provider notifications are different parts of this flow. Inspect the verified appointment payment record if a customer reports completing checkout but the booking still shows unpaid or pending.
Understanding Pending Payments
Some methods, including bank transfer and USSD where available to the account, may need additional confirmation. The appointment payment status can remain pending during this period. Webhooks help the integration receive subsequent confirmation; they do not make every payment instant.
Check the correct Test or Live webhook configuration, provider payment status and application records. Do not mark a pending payment successful before verification. If the records disagree or confirmation does not arrive, contact support with the payment reference and error details, never your Secret Key.
Can I Use Paystack for Deposit Payments?
Availability depends on the booking payment flow supported by Accurate Scheduler, the selected deposit type and the configured provider. Do not assume that all deposit types are supported through Paystack.
Paystack is not offered for the refundable security authorization-hold flow documented here. That Accurate Scheduler flow uses supported Stripe or PayPal configurations. This is a limitation of the current Accurate Scheduler integration, not a statement about every product Paystack may offer.
See the Deposit Payment setup guide before configuring online deposits, balance collection or security holds.
How Paystack Refunds Work
Refund requests are processed through Paystack. A requested refund can remain pending or processing while the provider and payment rails handle it; a request being accepted is not proof that the customer has received the money.
Check the verified provider response and the corresponding refund record in Accurate Scheduler. The application status should reflect the provider-confirmed state; if it does not, investigate the records or contact support. Do not assume completion from the initial refund request or promise a fixed arrival time.
Paystack documents refund states and notifications in its refund guide ↗. Provider processing and customer-bank timing can differ; this guide does not guarantee immediate refunds or a processing deadline.
Troubleshooting Paystack Payment Integration
Why is Paystack not showing on my booking form?
Check that Paystack is enabled, the Secret Key is configured and settings have been saved. Confirm a paid Accurate Scheduler plan, supported business currency, compatible account country and merchant/payment-channel eligibility. Paystack is unavailable for the documented refundable security-hold flow. Why does Test connection fail?
Check the Secret Key, Test versus Live environment, account status and network or provider connectivity. Remove accidental whitespace and use the key from the intended account. Do not share the key when asking for help. Why is my payment still pending?
Some payment methods need further confirmation. Check the provider’s payment status, the matching environment’s webhook URL and the application payment record. Returning from checkout is not verification; do not manually treat a pending payment as successful. Can I accept USD through Paystack?
Only if USD is supported and enabled for the connected account and compatible with the current booking flow. A customer holding a USD card does not automatically give the merchant a USD charging currency. Is the Public Key required?
It is optional for Accurate Scheduler’s current redirect checkout flow. The Secret Key is required for the connection. If you provide a Public Key, use one from the matching account and environment. Can I use Paystack for refundable security holds?
Not in the currently documented Accurate Scheduler security-hold flow. Paystack is not offered for that booking requirement; use a supported Stripe or PayPal configuration. How do refunds work?
Paystack processes refund requests. They may remain pending or processing until confirmed. Compare the verified provider response with Accurate Scheduler’s refund record; no immediate-refund or arrival-time guarantee is provided.
Related payment guides
Need a hand with your setup?
Tell us which step you reached and what happened. Keep passwords and client secrets out of your message.
Contact Accurate Scheduler →