Flutterwave Payment Setup

Payment gateway for institution billing invoices.

Configuration Keys

Key	Description
BILLS_PAYMENT_ENABLED	Enable bills payment
BILLS_PAYMENT_PROVIDER_FLUTTERWAVE_ENABLED	Enable Flutterwave
BILLS_PAYMENT_PROVIDER_FLUTTERWAVE_AUTH_JSON	Auth config
BILLS_PAYMENT_PROVIDER_FLUTTERWAVE_HEADERS_JSON	Custom headers
BILLS_PAYMENT_PROVIDER_FLUTTERWAVE_AUTHORIZATION	Auth token
BILLS_PAYMENT_PROVIDER_FLUTTERWAVE_LEDGER_CODE	Settlement GL

Invoice Flow

1. InvoiceGenerationJob creates an invoice
2. Flutterwave generates a payment link
3. Customer pays via the link
4. Webhook verifies payment signature
5. Invoice marked as paid

Troubleshooting

• Payment link fails: Verify Flutterwave API key in auth JSON
• Webhook not received: Check webhook URL in Flutterwave dashboard