Finance & Payments Guide
Get paid with PayStack — payment links, invoices, and transaction management.
PayStack Integration
Marqly uses PayStack as its payment processor. To start accepting payments, connect your PayStack account under Settings > Payments. You will need your PayStack public and secret keys, which are available from your PayStack dashboard. Once connected, you can accept payments via credit card, EFT, and mobile money. All payments are processed securely — Marqly never stores card details.
Note: PayStack keys are configured via the environment variables PAYSTACK_SECRET_KEY and NEXT_PUBLIC_PAYSTACK_PUBLIC_KEY.
Payment Links
Payment links are shareable URLs that take customers directly to a checkout page. Create one under Finance > Payment Links. Set the amount, description, and optional metadata. Each link generates a unique URL you can send via email, SMS, or WhatsApp. When a customer pays, Marqly receives a webhook and updates the payment status automatically.
Note: Payment links are processed through PayStack's checkout flow. Webhook events are handled by the payment engine.
Invoicing
Create invoices under Finance > Invoices. Each invoice includes your business details, client information, line items with quantities and prices, tax (VAT), and payment terms. Invoices can be sent directly to clients via email with a payment link embedded. Paid invoices are marked automatically when the PayStack webhook confirms payment.
Note: Invoice statuses: Draft, Sent, Paid, Overdue, Cancelled. Overdue detection runs daily.
Payouts & Balance
The unified balance view under Finance shows your available balance, pending payouts, and transaction history. PayStack settles payouts on a rolling schedule (typically T+1 or T+2). You can view individual transaction details including fees, net amounts, and settlement references.
Note: Balance data is fetched from PayStack's balance API and cached for performance.