💡 This guide covers:
Setting up a dedicated Adfin user in Actionstep
Adding your branding and reviewing your collection agents in Adfin
Adding your payment link to your bills
Connecting Adfin and Actionstep
Recording payments and choosing which bills come to Adfin
How bills and payments move between the two systems
Adfin is a payments platform for law firms in the UK and Ireland. Connecting Actionstep to Adfin lets you collect and reconcile your Actionstep bills through Adfin
Before you start
You'll need:
An Actionstep administrator at your firm, to add the Adfin user and change your bill templates.
A mailbox you can open for the Adfin user, such as a shared mailbox or an alias.
An Adfin account that has finished verification, and an Adfin login for whoever is doing the setup.
No other software connected. You can only have one active integration at a time.
Microsoft Word, to edit your bill template.
💡 If you're setting up with us in an onboarding session, it helps to have Step 1 done beforehand, so the Adfin user's password is set and, if you use MFA, its secret key is saved.
Step 1: Create a dedicated Adfin user in Actionstep
Adfin signs in to Actionstep as this user. Only Adfin should use this login, never a member of staff, so that:
receipts Adfin creates are easy to tell apart in your audit logs
payments keep being recorded when someone leaves or changes their password
💡 The Create user screen warns that a new user adds to your licence count, but Actionstep doesn't charge for the Adfin user once it's marked non-billable (see below).
Choose the user's system role
The Adfin user's system role needs the permissions below. Actionstep's default User role has them all, but your firm may have changed it, so please check.
Permissions | Where | What Adfin needs |
Application permissions | Admin > Users & permissions > System roles, then Edit next to the role | Workflow and Accounting switched on |
Data permissions | Admin > Users & permissions > Data permissions | Every permission under Accounting - Sale/Purchase Object, Accounting Document Uploader, Action table, Participant table, and Action Type for each of your matter types |
Menu permissions | Admin > Users & permissions > Menu permissions | Every permission under Actionstep_Main_Menu, Sales_Menu and Action_Details_Accounting_Menu |
You may want a role just for Adfin: to give it only these permissions, or because your User role's password policy makes passwords expire, which would stop Adfin signing in. Go to Admin > Users & permissions > System roles, click Create new System role, and pick a Password policy with no expiry.
Add the user
Please click the Admin icon (the tools icon at the top right), then Users & permissions.
Click Invite new user.
In Contact record, type Adfin Integration. As there is no contact with that name yet, click + Create New Contact.
Leave Identity type as Individual, enter Adfin as the first name and Integration as the last name, and click Save.
Fill in the rest of the form:
Email address: any address that nobody at your firm already uses to sign in to Actionstep. We suggest [email protected] or [email protected]. It needs to be a mailbox you can open, as Actionstep sends the user's invitation there.
Timekeeper initials: for example ADF.
System role: User, or the role you created for Adfin.
Click Save.
Email [email protected] with the Adfin user's name and email address, and ask them to mark its licence as non-billable.
Open the invitation email in the Adfin user's mailbox and set a password from the link (an Actionstep admin can't set it for you). Keep the email address and password to hand for Steps 5 and 6.
Set up multi-factor authentication (optional)
Adfin works with or without multi-factor authentication (MFA). If the Adfin user has MFA, Adfin needs its secret key, which Actionstep only shows during set-up, so please save it as you go.
After you set the password, Actionstep may ask you to set up MFA (you can't skip this if your firm requires it). To turn it on yourself, click your profile icon, choose Manage Profile and click Activate next to Multi-factor authentication.
Click Show secret key for manual configuration and copy the key. Save it somewhere safe that your team can get to, such as your firm's password manager. You will paste it into Adfin in Step 6.
Add the key to an authenticator app on your phone, such as Microsoft Authenticator or Google Authenticator, by scanning the QR code or typing the key in.
Enter the code your app shows in First code, wait for the app to show a new one and enter it in Second code, then click Save.
Please keep the phone with the authenticator app to hand for Steps 5 and 6.
Step 2: Add your branding in Adfin
Your clients see your branding on the emails Adfin sends them and on the payment portal they reach from your bills.
Please click Settings in the Adfin sidebar, then Branding, under Account.
Click Upload logo and choose your firm's logo.
If you have a square version of your logo, add it under Icon.
Check the Primary brand colour and Secondary brand colour.
Your changes save as you go.
Step 3: Review your collection agents
Each client in Adfin is assigned to a collection agent, which decides what Adfin sends them and when. Clients who come in from Actionstep are assigned to your default agent.
We recommend starting with nothing sent. When we set up your account, we make a No Chasing agent your default, with no communication steps and Auto Collect off, so Adfin doesn't contact your clients or collect payments when your bills first come in.
Once your clients are in Adfin (Step 6), move any you want chased to another agent. Open the client from Customers, go to the Collection agent tab, click Change agent and pick the agent.
If you send bills yourself from Actionstep, with your payment link on them (Step 4), remove the Initial delivery step from the agents you move clients to, so they don't get the bill twice. Any reminders you keep still go out as normal.
Step 4: Add your Adfin payment link to your bills
Every firm on Adfin has its own invoice payment portal: one link, such as https://app.adfin.com/portal/your-firm, that works for every bill. You add it to your Actionstep bill template once, and it appears on every bill you produce from then on.
When a client follows the link, they enter the name and postcode the bill is addressed to, and the invoice number. A bill only opens when all three match, so nobody can see another client's bill.
Switch on and copy your link in Adfin
Please click Payment, under Create in the Adfin sidebar.
Choose Invoice payment portal.
Under Authentication method, switch on Full Name + Invoice Number + Postcode.
Click Copy link.
Download your bill template
Actionstep bills are built from a Word template. To check which one you use, please go to Admin > Billing in Actionstep and look at Bill template in the Hourly invoices and Fixed fee invoices sections.
If it's one of Actionstep's built-in templates (Invoice, or Legal Invoice 1 to 4): scroll down to Custom bill templates, click Create new custom bill template, and under Template downloads click your template's name to download it.
If it's a custom template: click its name under Custom bill templates, then click the file under Current template to download it.
Add the link in Word
Please open the template in Microsoft Word and add a short line where clients will see it, for example just below the amount owing:
Pay this invoice online: Pay now. You will need the invoice number, name and postcode.
Link the words Pay now to your Adfin link, then save the file.
Upload the template and use it for your bills
Please go to Admin > Billing and, under Custom bill templates, click Create new custom bill template.
Enter a Template name, and a Description if you like.
Under Upload new template file, select the file you edited, and click Save.
To update a custom template you already use, open it from Custom bill templates, select the edited file under Upload new template file, and click Save.
Then, still in Admin > Billing, set Bill template to your new template in both Hourly invoices and Fixed fee invoices, and click Save.
The link appears on bills you produce from now on. Bills you have already produced keep their existing PDF. To check it works, open the PDF of your next bill and click the link: it should open your Adfin payment portal, showing your firm's name and branding.
Step 5: Connect Adfin and Actionstep
Please go to Settings > Integrations in the Adfin console and click + Connect on the Actionstep tile.
Sign in to Actionstep as the Adfin user you created in Step 1, not with your own login. Make sure you have logged out from your own Actionstep account. If the Adfin user has MFA, enter the code from your authenticator app.
Choose your organisation if you have more than one, and allow access.
You're brought back to Adfin, and the Actionstep tile shows Connected to and your organisation's ID.
Step 6: Set up the connection in Adfin
Once connected, you will land on the Actionstep settings page. You can come back to it at any time from Settings > Integrations, by clicking the three dots on the Actionstep tile and choosing Manage connection.
Record payments in Actionstep
In the Push payments back to Actionstep section:
Please click Set up.
Enter the email address and password of the Adfin user you created in Step 1.
If the Adfin user has MFA, switch on Configure MFA (Multi Factor Authentication) and paste the secret key into MFA secret key. Check the First code matches your authenticator app (the Second code is the one it shows next). You can skip the set-up steps listed on screen, as you did those in Step 1.
Click Connect & verify. Adfin checks the login works with the organisation you connected.
Once verified, the section shows Signed in as with the username, and the switch is on.
Choose which bills come to Adfin
Open Syncing invoices and choose:
All invoices: bills from every Actionstep matter come to Adfin.
Control by matter type: only bills from the matter types you select come to Adfin, for example only Conveyancing Purchase.
If you only want newer bills in Adfin, switch on Only import invoices from a particular invoice date onwards and pick a Start date. Bills with an invoice date before it don't come into Adfin, so you keep collecting them as you do today.
Before you save, please check your default agent is set up the way you want (Step 3). When you click Save changes, every approved bill that still has an amount owing comes into Adfin within a few minutes, older ones included unless you've set a start date.
Let clients find their bill by matter ID (optional)
Once you've saved your choice under Syncing invoices, your payment portal can ask clients for the matter ID and invoice number on their bill, instead of a name and postcode.
Please click Payment, under Create in the Adfin sidebar, and choose Invoice payment portal.
Under Authentication method, switch on Matter ID + Invoice Number. This switches off the name-based methods.
Please also change the line you added to your bill template in Step 4, so it tells clients they'll need the matter ID and invoice number, and check your bills show the matter ID (the number Actionstep gives the matter, not your own matter reference).
How it works day to day
Bills coming into Adfin
A bill comes into Adfin within a few minutes of being approved, as long as it has an amount owing. Drafts stay in Actionstep.
The invoice uses the Actionstep bill number, invoice date, due date and total. Any receipts already recorded against the bill come in as payments, so your client is only asked for what's still owing. Line items and the bill PDF stay in Actionstep.
Your client is added to Adfin as a customer, with their name, email address, phone number and mailing address. Their later bills are added to the same record.
What happens next follows the collection agent your client is assigned to (see Step 3 above).
If your client has no email address in Actionstep, the invoice still comes across but isn't sent. Add their email address to the customer in Adfin, then choose how the invoice is collected.
How your clients pay
Your client clicks the link on their bill, or in the email Adfin sends.
From the link on their bill, they enter the Name and Postcode the bill is addressed to and the full invoice number (or the matter ID and full invoice number, if you've switched that on), then click Continue.
They are taken to the bill and pay it using any of the payment methods you have switched on in Adfin.
Adfin emails your client a payment confirmation.
Payments going back to Actionstep
When a client pays, Adfin creates a client receipt in Actionstep against the bill:
The receipt is for the amount paid against the bill, so part payments are recorded as they come in.
It is dated the day of the payment, with the payment method set to Credit Card for card, Apple Pay and Google Pay, or EFT for bank payments and direct debits.
Direct debit payments are recorded once they have been collected successfully, which takes a few working days.
The memo starts Adfin payment for invoice, so Adfin receipts are easy to find in Actionstep.
Only payments on bills that came from Actionstep are recorded. Invoices you create directly in Adfin, and invoices you Mark as paid, are not sent to Actionstep. You will see Invoice imported from Actionstep and Payment synced to Actionstep in the invoice's activity in Adfin.
Receipts coming into Adfin
If a client pays you another way, for example by bank transfer, please record a client receipt against the bill in Actionstep as you normally would. Adfin picks it up within a few minutes:
A receipt for the full amount marks the invoice as paid, shown as Paid externally, and Adfin stops chasing it.
A receipt for part of the bill reduces the amount owing, and Adfin keeps chasing the rest.
Common questions
Why hasn't a bill appeared in Adfin?
Please check you've saved your choice under Syncing invoices (Step 6), and that the bill is approved and still has an amount owing. If you use Control by matter type, check the bill's matter type is one you selected. If you switched on Only import invoices from a particular invoice date onwards, check the bill's invoice date isn't before your Start date.A bill also won't come across if an invoice with the same number already exists in Adfin.
A bill won't come across if it belongs to a restricted matter. Actionstep only lets Adfin see a restricted matter if the Adfin user has been added to it, so please add the Adfin user to the matter in Actionstep.
My client says their details weren't recognised
Please check they entered the name exactly as it appears on the bill (the company name for a company client, rather than their own name), the postcode from the address on the bill, and the full invoice number. If you use Matter ID + Invoice Number, check they entered the matter ID and full invoice number from the bill. The bill also needs to be in Adfin, as above.
A bill was settled outside Adfin. How do I stop the reminders?
Please record the receipt against the bill in Actionstep as you normally would. Adfin picks it up within a few minutes and stops chasing once the bill is fully paid. If the payment won't be recorded in Actionstep, open the invoice in Adfin and use Mark as paid. There is more on this in My customer paid outside Adfin.
Can each bill have its own link?
Not at the moment. Your payment portal link is the same on every bill, and your client's details tell Adfin which bill they are paying.
Do I need to update every bill template?
Yes. Please add the link to each bill template your firm uses.
Do tax rates come across from Actionstep?
No. Each bill arrives as its total, with any tax already included.
If you have any questions, please get in touch via live chat, using the Get help button in the bottom left of the Adfin console.



















