Adfin Express for Platforms is the quickest way to add invoicing, credit control and payments to your SaaS application.
Adfin Express & Adfin Core are designed to support multi-tenant architetcture where many users will connect their account through your platform. If you are only automating your own account, please look at our Developer Guide
| Resource | What it represents | Typical operations |
|---|---|---|
| Customer | A customer record with contact details, mandate status, and information on the entity. Can be synced with accounting platform. | Create / update / list / delete customers (/customers endpoints). |
| Invoice | Distributed to a customer. Includes line items, taxes, due dates, and a unique invoice number. | Draft, activate, void, mark-as-paid, or bulk list via /invoices and /invoices/[id]. |
| Direct-Debit Mandate | Used to request and hold consent to pull funds from the customer’s bank. | Create or cancel mandates per customer (/customers/[id]/directdebitmandates). |
| Webhook | Outbound events that keep your system in sync (e.g., invoice paid). | Configure per application |
1. Create a customer
A Customer represents an individual or business that you bill through Adfin.
Customers hold the identity, contact information, and payment-related data required to issue invoices or send payment requests.
Typical uses of the Customer object include:
- Storing contact and billing details (name, email, address, company info).
- Managing payment mandates (e.g., Direct Debit mandates).
- Associating all invoices and payment requests with a single payer entity.
- Customers may use customers standing to understand the credit control of that individual customer
Every invoice and payment request in Adfin is linked to a specific customerId.
2. Create an invoice
An Invoice represents a financial document issued to a customer—containing line items, taxes, account codes, and payment terms.
Invoices in Adfin support:
- Multiple line items with product, tax rate, and account code mappings.
- Full synchronisation with external accounting platforms, such as QuickBooks or Xero.
- Flexible billing metadata (due dates, references, PO numbers, etc.).
- Automatic status tracking (draft, issued, paid, failed, cancelled).
Invoices act as the source of truth for amounts owed. Adfin can also collect and send the PDF.
3. Collect payment
- Adfin schedules the Direct Debit or generates a hosted payment page for card/open-banking.
- Track status transitions (SCHEDULED → SUBMITTED → PAID) on the invoice or payment request.
4. Reconcile & settlement
- When funds are reconciled and settled via Adfin, you will receive webhooks for the events.
- Webhooks deliver near-real-time events for invoice and customer updates
- Remember, customers will also be using Adfin and Accounting software, so you should listen to events to update customers and invoices from Adfin to keep your system in sync.