Overview
The Payment Details tab on an agency detail page is where your team records and maintains the bank account you remit commission payments to for that agency. You can drop in a voided cheque and have the routing number, account number, holder, and bank details read off the image automatically, or type the same fields in by hand when no cheque is available.
What is the Payment Details Tab?
Payment Details is the per-agency commission-banking record stored on the agency relationship. It pairs the bank-account fields with the source cheque image (or a cheque PDF Turris generates from what you typed) so you can verify, re-download, and reference the account during onboarding and reconciliation.
Who uses it. Accounts-payable, operations, and onboarding owners at MGAs and carriers who need to confirm where commission payments should land before the first statement cycle, and who update banking details when an agency switches accounts.
It lets you:
Capture an agency's bank account by uploading a voided cheque, so the routing number, account number, account holder name, and financial institution name are extracted from the image automatically.
Enter the same bank details by hand when no cheque image is available, in which case Turris generates a payment cheque PDF from the values you type.
Update a previously captured account when the agency changes banks, corrects extraction mistakes, or sends a fresh cheque.
Open or download the cheque on file to attach to an internal ticket or reference during a reconciliation call.
See at a glance whether automated extraction succeeded, so you know whether to trust the stored fields or correct them.
Keep the account number encrypted at rest and masked on screen, so casual viewers cannot read it without explicitly revealing it.
Accessing Payment Details
Open Left sidebar → Agencies, click the row for the agency you want to manage, then click the Payment Details tab in the tab bar above the main panel.
When a payment record exists, the tab shows a Bank Account Details card with these fields:
Field | Description |
Account Number | The bank account number used for commission payments. Stored encrypted; displayed with all but the last 4 digits masked. Click the eye icon next to the value to reveal the full number, click again to re-mask. |
Routing Number | The financial institution's ABA routing number (typically 9 digits). |
Account Holder Name | The legal name of the entity that owns the account (usually the agency's corporate name). |
Account Holder Address | The address tied to the account holder, formatted as |
Financial Institution Name | The bank or credit union that holds the account. |
Financial Institution Address | The branch address on record for the bank, formatted the same way as the account holder address. |
Data Extraction Status | A colored badge showing how the most recent cheque upload was processed. See Data Extraction Status below for what each value means. |
If no payment details have been captured yet, the card is replaced by a No Payment Details Available notice: "No payment details have been provided yet. Upload a voided cheque or enter bank account details manually". The Actions dropdown stays visible above the notice so you can add the details.
Note: When the agency relationship has been deleted, the Actions dropdown is hidden and the tab becomes read-only. Restore the agency relationship before you can capture or update payment details.
Capturing and Updating Payment Details
Every capture, update, view, and download action lives behind the Actions dropdown at the top-right of the Payment Details card.
Upload Cheque
When you'd do this. You've received a scanned voided cheque from the agency during onboarding (or after a banking change) and you want Turris to read the routing, account, and bank-name fields off the image so you don't have to type them.
Click Actions and choose Upload Cheque.
The Upload Cheque slide-over opens with the notice "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".
Drag and drop the cheque into the file area, or click to browse. Accepted file types are .jpg, .jpeg, .png, and .pdf.
Click Upload. The file is saved against the agency, the data-extraction service runs against it, and the request waits up to 20 seconds for extraction to finish before the slide-over closes.
Tip: Use a cheque drawn on the agency's corporate operating account. Personal cheques, deposit slips, or photos that crop out the MICR line along the bottom either fail extraction or pull the wrong numbers.
Note: If extraction takes longer than 20 seconds, the upload still succeeds; the Data Extraction Status badge shows queued or processing. This tab does not auto-refresh, so reload the page or switch tabs and back to see the final status.
Add Details or Update Details
When you'd do this. You don't have a cheque image to upload (the agency only sent a wire-instruction letter, for example), or extraction read one or more fields incorrectly and you need to fix them. The same option reads Add Details when no record exists yet and Update Details when one does.
Click Actions and choose Add Details (or Update Details).
The Add Details / Update Details slide-over opens, prefilled with whatever is currently on file. A help icon next to the Address Requirements heading explains that, to store a complete address, you should fill in Street Address (Line 1), City, State, and ZIP Code.
Fill in or correct the form across its three sections.
Account Details
Field | Required | Description |
Routing Number | Yes | The bank's ABA routing number. Digits only; no spaces, dashes, or letters. |
Account Number | Yes | The commission deposit account number. Digits only, between 5 and 17 digits. Hidden by default; click the eye icon in the field to reveal what you're typing, click again to hide. |
Financial Institution Details
Field | Required | Description |
Financial Institution Name | Yes | The bank or credit union name. Example: |
Bank Street Address | No | Street line for the bank branch. Example: |
Address Line 2 (Optional) | No | Suite or floor. Example: |
City | No | Bank city. Example: |
State | Conditional | Two-letter state, picked from the dropdown. If the form can't resolve a valid state for the address, it blocks submission with "State is required", so pick a state to continue. |
ZIP Code | No | 5- or 9-digit ZIP. Example: |
Holder Details
Field | Required | Description |
Account Holder Name | Yes | Legal name on the account. Example: |
Address Line 1 | No | Street address for the account holder. Example: |
Address Line 2 (Optional) | No | Suite or unit. Example: |
City | No | Account holder city. |
State | Conditional | Two-letter state, picked from the dropdown. Same "State is required" rule as the bank address. |
ZIP Code | No | Account holder ZIP. |
Click Submit.
When no payment record exists yet (Add Details), Turris generates a cheque PDF from the values you entered and stores it as the agency's cheque on file. The account number is encrypted before it is saved.
When a record already exists (Update Details), Turris replaces the stored bank-account values with what you submitted (the account number is re-encrypted) and keeps the previously stored cheque image as-is.
Tip: After uploading a cheque, come back to Update Details to spot-check the extracted values against the image. Extraction is reliable but not infallible; names with unusual punctuation and handwritten endorsements are the most common mismatches.
View Cheque
When you'd do this. You're on a reconciliation call or working an internal ticket and need to see the cheque on file without leaving Turris.
Click Actions and choose View Cheque. The stored cheque opens in a new browser tab. The option is available once a cheque exists, whether one you uploaded or the PDF Turris generated from manually entered details, and is greyed out only before any payment details have been captured.
Download Cheque
When you'd do this. You need to attach the cheque to an email, a finance-system ticket, or your own document store.
Click Actions and choose Download Cheque. The stored cheque downloads to your machine. Like View Cheque, it's greyed out only before any payment details exist.
Data Extraction Status
After a cheque is uploaded, the document-extraction service reads the image and fills in the bank-account fields. The Data Extraction Status badge on the Bank Account Details card reports where that processing has reached. Details entered by hand never run extraction, so they stay at not-started.
Color | Status | Meaning | What to do about it |
Gray | not-started | The cheque is stored but extraction has not begun, or the details were entered manually (nothing to extract). | For an upload, wait a few seconds and reload. If it stays |
Yellow | queued | The cheque is waiting in the extraction queue. | No action needed; reload to see when it advances. |
Yellow | processing | Extraction is currently running. | No action needed; reload to see the result. |
Green | success | Extraction completed and the bank-account fields were populated from the cheque. | Verify the populated values against the image (Actions → View Cheque) and correct any mismatches with Update Details. |
Red | error | Extraction failed. The fields keep the placeholder dashes written when the cheque was first stored. | Use Update Details to type the bank fields in by hand, or re-upload a clearer scan with Upload Cheque. |
The upload request waits up to 20 seconds for extraction before returning to your screen. If it takes longer, the upload still succeeds, but the badge will not refresh on its own, so reload the page or switch tabs and back to see the final status.
Frequently Asked Questions
Why is the account number masked? Account numbers are encrypted at rest and rendered with all but the last 4 digits hidden so passers-by can't read them off your screen. Click the eye icon next to the value (on the card and in the entry form) to reveal the full number; click again to re-mask.
What file types can I upload as a cheque? JPG, JPEG, PNG, and PDF. Other formats are rejected at upload.
What happens to the existing cheque if I upload a new one? The new file is saved as a new version of the cheque record. Later View Cheque and Download Cheque actions return the latest version. The earlier image is retained internally for audit purposes but is not surfaced in the UI.
I entered details by hand, so why is there still a cheque to view and download? When you use Add Details with no prior record, Turris generates a cheque PDF from the values you entered and stores it as the cheque on file. That generated PDF is what View Cheque and Download Cheque return.
Why does the data look wrong after an upload? Extraction occasionally misreads cheques with unusual fonts, handwriting, low scan resolution, or non-standard layouts. Use Update Details to correct any field, including the holder and financial institution addresses. The cheque image itself is unchanged.
Why is the Actions menu missing? The Actions dropdown is hidden when the agency relationship has been deleted, and Payment Details becomes read-only. Restore the agency relationship if you need to capture or update details.
Can I delete payment details? There is no destructive delete in the UI. To remove obsolete data, upload a replacement cheque or use Update Details to overwrite the stored values with the correct ones.
What happens if I forget to set the State for an address? If the form can't resolve a valid state for an address you're entering or editing, it blocks submission with "State is required". Pick a state from the dropdown to continue. The other address parts are optional.
Best Practices
Capture payment details before the first commission cycle. Treat it as a checklist item during agency onboarding so commission payments aren't held up waiting for banking information.
Prefer Upload Cheque over manual entry whenever a cheque is available. Storing the image alongside the parsed fields gives you a source of truth to verify against later, and extraction handles the typing for you.
Always spot-check extracted values. After Data Extraction Status lands on success, open View Cheque and compare the parsed account number, routing number, and holder name against the image. Correct any mismatch with Update Details.
Pick a State whenever you enter an address. It's the one address field the form can block on and is the most common reason a submission fails.
Re-upload, don't re-key, when the agency changes banks. A fresh cheque scan keeps the visual record in sync with the stored fields and lets extraction do most of the work.
Reload after an upload that ran long. The status badge does not poll on its own, so refresh the tab to confirm extraction finished before relying on the parsed fields.
Related Pages
Agencies - List view of every agency you distribute through, with onboarding progress, NIPR sync status, and entry points into each agency's detail tabs.
Agency Overview - Landing tab for an individual agency with a one-glance summary of onboarding status, agreement state, license and appointment coverage, and the agent roster.
Agency Tab (Agency Detail) - Core agency profile: identifying details, contacts, legal and mailing addresses, resident-state licensing, and NPN lookup controls.
Agency Contacts - Roster of people at the agency including relationship owner, signatory, and compliance contact; drives invitations and signatory routing.
Agency Documents - Storage for E&O, Cyber, Crime & Fidelity, W9, and other onboarding documents collected for the agency.
Agency Agreements - Producer Agreement and supporting contracts for the agency, including signing and replacement workflows.
Agency Notes - Shared auto-saving notebook for free-form context about the agency relationship.
AML/OFAC Watchlist Screening - Sanctions and watchlist screening for the agency, including one-off checks and continuous monitoring.
Agency Detail: Agents Tab - Producer roster for the agency with NIPR lookups, contact fixes, and per-agent compliance drill-down.
Agency NIPR Addresses - Every address NIPR has on file for the agency, one row per state and address type.
Agency NIPR Contacts - Business email, phone, and fax that NIPR has on file for the agency by state.
Agency Detail: NIPR Continuing Education Tab - Per-agent CE status, renewal dates, and outstanding credits sourced from NIPR.
Agency Detail: PDB Report Tab - Read-only Producer Database snapshot consolidating firmographics, addresses, contacts, licenses, appointments, and regulatory actions.
Agency Detail: Question Responses Tab - Read-only view of the agency's answers to the custom onboarding questions configured for your organization.
Agency Product+and+State+Selection - Which of your products the agency is requesting authority for and in which states.
Requested Authority - Map of states each product has been requested in for the agency versus where authority already exists.
Agency Licenses - Per-product, state-by-state license and appointment compliance dashboard for the agency.
Agency Detail: E&O/Cyber Policies Tab - E&O, Cyber, and Crime & Fidelity policies assigned to the agency with replacement and re-upload workflows.
Regulatory Actions - Disciplinary history for the agency and its agents.
Agency Appointments: Agency Tab - State-by-state map for managing carrier appointments at the agency (firm) level.
Agent Appointments by State - Per-agent state-and-product carrier appointment management.
Agency Authority: Agency Tab - Map for granting and revoking the agency's state-level permission to sell each product.
Agency Authority: Agents Tab - Per-product, per-agent state authority and license footprint reconciliation.
Need Help?
If you have questions about Payment Details or encounter any issues, contact our support team at support@turris.com.