Overview

The Payment Details panel in Agency Onboarding settings is where you decide whether every agency you invite must hand over their banking information before they finish onboarding. Turn the step on when you want commission payment details on file from day one; turn it off when you collect that information through a different channel.

What is the Payment Details Onboarding Step?

The Payment Details setting is a single on/off switch that adds (or removes) a banking-information step from the agency onboarding journey. When the step is on, every invited agency is asked to upload a voided cheque (or complete a guided form) so Turris can capture their account number, routing number, account holder details, and financial institution before onboarding completes.

Who uses it. Operations leads, onboarding managers, and licensing administrators at carriers, MGAs, and wholesalers who need agency bank details captured upfront to pay commissions, set up ACH, or satisfy an internal control. The toggle is organization-wide, so whoever owns Agency Onboarding settings decides on behalf of every team that invites agencies.

This setting lets you:

Add or remove the Payment Details step from the onboarding journey for every agency you invite going forward
Require invited agencies to upload a voided cheque image or PDF, then let Turris extract their bank details automatically
Give agencies a manual fallback when no cheque is available, in which case Turris generates a cheque PDF from the typed values
Capture account number, routing number, account holder name and address, and financial institution name and address in a single onboarding pass
Review, view, and download the captured cheque from each agency's record after they submit

Accessing the Payment Details Setting

The setting lives inside the global Settings modal, which can be opened from anywhere in the application.

Click Settings (the gear icon) in the Left sidebar.
The Settings modal opens. In the left-hand list, find the Organization group and click Agency Onboarding (the envelope-with-plus icon).
Under Agency Onboarding, click Payment Details (the credit-card icon).
The Payment Details panel loads inside the modal.

What's visible on the page

Element	Description
Payment Details Step info banner	Bordered message box at the top, titled Payment Details Step, that reads: "In the payment details step your invited agencies must upload a cheque so that their payment details can be extracted automatically and stored securely."
Payment Details heading	Section heading for the configuration row below it.
Use this Onboarding Step? label	Label for the single setting on the page.
Help popover	A question-mark icon next to the label. Hover or click to read: "When enabled, invited agencies must upload a cheque so that their payment details can be extracted automatically and stored securely."
Toggle	Pill-shaped on/off switch on the right side of the row. Off (gray) means the step is excluded from onboarding; On (primary color) means the step is included.

The panel has no Save button. Changes apply the moment you click the toggle.

Enabling or Disabling the Payment Details Step

When you'd do this. You want to start collecting banking details for every newly invited agency as part of onboarding, or you want to remove that step because you already capture payment information elsewhere.

Open the Settings modal from the Left sidebar.
In the Organization group, expand Agency Onboarding and click Payment Details.
Click the Use this Onboarding Step? toggle to switch it on or off.
The change saves immediately. A success notification appears with the heading Success and the message "Onboarding settings updated successfully".

Tip: There is no separate Save button on this panel. Each click on the toggle commits the new value right away. If you change your mind, click the toggle again to revert.

Note: If you do not have permission to update Agency Onboarding settings, the toggle snaps back to its previous value and a red error appears: "You do not have permission to update onboarding settings." Ask an administrator at your organization to update the toggle or grant you the permission.

How invited agencies experience the step

When the toggle is on, each agency you invite sees a Payment Details stage inside their onboarding wizard with the heading Bank Account Details and the instruction "Upload a cheque to automatically extract bank account details or enter them manually." From a Payment Details dropdown they choose one of two flows:

Upload Cheque (content: "Upload a scanned copy of your voided cheque") opens a cheque-upload slide-over. The agency uploads an image (JPG/PNG) or PDF of a voided cheque. The slide-over reminds them: "Please upload an image or PDF of a voided cheque from the corporate bank account where you would like us to deposit your commission payments." They click Upload, and Turris reads the cheque and extracts the bank details automatically.
Add Details (or Update Details if details already exist; content: "Manually fill in bank account details") opens a slide-over titled Add Details / Update Details with three sections:
- Account Details: Routing Number, Account Number (with a hide/show eye icon for masking)
- Financial Institution Details: Financial Institution Name, Bank Street Address, Address Line 2 (Optional), City, State, ZIP Code
- Holder Details: Account Holder Name, Address Line 1, Address Line 2 (Optional), City, State, ZIP Code
When the agency clicks Submit, Turris generates a cheque PDF from the entered values and stores it alongside the captured data.

When the toggle is off, newly invited agencies never see a Payment Details stage. Agencies who have already completed Payment Details (or who already have banking information on file) keep that information unchanged.

Where the submitted payment details appear

Once an agency completes the step, your team can view and manage their payment details from the agency's record.

Open Left sidebar → Agencies, then click the agency.
Open the Payment Details tab on the agency's record.
The Bank Account Details section shows the captured data. Each field renders as a label/value pair:

Field	Description
Account Number	Masked by default; click the eye icon to reveal the full number.
Routing Number	The bank's ABA routing number.
Account Holder Name	The legal name on the bank account.
Account Holder Address	Street, city, state name, and ZIP, comma-joined.
Financial Institution Name	The name of the bank or credit union holding the account.
Data Extraction Status	A status badge indicating whether Turris finished extracting bank details from the cheque image. See the status table below.
Financial Institution Address	Bank's street, city, state name, and ZIP, comma-joined.

Use the Actions dropdown at the top-right of the tab to Upload Cheque, Update Details (or Add Details if none exist), View Cheque (opens the cheque file in a new tab), or Download Cheque (downloads the file). View Cheque and Download Cheque are disabled when no cheque file is on record. The Actions dropdown is hidden entirely when the agency relationship has been removed.

Data Extraction Status

