Search payee information
The "Payees" tab in the Tipalti Hub allows you to browse or search for specific payees and track their payment and operational history in Tipalti. You can also manage Supplier Hub payees from this tab.
You must be assigned the View Payees user role for the "Payees" tab to display. Additional user roles are required to view sensitive information and perform various actions. For example, the View Secure Details role is required to view sensitive information, such as the payee's Social Security Number that is otherwise masked by asterisks, and the Update Payee user role is required to update payee tax and personal information.
Select the following topics to reveal how-to steps.
Required user role View Payees
Search for the payee record to view payee information, which is grouped into GENERAL, CONTACT, PAYMENT DETAILS, and TAX INFO sections.
The subtabs on the record show additional information for the payee, such as payments, bills, documents, etc. You can download this information by clicking at the end of the header row.
- Click the "Payees" tab.
- In the search bar, type one of the following identifiers:
- ID*
- Name*
- Alias*
- Company name*
- Email address
- Invoice number
- Payment refcode
- Bill refcode
*Type the first few characters to display a list of potential matches from which you can select.
You can also use the elastic search capabilities as follow:
- Search of 1 character in "IDAP" and "Alias" fields, and of 2 characters in Names fields ("First Name", "Middle Name", "Last Name", "Company Name")
- Search of special characters (&,'.) in the "Alias" field
To edit payee information, see Update payee information.
Required user role View Payees
Payee contact information (e.g., payee type, full name, alias, company, address, etc.) displays on the payee record.
- Search for the payee.
- Refer to the CONTACT row for payee information.
- At the end of the row, click
to reveal further information.
Required user role View Payees
The payee record shows the payee's payable and account statuses. Payable payees have complete and valid account configurations. If there are unpayable payees, you can view the reason why they are unpayable.
- Search for the payee. The payee's information displays below the search bar.
- You see the following two statuses.
- "Payable" status:
- Displays beside the payee name (If the payee is payable, the status appears in a green box.)
- If the payee is unpayable, the status appears in an orange box. Hover over
beside the status to see a tooltip display the reason why the payee is not payable (see Unpayable reasons below).
- Account "Status":
- Displays in the GENERAL row
- The account "Status" indicates whether the payee's account is active, blocked, suspended or closed.
- To find the reason why the payee's account is blocked, hover over
beside the status to see a tooltip display the reason.
- "Payable" status:
Unpayable reasons
The following table describes the reasons why a payee may not be payable. The iFrame refers to the iFrame/ Supplier Hub.
Reason |
description |
---|---|
Address | The payee's address is invalid. |
Analyzing latest updates | Due to updates, the payability status is under calculation and not yet determined. |
Certificate of No U.S. Activities has expired | The payee's Certificate of No U.S. Activities has expired. |
Country is not supported | The payment country selected by the payee is not supported. |
Currency is not supported | The currency selected by the payee is not supported. |
Document uploaded by payee, but it hasn't been reviewed yet | The payee has uploaded the required document to the iFrame, but it has yet to be reviewed by the payer. |
Hold | The payee has selected "Hold my payments" in the iFrame. |
Last payment failed | The payee's last payment transaction failed. |
Missing payment method details | Details about the payee's payment method are missing (i.e., the payee has not completed these fields in the iFrame). |
No documents provided for compliance review | The payee has not provided the required documents for compliance review. |
No PM | The payee has not selected a payment method in the iFrame. |
Paid amount not in range | The amount to be paid to the payee is not in the required range. |
Payee account is closed | The payee's account is closed (i.e., not active). |
Payee blocked | The payee has a status of "Blocked". |
Payee currency is not selected | The payee has not selected a payment currency in the iFrame. |
Payee is blocked by Tipalti | The payee was blocked by a Tipalti operator. |
Payee record is missing | The payee's review record is missing. For example, if there are existing payees and Tipalti then activates the payee review feature (which screens payees during registration in the iFrame), the existing payees will not have a review status because they have already registered in the iFrame. |
Payee record is pending payee update | The payer has requested that the payee update the information in the iFrame and the payee has not yet made the updates. |
Payee record is pending review | The updates the payee made in the iFrame are pending review by the payer. |
Payee record was declined | The updates the payee made in the iFrame have been declined by the payer. |
Payee suspended | The payee has a status of "Suspended". |
Payer ToS not signed | The payer's Terms of Service have not been signed. |
Pending Compliance Review | The payee is pending compliance review. |
Pending tax form approval | The payee's tax form is pending approval. |
PM is not supported | The payee's selected payment method is not supported. |
Required documents were not provided | The payee has not provided the required documents. |
Tax | The payee's tax forms have not been received. |
Tax form document was uploaded by the payee, but has not been reviewed | The required tax form document has been uploaded by the payee, but has not yet been reviewed by the payer. |
Tax form documents have not been uploaded by payee | The payee has not uploaded the required tax form documents. |
Tax number was not entered | The payee has not entered a tax number in the iFrame. |
Tipalti ToS not signed | Tipalti's Terms of Service have not been signed. |
Validation for tax form failed | Validation of the payee's tax form has failed. |
VAT number was not entered | The payee has not entered a value-added tax (VAT) number in the iFrame. |
Required user roles View Payees & Payee Reviewer
When the Payees Pending Review feature is enabled and payees change their account information in the iFrame/ Supplier Hub, they become unpayable until the changes are reviewed and approved by the payer.
When viewing payees pending review, you can use the filters beside the column names to focus on a subset of payee records.
- Go to Payees > Payees pending review. A list of payees pending review displays.
- At the end of a payee row, click
and select one of four actions. These actions correspond with the ones listed below. Select an action to reveal how-to steps.
- Select "View" from the dropdown menu. The payee record opens in a new window. You are now on the Payees > Payees subtab for that payee.
- Review the payee information. To view further information, you may need to expand the GENERAL, CONTACT, PAYMENT DETAILS or TAX INFO rows by clicking
at the end of the row.
To view a log of payee changes in the iFrame/ Supplier Hub, see Find payee actions performed in the iFrame.
- Select "Approve" from the dropdown menu. An "Approve payee" dialog displays.
- Click "Approve". The payee record is removed from the "Payees pending review" screen.
- Select "Decline" from the dropdown menu. A "Decline payee" dialog displays.
- Type the reason for decline.
- Click "Decline". The reason for decline is sent to the payee and the payee is now unpayable until the information is updated and approved. The payee record is removed from the "Payees pending review" screen. Once the payee updates the information, a new record for the payee appears on-screen.
To see all records of declined payee changes, select the "Display declined payees" check box.
- Select "Request update" from the dropdown menu. A "Request update" dialog displays.
- Type the reason for requesting an update.
- Click "Request update". The reason for the requested update is sent to the payee and the payee record is removed from the "Payees pending review" screen. Once the payee updates the information, a new record for the payee appears on-screen.
Required user role View Payees
The payee record shows the payee's payment method and relevant payment information.
- Search for the payee.
- Below the search bar, refer to the PAYMENT DETAILS section for associated information.
- At the end of the row, click
to reveal further information, if any.
- A "+More" button in the row indicates there is more information that can be viewed. Click "+ More". A "Payment method details" dialog displays payment information.
Update remittance information
Required user role View Payees
Remittance information displays only for wire transfer payment methods.
- Search for the payee.
- In the PAYMENT DETAILS section, click "+More" (if you don't see the "+More" button, click
to expand the row). A "Payment method details" dialog displays.
- In the "Remittance info" field, click
. A text box displays.
- Type the remittance information into the text box.
- Click the check mark to confirm your entry.
- In the "Remittance info" field, click
Required user role View Payees
In the Tipalti Hub, you can view which actions have been performed on the payee's record by either the payer in the Tipalti Hub or the payee in the iFrame/ Supplier Hub.
- Search for the payee.
- Click the "Log" subtab.
A table displays the following information:- Date - The date of the interaction
- Time (UTCCoordinated Universal Time) - The time of the interaction in UTC
- Log Action - A description of the action performed
- Host Address - The IPInternet Protocol address from where the action was performed
Required user role View Payees
On the Payees > Payments subtab, you can find previous payments made to the payee, including the actual amount the payee received and the transaction fees that were paid.
- Search for the payee.
- Click the "Payments" subtab. All previous payments to the payee display.
- To view payment details, find the relevant payment orderA single payment instruction for a payee and click the row. The "Details of payment order" screen displays.
- If you use the Bills module, a list of bills linked to the payment order displays. Click a bill row to view its details.
You can also perform actions on a bill by clickingat the end of the bill row. The actions available depend on the bill status and your user role.
How are payee fees calculated?
The payee fee for each payment represents the summation of "Payee transaction fee + Submitted currency to payee currency FXForeign exchange rate". The net amount disbursed to the payee is "Amount submitted – (Payee transaction fee + Submitted currency to payee currency FX rate)". These field values are displayed in a "Payment details" report.
The following information is only relevant if you are using the Bills module.
Required user roles View Payees & View Bills
A payee's bills can be found on the Payees > Bills subtab. You can see the bill date, due date, amount, and bill and payment refcodes and statuses.
- Search for the payee.
- Click the "Bills" subtab. A list of the payee's previous bills display.
- To view bill details, find the relevant bill and click the row. The "Bill details" screen displays.
You can also find a payee's previous bills on the "Bills" tab.
The following information is only relevant if you are using the Taxation module.
Required user role View Payees
On the payee record, you can view payee tax information, such as tax form status, tax form type, tax ID and date submitted.
- Search for the payee.
- Refer to the TAX INFO row for tax information (you may need to click
at the end of the row to reveal further tax information).
- A "+More" button in the TAX INFO row indicates there is more information that can be viewed. Click "+More". A "Tax form details" dialog displays the information. Depending on the type of tax form submitted by the payee, you can download the form from the dialog.
Different tax details display based on the payer configuration and the payee details.
US: Details of W-8/ W-9, Non-US Declaration and other forms (e.g., 8233) display
Non-US: VAT and tax numbers display (when applicable)
Find payee Certificate of No U.S. Activities
Required user role View Payees
If certain conditions are met, payees can complete a Certificate of No U.S. Activities along with the relevant tax form. You can view the status of the certificate and download it for your records.
- Search for the payee.
- Below the search bar, at the end of the TAX INFO row, click
to reveal further information. You see the status of the Certificate of No U.S. Activities.
- Click "+More". A "Certificate of No U.S. Activities" dialog displays.
- Click "Download".
Update payee tax information
Required user roles View Payees & Update Payee
Only US payers can update payee tax information. Select an action below to reveal how-to steps.
- Search for the payee.
- Click the "Settings" subtab.
- Beside "Allow payee not to submit W9 for payments under USD 600", toggle the button "On".
- Click the check mark to confirm your selection.
- Search for the payee.
- At the top right of the screen, click "Actions" and go to Tax form > Invalidate tax form. An "Invalidate tax form" dialog displays.
- Click "Ok". The payee becomes unpayable until the tax form is resubmitted and approved.
Invalidating a payee's tax form is irreversible. Please submit a ticket to our Support Team to let them know that you have performed this action in error.
- Search for the payee.
- At the top right of the screen, click "Actions" and go to Tax form > Tax form submitted manually.
- In the dialog, click "Ok" for the payee's tax form status to change to "Submitted manually".
Acknowledging that a payee's tax form has been received manually is irreversible. If the payee has previously submitted tax forms through the Supplier Hub/ iFrame, these forms are no longer available. Please submit a ticket to our Support Team to let them know that you have performed this action in error.
If you are manually collecting signed W-9 forms from payees, you do not need to mark these forms as submitted manually. Instead, you can input their tax form information in the Supplier Hub on their behalf (refer to Manually submit signed payee W-9 tax forms to Tipalti).
- Search for the payee.
- At the top right of the screen, click "Actions" and go to Tax form > Download "tax" form. The word "tax" in the submenu is customized to display whichever tax form the payee has uploaded (e.g., if the payee has uploaded a W-9 form, the submenu option is "Download W9 form").
The following information is only relevant if you are using the Documents module, or the Taxation module and payees are required to upload documents.
Required user roles View Payees & View Documents
In the Tipalti Hub, you can view documents that the payee has uploaded to the iFrame/ Supplier Hub. You see information, such as the date the document was uploaded, what triggered the upload request (e.g., the setup process), and the status of the document (whether it is approved, rejected or pending approval). If the document has been rejected, hover over beside the status to see the reason for rejection.
- Search for the payee.
- Click the "Documents" subtab. All documents uploaded by the payee display.
- Find the relevant document and at the end of the document row, click
and select "Download".
Approve payee documentation
Required user roles View Payees, View Documents & Documents Approval
Payees remain unpayable until their uploaded documents have been reviewed and approved.
- Go to Payees > Documents. All documents uploaded by the payee display.
- Find the relevant document and in the "Actions" column, click
and select "Download".
- Review the document. Then, at the end of the document row, click
and select "Approve" or "Reject".
- Follow the prompts to complete the approval or rejection process. If a document is rejected, you need to provide the reason for rejection, which is sent to the payee.
You can also review, and accept or reject documents from the "Documents" tab.
The following information is only relevant if you are using the Detect module.
Required user roles View Payees & Risk Management
You can view payee's risk cases and related payees on the Payees > Detect info subtab.
- Payee risk cases: Open and resolved risk cases for the payee.
- Related payees: Payees that are related to the payee in question and the type of relationship (e.g., blocked payees, multiple accounts).
- Search for the payee.
- Click the "Detect info" subtab. An overview of all the payee's risk cases display. For field descriptions, see "Cases overview" screen.
- Click a risk case row to view its details. The "Case ID" screen displays. You can now review the open risk case.
To view the payees related to a risk case:
- At the end of the risk case row, hover over the number in the "Affected payees" column. A list of payees and their IDs display.
- Click a payee ID to view that payee's record. The "Payees" tab displays.