Payments
Updated Oct 19, 2026
Overview
Matterly supports pay at firm and four online gateways on the client booking flow: Stripe, Razorpay, PayPal and LigdiCash. Each firm connects its own account, so the money goes straight to the firm.
| Gateway | Best for | Clients pay with |
|---|---|---|
| Stripe | Most countries | Cards and wallets |
| Razorpay | India | Cards, UPI, net banking |
| PayPal | International clients | PayPal balance and cards |
| LigdiCash | West and Central Africa | Mobile money (Orange Money, Moov, MTN, Wave and others) and cards |
Firm payment settings
Firm Admin → Settings → Payments
- Choose Pay online when booking.
- Pick one gateway and enter its keys. Where do I find these keys? opens step-by-step help for each one.
- For Stripe, Razorpay and PayPal, copy the webhook link shown on the page into the provider's dashboard so matters confirm even if the client closes the browser.
- Save and run a test booking with a small amount.
Secret keys are stored encrypted and never shown again.
LigdiCash (West and Central Africa)
LigdiCash lets clients pay by mobile money or card in Burkina Faso, Mali, Niger, Benin, Togo, Côte d'Ivoire, Senegal, Guinea and DR Congo. The client is sent to LigdiCash's secure payment page, picks their operator and approves the payment on their phone.
Connect LigdiCash
- Open a merchant account at ligdicash.com and ask LigdiCash to activate an API project.
- In the LigdiCash dashboard, open the project and copy its Apikey and API token.
- In Settings → Payments, choose LigdiCash, paste the API key and API token, and click Save Payments.
There is no webhook to set up: Matterly sends LigdiCash the notification link with every payment.
Currency
LigdiCash charges in CFA francs (XOF), in whole francs. If the firm's currency is XOF, clients pay exactly the listed fee. If the firm prices in another currency, each payment is converted to XOF at the rate set under Languages & Currency, and the page warns you about this. Setting the firm currency to XOF avoids conversion.
How a LigdiCash payment is confirmed
- The matter is confirmed only after Matterly asks LigdiCash directly and LigdiCash reports the payment as completed. Returning to the site or a notification alone never confirms a matter, so a forged link cannot mark a booking as paid.
- Mobile money can take a moment while the client approves it. If they return before it clears, they see a message saying the payment is waiting for approval, and the matter is confirmed (with the usual confirmation email) as soon as LigdiCash reports it.
- LigdiCash sends each notification twice; Matterly records the payment once.
Testing
LigdiCash has no separate sandbox. Use the test keys LigdiCash provides while you integrate, then replace them with your live keys. Nothing else changes.
Platform payment settings
Super Admin → Settings → Payments holds the platform's own accounts for charging firms their subscription:
| Method | How firms pay |
|---|---|
| Stripe | The firm saves a card under Billing and renewals are charged automatically each night |
| LigdiCash (optional) | The firm pays each subscription invoice by mobile money or card with a Pay with LigdiCash button on its Billing page |
LigdiCash cannot renew on its own, because mobile money needs the payer to approve every charge. Instead, when a firm without an automatic card renewal is within 7 days of its renewal date, its Billing page shows Pay renewal with LigdiCash. Paying it moves the subscription to its next period and clears any past-due status. Unpaid invoices you create under Subscriptions can be paid the same way.
Platform prices are in US dollars; LigdiCash charges the equivalent in CFA francs at the XOF rate in Super Admin → Currencies. As with client payments, each payment is confirmed with LigdiCash before the invoice is marked paid.
The four client gateways above are not set up there: each firm connects its own under Settings → Payments to take payments from its clients.
Client booking payment flow
- The client picks a practice area and date on the public site.
- They choose to pay online or at the office.
- Online: the slot is held briefly while they pay on the gateway's page, then the matter is confirmed.
- Firm staff see Open matters after payment, or when staff create them.
Recording offline payments
On a client invoice, use Record Payment with cash, card, bank transfer, UPI, Stripe, Razorpay, PayPal, LigdiCash or other.
Notes
Important: Pending online holds expire if payment is not completed in time.
Best Practices
- Use gateway test keys until go-live.
- Verify webhooks (Stripe, Razorpay, PayPal) before taking real payments.
- For LigdiCash, make one small real payment with each mobile money operator your clients use.
- Reconcile Reports payment methods weekly.