Verify before fulfilment
Check the raw-body HMAC signature, timestamp, event ID, final status, amount, currency, and invoice_ref.
Merchant Dashboard
Set up your payment integration in one place.
Create an API key with its paired webhook. Then run a test checkout and track every payment from one workspace.
1. Sign in
Open the merchant workspace for your business.
Sign in with your merchant account. If you manage more than one business, choose the one you want to connect before you continue.
2. Choose Test mode
Connect the application that will create checkouts.
Open Developers and turn on the Test mode switch. The banner confirms that payments are simulated. Quid Payments will confirm when live access is available.
Name each API key
Use a name that identifies your website, app, or service.
Start in Test mode
Build and verify your payment journey with sample test data.
Connect your server
Send API requests from your server-side application.
3. Create an API key
Connect to the Quid Payments API.
Open Developers → API keys and select Add API key. Enter a name and the HTTPS webhook URL for this key. Copy the API key and webhook signing secret before selecting Done.
Authorization header
Authorization: Bearer YOUR_API_KEY
4. Verify webhook events
Receive payment updates on your server.
Use the signing secret from your API key’s pair to verify payment events. In Developers → API keys, select Manage to update its URL or rotate either secret independently. Each key sends events only to its paired webhook.
Track delivery status
Use Merchant Dashboard to inspect each delivery and resolve failures before you update an order.
5. Run a hosted checkout test
See your payment journey end to end.
Use your test API key to create a hosted checkout session from your server. Follow the payment page as a customer would, then confirm that your webhook receives the final payment event.
6. Review the result
Confirm the payment and webhook delivery.
Open Transactions to review the payment record. Then check Developers → Webhook deliveries to confirm delivery. Update the order only when the payment and verified webhook agree.
Payment methods at checkout
Hosted checkout supports the payment methods available to your customers, including Mobile Money, bank transfer, and cash deposit. Card payments are not available.