Integration guide
Add a Buy Tickets button without coding
Create a checkout link, copy it and paste it into a button on your website. You do not need an API key or your own payment backend.
1. Prepare your live event
Sign into the main Naija Tickets organiser workspace. Create and publish your event and ticket types. Hosted checkout and Live payments must be activated by the platform administrator.
To practise, choose Test a purchase in this dashboard. The local-testing guide covers local and hosted websites.
2. Save your website connection
Open Developers & Integrations in your organiser workspace and choose New application. Application simply means the website you are connecting: give it a recognisable name.
Choose On my computer or On the internet, then Test a purchase or Accept real purchases. Enter your base website address without a page path. Real purchases require a hosted HTTPS website.
Under Events this website can sell, tick the events this website should use and press Save and continue. Changes are only applied when saved. Unticked events stay unavailable through this connection; their public Naija Tickets pages are independent.
3. Create your checkout link
In Create a Buy Tickets link, choose a saved, published event. The purchase mode follows your saved connection settings. Enter the page on your registered website where buyers should return, such as https://my-website.example/thank-you. Press Create checkout link, then Copy checkout link.
If checkout needs platform activation, the administrator must configure hosted checkout, its database helpers and matching Live payment settings before customers can buy.
4. Add it to your website
Open the editor for your website, add a button and label it Buy Tickets. In the button settings choose Website address or Link and paste the checkout link. Save and publish your website. The same link can also be shared by email, WhatsApp or social media.
Skip API credentials, webhooks and the HTML snippet for this method. If your builder only accepts a custom HTML block, the optional HTML button is available below the checkout link.
5. Check the complete purchase
Click the published button. Customers select tickets, provide their details and pay on the focused Naija Tickets checkout. Naija Tickets verifies payment before showing tickets. Buyers can then return to your approved website.
For a rehearsal, choose Test a purchase and use Paystack Test payment details. Check ordinary and group tickets, cancellations and sold-out states.
Your website does not need a backend for this button. Ticket records, inventory, verification and group claims remain on Naija Tickets. Ticket emails depend on email service configuration. A personalised payment confirmation on your own website needs a developer to verify the result through the API; a return URL alone does not prove payment.
6. Change or stop selling
Disable the checkout link to block new and unpaid checkouts from that link. To remove an event from the whole connection, untick it and save the integration. Existing paid tickets and purchase history remain available under the normal ticket rules.
Keep this event list: it is the permission boundary for this website’s API keys, hosted links and widgets. One API key does not grant access to all your events. A successful connection check only identifies the application and its permissions.