Prerequisites
- A Paystack account with your secret key from the Paystack dashboard
Connecting Paystack
- In Monigo, go to Settings → Payment Processors
- Click Add Processor → Paystack
- Paste your Paystack secret key
- Monigo validates the key and creates the connection
You can add both test and live Paystack keys. The key used matches the mode of your Monigo API key (test key uses Paystack test key, live key uses Paystack live key).
What Monigo uses Paystack for
| Action | Paystack API used |
|---|---|
| Charge a customer | Charge API (direct charge or payment link) |
| Bulk payout to recipients | Bulk Transfer API |
| Verify bank accounts | Resolve Account Number API |
Required Paystack permissions
Your Paystack secret key needs:- Charge permission — to collect invoice payments
- Transfer permission — to send payouts to recipients
Webhook forwarding
Monigo receives Paystack webhooks internally to track charge and transfer status. You don’t need to set up a separate Paystack webhook for billing purposes — Monigo handles this automatically. Your application will still receive Monigo’s own webhooks forinvoice.paid, payout.slip.paid, etc.
Troubleshooting
“Invalid key” error during connection: Make sure you’re using the secret key (starting withsk_) not the public key (pk_).
Charges failing:
Check that the customer’s card or virtual account details are correctly set up in Paystack. Monigo surfaces the raw Paystack error in the invoice detail view.