Paystack integration guide
Connect your Paystack account to Revenue Cone in 8 steps. Once live, payers can pay demand notices online and payments are confirmed in your dashboard automatically.
Create or log in to your Paystack account
Go to paystack.com and sign in. If you do not have an account, click Get Started and register using your business email. You will need to complete business verification before going live.
Note: Use the same email address you registered your organisation with, so Paystack can verify your business details.
Retrieve your API keys
In the Paystack dashboard, go to Settings → API Keys & Webhooks. You will see two key pairs: Test keys (for sandbox testing) and Live keys (for real payments). Copy your Live Secret Key and Live Public Key.
Note: Keep your Secret Key private. Never share it or commit it to code. The Public Key is safe to use in frontend code.
Enter your keys in Revenue Cone
In your Revenue Cone dashboard, go to Settings → Payment Processors. Click Add Processor and select Paystack. Paste your Live Public Key and Live Secret Key into the fields provided. Save.
Note: Revenue Cone encrypts your secret key at rest. It is never exposed in the frontend or logs.
Configure the webhook in Paystack
A webhook allows Paystack to notify Revenue Cone instantly when a payment is completed. In the Paystack dashboard under API Keys & Webhooks, find the Webhook URL field. Enter the webhook URL shown in your Revenue Cone settings (it looks like: https://api.yourdomain.com/webhooks/paystack).
Note: The webhook URL is unique to your organisation. Copy it exactly from your Revenue Cone settings page.
Set the webhook secret
In Paystack, you can set a webhook secret to sign all outbound webhook calls. Copy this secret and enter it in the Revenue Cone webhook secret field (Settings → Payment Processors → Paystack → Webhook Secret). This ensures only genuine Paystack events are processed.
Verify the integration with a test payment
Go to a payer profile in Revenue Cone and generate a demand notice. Open the payment link. On the Paystack checkout page, use a test card (4084 0840 8408 4081, expiry any future date, CVV 408) to make a test payment. Confirm the payment appears in Revenue Cone within 30 seconds.
Note: Test cards only work in test mode. For live payments, switch to Live keys as described in Step 2.
Configure transaction fees (optional)
By default, Paystack charges a processing fee per transaction (1.5% for local cards, capped at ₦2,000). In your Paystack dashboard under Settings → Preferences, you can choose to absorb this fee or pass it to the payer. Contact Paystack support for custom fee arrangements if you have high transaction volume.
Go live
Once the test payment confirms successfully and you see the reconciled entry in Revenue Cone, your integration is live. All future payments made by payers via QR codes or payment links will be processed through Paystack and confirmed in Revenue Cone automatically.
Troubleshooting common issues
Payment confirmed on Paystack but not in Revenue Cone
Check Settings → Webhooks in Revenue Cone to see if the event was received. If it is missing, verify the webhook URL in Paystack is exact and that your server is reachable at that URL.
Webhook events are failing with 401 Unauthorized
Your webhook secret does not match. Re-copy the webhook secret from Paystack and update it in Revenue Cone → Settings → Payment Processors → Paystack.
Test payments work but live payments do not
Confirm you entered Live keys (not Test keys) in Revenue Cone. Test and Live keys are different and must not be mixed.
Paystack says my account is not verified
You must complete Paystack's KYC (Know Your Customer) business verification before processing live transactions. Log in to Paystack, go to Settings → Business Information, and complete the verification steps.
Still stuck? Contact us at hello@revcone.com or visit the Help Centre. You can also reach Paystack support directly at support.paystack.com.