Integration guide
Frequently asked questions
Practical answers for partners building their first integration.
Why are test purchases unavailable?
The platform administrator enables single-project testing once and adds a Paystack Test secret privately on the server. Continue using your normal dashboard and main API address. Do not switch to real purchases to work around a testing configuration error.
Does the API sell every organiser’s event?
No. An application sees only its currently assigned events owned by its organiser. Advanced history is narrower still: only purchases attributed to that application. A valid key alone does not grant private customer access.
Why is the widget unavailable?
Check the actual embedding origin including scheme/port, selected environment, app/widget enablement, current manager/event grant, event publication/end and server flags. Refresh an expired five-minute form. Extra ancestors and restrictive host CSP can block framing.
Why is an order paid but no member QR exists?
A group payment reserves sold admission slots immediately. Members must claim through the normal registration flow before each gets a usable QR. Unclaimed admissions do not return to inventory.
Can my application issue refunds or admit marketplace tickets?
No partner refund write or admin bypass is exposed. Delegated entry requires explicit scopes and creator/event authority and is limited to this application’s own purchases. Use the ordinary authorised venue workflow for wider entry operations.
How fast will a webhook arrive?
The initial free/Hobby dispatcher runs daily with twenty attempts per invocation. There is no prompt-delivery SLA. Poll the authoritative server status for a purchase confirmation and use a durable signed inbox for eventual notifications.
Can I test without email or a custom domain?
Email is currently deferred. Test checkout uses the same deployment as Live checkout; tickets remain available through the existing verified buyer pages. Configure a verified email sender only when ready to test controlled recipients.