> ## Documentation Index
> Fetch the complete documentation index at: https://docs.monigo.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Paystack

> Connect your Paystack account to Monigo for billing and payouts.

Monigo integrates with Paystack for customer charges and bulk payouts. You connect your own Paystack account — Monigo never holds your funds.

## Prerequisites

* A Paystack account with your secret key from the [Paystack dashboard](https://dashboard.paystack.com/#/settings/developer)

## Connecting Paystack

1. In Monigo, go to **Settings → Payment Processors**
2. Click **Add Processor → Paystack**
3. Paste your Paystack secret key
4. Monigo validates the key and creates the connection

<Info>
  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).
</Info>

## 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 for `invoice.paid`, `payout.slip.paid`, etc.

## Troubleshooting

**"Invalid key" error during connection:**
Make sure you're using the secret key (starting with `sk_`) 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.