When an agency uploads a cheque, Turris reads the image and the agency's Payment Details tab shows a Data Extraction Status badge. Use the color and label to tell whether the extracted values are ready to rely on.

Color	Label	Meaning	What to do about it
Gray	not-started	No extraction has begun yet for this cheque.	Usually transient right after an upload. Refresh the tab; if it persists, re-upload the cheque or enter the details manually with Add Details.
Yellow	queued	The cheque is waiting in line to be processed.	Wait a moment and refresh the tab. No action needed.
Yellow	processing	Turris is actively reading the cheque image.	Wait for processing to finish, then refresh to see the extracted values.
Green	success	Extraction finished and the bank details were captured.	Confirm the extracted Account Number, Routing Number, and addresses are correct before relying on them for payment.
Red	error	Turris could not extract the details from the image.	Upload a clearer image or PDF of the voided cheque, or use Add Details to enter the values manually.

Permissions

Role	Can view this panel	Can change the toggle
Administrator with Agency Onboarding settings access	Yes	Yes
Member without Agency Onboarding settings access	Yes (read-only)	No. The toggle reverts and a permission error appears.

The same permission gates the write actions on each agency's Payment Details tab. Members who can read but not update can still view captured payment information and use View Cheque / Download Cheque, but the Upload Cheque and Update Details / Add Details actions are blocked.

Note: Agency Onboarding settings are part of a feature set that not every plan includes. If you do not see Agency Onboarding in your Settings list, your organization's plan may not include onboarding configuration. Contact your administrator or our support team.

Frequently Asked Questions

What happens to agencies that already finished onboarding before I turned this step on? Existing agencies are not retroactively asked to complete the Payment Details step. To capture their information now, open the agency's Payment Details tab and use the Actions dropdown to upload a cheque or add details manually.

Does turning the toggle off delete any payment information we already collected? No. The toggle only controls whether the onboarding wizard prompts new agencies for payment details. Anything already stored on an agency stays on the agency's record and remains accessible from the Payment Details tab.

How does the automatic extraction work? When an agency uploads a voided cheque, Turris reads the image and extracts the account number, routing number, account holder name and address, and the financial institution's name and address. The captured values are visible to your team on the agency's Payment Details tab, along with a Data Extraction Status badge that tells you whether the read succeeded.

What if an agency does not have a voided cheque to upload? The step offers an Add Details option that lets the agency type the bank account information directly into a form. Turris generates a cheque PDF from those values and stores it alongside the entered details, so the agency's record still has a downloadable cheque artifact.

Can I require Payment Details for some agencies but not others? No. The toggle is organization-wide. It either enables the step for every invited agency or disables it for every invited agency. There is no per-agency override on this panel.

Why did the toggle snap back to its previous value when I clicked it? You do not have permission to update Agency Onboarding settings, so the change was rejected. A red error message appears explaining that the change was not saved. Ask an administrator to update the toggle on your behalf or grant you the permission.

Where do I see the cheque file an agency uploaded? Open the agency's Payment Details tab, click Actions, and choose View Cheque to open the file in a new tab, or Download Cheque to save it locally. Both options are disabled if no cheque is on record.

Best Practices

Decide on the step before you start inviting agencies. Turning the toggle on after agencies have already completed onboarding means you have to chase their payment details manually through the Payment Details tab rather than capturing them in-wizard.
Prefer the Upload Cheque path over manual entry. An actual voided cheque gives Turris a source document to extract from and store, which is invaluable for audit, dispute resolution, and verifying an account in the future.
Coach agencies to confirm the extracted values. Automatic extraction is fast but not infallible. Encourage agencies to compare the on-screen values against the cheque image before clicking Submit to avoid downstream payment errors.
Watch the Data Extraction Status badge. A red error badge means the values were not captured; re-upload a clearer cheque or fall back to Add Details rather than assuming the data is on file.
Communicate toggle changes to your onboarding team. Anyone who guides agencies through onboarding should know whether a Payment Details step will appear in the wizard, so they can answer questions and chase missing fields.
Keep the step enabled if you pay commissions through Turris-linked workflows. Capturing payment details at onboarding ensures the information is on file before the first commission cycle, which avoids payment delays at month-end.

Agency Onboarding: Upload Documents - controls whether invited agencies must upload E&O, W9, and Cyber Policy documents during onboarding, and whether the Cyber Policy is optional.
Agency Onboarding Settings: Product and State Selections - controls whether invited agencies must select distribution authority and operating states for each of your products during onboarding.
Agency Onboarding: Custom Questions - drag-and-drop builder for adding your own questions and input fields to the onboarding wizard.
Agency Onboarding: Pre-Contract Review - adds a manual review checkpoint so your team can validate an agency's submission before the producer agreement is sent.
Settings: Template Agreements - upload and manage the producer agreement templates Turris uses when inviting agencies as distribution partners.
Settings: Products & Compliance - define the products you distribute and the state-by-state license and appointment requirements that govern who can sell each one.
Settings: Business Rules - organization-wide defaults that govern policy coverage evaluation, automation for newly added agencies, and licensing verdict calculation.
Users (Settings) - manage who has access to your organization in Turris and what permissions each user holds.
Settings: Security - apply organization-wide authentication controls, including SMS-based multi-factor authentication.
Settings: Personal Notifications - choose how Turris notifies you about activity across your distribution network.
Settings: Email Domain - register a custom domain so outgoing emails are sent from your own organization's domain.
Settings: Integrations - connect Turris to third-party tools such as HubSpot so agency data stays in sync.
Settings: Webhook - register HTTPS endpoints that receive automated notifications when key compliance events occur.
API (Settings) - generate and manage credentials for backend-to-backend integrations and browser-only access tokens.