Skip to main content

Managing Your Payees

The Payee module allows you to create, invite, upload, and manage your Payees.

Written by CashCloud Team

Payee Table

The Payee Table displays all the payees added to the system. Each payee entry includes columns for Name / Type, Email, Default bank account number and default payee address, Status, Deposit method, PayShift, and Payee ID.

Payee Statuses

The Status column in your payees table shows where each payee is in the onboarding process. If your company has enabled Vendor Business Verification, vendors and contractors will also display verification statuses once an onboarding invitation has been sent.

  • Created:The payee has been added, but an onboarding invitation has not been sent yet.

  • Invited: An onboarding invitation has been sent, but the payee has not completed onboarding yet. The payee will appear under the Pending invitations tab until they complete the process.

  • Onboarded: The payee accepted the invitation and completed onboarding.

The following statuses apply to payees with a payee type of Vendor or Contractor when Vendor Business Verification is enabled:

  • Verifying: Tax and business verification is in progress.

  • Verified: The payee has passed tax and business verification.

  • Restricted: Verification was not successful. Review the payee's tax information and consider resending onboarding.

You can filter your payees table by any of these statuses to quickly find payees that need attention.

Search and Filter

You can search for payees by Name or Email. You can also apply filters to narrow down your results. The available filters are Payee name, Payee type, Status, Deposit method, PayShift, and Payee ID.

The Payee ID filter matches the full ID exactly and is not case sensitive. You can select more than one ID at a time. This filter is available on the Payees tab only, not on Pending invitations.

Manage Columns

You also have the option to re-order the columns, as well as to hide or unhide them as you wish.

Creating Payees

There are 3 ways in which you can add payees into CashCloud: by manually creating them, by inviting them via email, and by uploading them with an excel file.

Additionally, if you have set up a data group integration, whenever you import your payments, a new payee will be automatically created or updated in this module. Refer to the Payee Settings section to learn about our merge configuration options.

Option 1: Create Payees

To create a new payee, click the New Payee button and select the Create payee option.

This will bring you to a page where you can start entering the payee information, organized by the following tabs:

  • Basic information

  • Bank accounts

  • Address

  • PayShift

Keep in mind that fields with an asterisk (*) are mandatory.

Basic information

In here you can enter the following details:

  • Payee Name 1: The primary name of the payee.

  • Payee Name 2: An optional secondary name for the payee.

  • Email: The email address of the payee.

  • Payee Type: Select the type of payee from the dropdown menu (e.g., Vendor).

  • Payee ID: A unique identifier for the payee.

  • Country Code and Phone Number: The contact details of the payee.

Bank accounts

In this tab you can enter up to 10 bank accounts for this payee. To enter a new one, click on the "Add new bank account" button and enter the following information:

  • Account Number: The payee’s bank account number.

  • Routing Number: The payee’s bank routing number.

You can choose to make this bank account the default one for all future payments.

Address

You can manage a number of different addresses for one payee. To enter a new one, click on the "Add new address" button and enter the following information:

  • Address Line 1

  • Address Line 2

  • Country

  • State

  • City

  • Zip Code

You can choose to make this address the default one for all future payments.

PayShift

In this tab you can enable or disable PayShift. PayShift is a service that automatically changes the payment type of a transaction based on the selected deposit method.

In you enable PayShift, you can also select a preferred deposit method for this payee. If you do so, the next time you upload or create a payment to this payee, it will automatically be switched to this deposit method.

Option 2: Invite Payees

To invite payees to join the platform, click the New Payee button and select the Invite payees option. This opens a form where you can:

  • Enter the email addresses of the payees. Each email address should be separated by a comma or hit enter. You can invite up to 10 payees at a time.

  • Select deposit methods: Choose the deposit methods you want to make available to your payees. If you’d like to require a specific deposit method, like ACH, select only that option. This ensures that payees will only see ACH as their available deposit method during onboarding.

Inviting payees initiates the Payee Onboarding process to verify their profile details and deposit method/bank details. Once the invitation has been sent, the payee will show up under the Pending invitations tab.

Option 3: Upload Payees

To import multiple payees, you can upload an Excel file with the required columns. The system allows up to 12 fields, with the only required field being the name. To ensure proper data mapping, please use the same Column Titles as the ones found in the example file (click on Download Example).

Payee Settings

Under Payee Settings you can configure how your payee's Basic Information data is merged into CashCloud from your data source. Basic Information covers Payee Name 1, Payee Name 2, Email, Payee ID, Country Code, and Phone Number. You can access it by clicking on the gear icon at the top right corner of the Payee module.

This setting applies to payee data arriving from a data source: bulk payee uploads, payment imports, and data group imports. It does not apply when you create or edit a payee by hand in CashCloud. Payee Type is never changed by an import, regardless of which option you choose.

How CashCloud matches payees

