> ## 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.

# Monnify

> Connect your Monnify account for virtual account generation and collections.

Monigo integrates with Monnify primarily for **virtual account-based collections** — a common billing pattern where each customer is assigned a dedicated bank account number.

## Connecting Monnify

1. Go to **Settings → Payment Processors → Add Processor → Monnify**
2. Enter your Monnify API Key and Secret Key from the [Monnify merchant portal](https://app.monnify.com)
3. Specify your Contract Code
4. Monigo validates the credentials and creates the connection

## Virtual account collections

With Monnify connected, Monigo can provision a dedicated virtual account for each customer. Customers pay by bank transfer to their unique account number, and Monnify notifies Monigo when payment clears.

```bash theme={null}
POST /v1/customers/{id}/virtual-accounts
{
  "provider": "monnify",
  "preferred_banks": ["wema", "sterling"]
}
```

## Webhook handling

Monnify sends a webhook to Monigo when a transfer is received. Monigo matches the transfer to the correct customer and marks the corresponding invoice as paid.