When payee data comes in from a file or an integration, CashCloud first checks whether each incoming record already exists, so it knows whether to create a new payee or update one you already have.

  • If the record has a Payee ID, CashCloud matches on the combination of Payee ID and Payee Name. Both have to match.

  • If the record has no Payee ID, CashCloud matches on Payee Name on its own.

Small differences in a name will not stop a match. Punctuation and titles such as "Dr" are ignored. Suffixes such as Jr and Sr are not ignored, because they often tell two people apart.

If the same payee appears on more than one row of a single file, CashCloud combines those rows into one payee record instead of creating duplicates. Any different bank accounts or addresses across those rows are all saved to that one record.

⚠️ Important: If two different people share the same name and neither has a Payee ID, CashCloud treats them as the same person and combines them into a single record. Assigning a unique Payee ID to every payee in your ERP, flat file, or other data source is the only reliable way to keep them apart.

If you create or invite a payee by hand in CashCloud, we recommend adding a Payee ID then too, so the payee can be matched accurately in future imports.

Option 1: Merge (Preserve Existing Data)

CashCloud keeps the Basic Information already in the system as the source of truth. If the imported file has new information in fields that are currently empty, CashCloud fills those in, but it will not overwrite any value you already have.

Option 2: Overwrite (Replace with Imported Data)

CashCloud replaces existing Basic Information with the values from the imported file. The imported data always takes priority, even when a different value is already saved.

Overwrite applies to empty values too. If a column in your file is left blank, the matching field on the existing payee is cleared. If you only want to fill in missing details without losing anything, use Merge instead.

Option 3: Do Nothing (Skip Updates)

CashCloud ignores the imported changes and keeps all existing Basic Information exactly as it is. No Basic Information is added or modified.

Payee Actions

From the Payees module, you can take several actions on selected payees by clicking on the 3 dots at the right of the table.

You can also select one or more payees to take bulk actions.

The available actions differ between Active Payees and Pending Payees.

Actions for Active Payees

Active Payees are those payees with status Created or Verified and are located in the Payees tab. You can perform the following actions for these payees:

  1. View payee: Opens the payee information where you can view and edit (if you have the right permissions).

  2. Initiate onboarding: Sends an email to the payee to initiate the Payee Onboarding process. This allows them to verify their profile details and deposit method/bank details.

  3. Resend onboarding: If a payee has already completed onboarding, you can resend the onboarding invitation. This is helpful if you want the payee to verify their information again or add a different bank account.

  4. Set deposit method: Allows you to set or change the default deposit method for the selected payee. If you have PayShift active, CashCloud will automatically switch the payment method to this prefered one.

  5. Enable/disable PayShift: Toggles the PayShift setting for the selected payee.

  6. Delete payee: Permanently removes the selected payee from the system.

Actions for Pending Payees

Pending Payees are payees who have been invited to join CashCloud but haven’t completed onboarding yet. These payees appear in the Pending Invitations tab.

For payees in this status, you can take the following actions:

  • View payee: Opens the payee’s profile, where you can review their information and make edits.

  • Resend invitation: Sends a new onboarding invitation to the payee. Invitation links expire after approximately 48 hours, so use this option if the payee hasn’t accepted the invitation within that time.

  • Cancel invitation: Cancels the existing invitation, preventing the payee from onboarding through the email link. Once canceled, the payee will move from the Pending Invitations tab to the Payees tab, and their status will revert to Created.

Handling Multiple Bank Accounts and Addresses

Payees can have multiple bank accounts and addresses saved in CashCloud.

If a payee has only one bank account or one address on file, that record is automatically set as the default. If they have more than one, you can choose which one should be marked as the default.

The default bank account is automatically selected when you create a manual ACH payment, but you can always switch to a different saved account if needed. Similarly, the default address will be used when creating payments that require a mailing address, such as checks.

If a payment goes through PayShift and the payee chooses ACH, the payee may also select which saved bank account should be used for that payment. They can also choose to make that account their default for future ACH payments. If the payee adds or connects a new bank account during the PayShift flow, the new account is saved to their profile and automatically becomes the default bank account.

If you import a payee file that includes new bank account or address information, the new record will be added to the payee’s profile. However, the existing default selection will not change automatically.

👀 Note: When importing payments, CashCloud will use the bank account or address information provided in the payment file. If it differs from what is saved in the payee’s profile, CashCloud will add the new information to the payee's record.

Bank accounts and addresses are displayed in separate tables within the payee profile. For bank accounts, you’ll see the last four digits of the account and routing numbers, along with a Source column indicating whether the information was entered manually or imported. The default account is clearly identified.

For addresses, the table includes Address Line 1, Address Line 2, City, State, Country, and Zip Code, and also indicates which address is set as the default.

You can update or change the default bank account or address at any time by clicking on the overflow menu and selecting the "Make this the default" option.

Did this answer your question?