Tipalti Help Center home page
  • Get started
    • Onboarding tools
    • Video tutorials
  • User guides
    • Tipalti Hub Home
      • Log in to the Tipalti Hub
      • Home for employees
      • Home for finance team
    • Tipalti AI Assistant
      • Ask the assistant
      • Common prompts
    • Administration
      • General
      • Communications
      • Bills setup
    • Multiple entities
      • Multiple entities
      • Switch entities with multi-instance setup
    • Funding
      • Funds overview
      • Manage virtual accounts
      • Fund Tipalti accounts
      • Transfer funds between accounts
      • Fund Multi-FX accounts
    • Payees
      • Add, import, and invite payees
      • Search payee information
      • Manage payee status and settings
      • iFrame/ Supplier Hub
      • Managing your payees
      • Manage actions as a payee
      • Add and review payee documents
      • Verification of payee
    • Taxation
      • US tax forms
      • Tax form expiration
      • Tax withholding
      • Certificate of No US Activities
      • Additional documents
      • Non-US tax collection
      • Tax form statuses
    • Procurement
      • New Procurement
      • Original Procurement
    • PO matching
      • What's new with PO matching
      • PO matching
      • Review PO matching
      • Updates to POs
      • Bill approval for PO-backed bills
      • Match dropship invoices
      • Handle prepayments
      • Matching process
      • Bill routing
      • Matching policies
    • Bills
      • Start using Bills
      • Manage bills
      • Approve and pay
      • How Bills works
    • Tipalti Expenses
      • Get started
      • Create and submit expenses
      • Manage and approve expenses
      • Build expense approval workflows
      • Reimburse expenses
      • Connect and manage your corporate cards
    • Tipalti Cards
      • Tipalti Cards
      • Fund your card
      • Manage cards
      • Process transactions
      • Monitor card transactions
      • Card matching
      • ERP sync
      • Credit card statement report
    • Payments
      • Submit payments
      • Manage payments
      • Schedule payments
      • Understanding payment statuses
      • Payment methods coverage: US and ROW
      • Payment methods coverage: UK and EU
      • Payment methods coverage: Canada
      • Payment error codes
      • Managing unsuccessful payments
    • Reports
      • AI-powered reports
      • Payment reports
      • Bill reports
      • Payee reports
      • Tax reports
      • User reports
    • Security practices
      • Email security
      • Business continuity practices
      • Two-factor authentication
      • Detect
  • Integrations
    • 3rd Party Apps
      • Partner Platforms
      • SSO
    • ERPs
      • Sage Intacct
      • NetSuite 2.0
      • Microsoft Business Central
      • QuickBooks
      • Xero
      • Tipalti Connect
      • Acumatica
      • SAP B1
    • File Integration
      • Configure auto-sync settings
      • Import files
      • Export files
  • Resources
    • Webinars
    • General FAQs
    • User guide FAQs
      • Payee FAQs
      • Bill FAQs
      • Card FAQs
      • PO Matching FAQs
      • Payment FAQs
      • Detect FAQs
      • Taxation FAQs
      • Administration FAQs
      • Expenses FAQs
    • ERP FAQs
  • Release notes
  • Dev docs
Sign in
  • Get started  
    • Onboarding tools  
    • Video tutorials  
    • Live training  
  • User guide  
    • Log in to the Tipalti Hub
    • Administration  
      • Administrative operations
      • User roles
    • Multiple entities
    • Funding  
      • View funds required
      • Fund Tipalti accounts
      • Fund Multi-FX accounts  
        • Currency cutoffs and validations
    • Payees  
      • Search payee information
      • Manage payee status and settings
      • iFrame/ Supplier Hub
      • Managing your payees
      • Documents review
    • Taxation  
      • US tax forms
      • Tax form expiration
      • Tax withholding  
        • Withholding rates
        • Income types
        • Tax form and entity types
      • Certificate of No US Activities
      • Additional documents
      • Non-US tax collection
      • Tax form statuses
    • Procurement  
      • System overview
      • Create and track purchase requests
      • Approve purchase requests
      • Mark goods and services as received
      • Vendor registration
      • Send PO PDF
      • Back office  
        • Set reminders
        • Run parallel PR/ vendor approval
        • Emails
        • PO PDF customization
        • Upload budget
        • Customize Procurement forms
        • Contract repository
      • Workflow integrations
    • PO Matching  
      • Matching process
      • Handle matching exceptions
      • Bill routing
      • Matching policies
      • Bill coding
      • Bill approval for PO-backed bills  
        • Approvable bills
        • Non-approvable bills
        • PO updates
      • Prepayments (NetSuite 2.0)
      • Track and match a dropship invoice  
        • Set payees up as dropship vendors
        • Upload and match a dropship invoice
    • Bills  
      • Bill flows
      • Usability
      • Add invoices
      • Manage bills
      • Add comments and files to bills
      • Bill approvers
      • Invoice processing approvals
      • Email Security
      • Tax collection in Bills
      • Bill statuses
    • Tipalti Expenses  
      • Get started
      • Create and submit expenses
      • Manage and approve expenses
      • Reimburse expenses
      • Connect your corporate cards
    • Tipalti Cards  
      • Funds flow
      • Manage cards
      • Card transactions overview
      • Process transactions
      • ERP sync
      • Credit card statement report
    • Submitting payments
    • Payment information  
      • Payment statuses defined
      • Payment methods coverage: US and ROW
      • Payment methods coverage: UK and EU
      • Payment methods coverage: Canada
      • Payment error codes
    • Reports  
      • Smart report builder
      • Payment reports
      • Bill reports
      • Payee reports
      • Tax reports
      • User reports
    • Security practices  
      • Email security
      • Business continuity practices
      • Two-factor authentication
    • Detect
  • Integrations  
    • 3rd Party Apps  
      • Partner Platforms
      • SSO
    • ERPs  
      • Sage Intacct
      • NetSuite 2.0
      • Microsoft Business Central
      • QuickBooks
      • Xero
      • Tipalti Connect
      • Acumatica
      • SAP B1
    • File Integration  
      • Configure auto-sync settings
      • Import files
      • Export files
  • FAQs  
    • General FAQs
    • User guide FAQs  
      • Bill FAQs
      • Card FAQs
      • PO Matching FAQs
      • Payment FAQs
      • Detect FAQs
      • Taxation FAQs
      • Administration FAQs
      • Expenses FAQs
    • ERP FAQs
  • Release notes
  • Dev docs
  1. Tipalti
  2. Standalone articles
  3. Standalone articles
Follow

Articles in this section

  • 2020 Changes to the 1099 Preparation Report
  • Changes to the W-8BEN and W-8BEN-E Tax Forms
  • Access Tipalti help resources
  • International holidays
  • Managing payees in iFrame / Supplier Hub
  • Payment statuses defined
  • New User Quick Start Guide
  • Pay bills by card
  • Procurement REST API documentation
  • Safelist Tipalti App
See more

Managing payees in iFrame / Supplier Hub

This article covers Tipalti's iFrame and the classic Supplier Hub. For the new experience that's gradually rolling out in 2026, go to Onboard payees.

The iFrame/ Supplier Hub allows payees to provide their credentials, such as address, payment method and tax forms to the payer and Tipalti for payment processing. It also provides payees with the ability to track the status of their payments and invoices, and view the history. Since the Supplier Hub offers the same functionality as the iFrame, the following information is relevant to both systems. Payees using screen readers can easily understand and complete onboarding with accessible field labels and step context.

Supported languages

The following languages are supported in the iFrame.

Arabic (please contact our Support Team to enable it) French Portuguese
Bulgarian German Romanian
Chinese Greek Russian
Czech Hungarian Slovak
Danish Italian Spanish
Dutch Japanese Swedish
English Korean Thai
English (UK) Norwegian Turkish
Finnish Polish Vietnamese

Adding payment details

To become "payable" (able to receive payments), a payee must complete the following steps on the "Payment Details" tab of the iFrame. Select a step below to reveal further details.

Step 1. Enter contact information

On the Address page, the payee completes the email address, name, and address fields. The name and address must appear exactly as in the payee's bank records.

To speed up payee onboarding, Tipalti uses address autocomplete via Google Maps API. Payees simply select their country, start entering their address, and can select a full address, saving time and reducing manual input.

Description

  • In your setup, you can set name fields as optional in the iFrame / Supplier Hub to streamline onboarding.
  • Tipalti does not accept P.O. box or in-care-of (c/o) addresses, with the exception of APO (Army Post Office) or FPO (Fleet Post Office) boxes.
  • Canadian province and Mexican state are extra fields in the Supplier Hub and iFrame in the W8-BEN and W8-BEN-E forms. When a payee chooses Mexico or Canada in the country field, they’ll see a list of all the states or provinces.
Step 2. Select a payment method

On the "Payment Method" page, the payee selects a preferred payment method. Supported payment methods differ per country and per funding currency (see Payment methods coverage for details).

  • If the payer has defined payee transaction fees, these fees display and may differ per payment method.
  • If the payer has multiple entities, the payee is linked automatically to the default entity. The transaction fees display according to what was defined for the default entity (the payee can later be linked to a different entity, if required).

Depending on the country that has been identified on the "Address" page, the payee also selects a payment currency. Payment amounts are converted to the payee currency on the day of transfer using the bank's conversion rate. Foreign exchange fees are then applied.

Payment methods

Available payment methods display in a dropdown list for the payee. When the dropdown is not expanded, the default payment method shows in the field. The payee must expand the dropdown to see all the available options.

Payment methods display in the fixed order listed below. The default payment method is the first one listed (Direct Deposit/ ACH). If this method is unavailable, the default is the second listed payment method. If the first and second methods are unavailable, the default is the third payment method, and so on.

Direct deposit/ ACH

ACH direct deposit is governed by NACHA (National Automated Clearing House Association) and is an electronic transfer of funds from sender to recipient. It's the most cost-effective method to deposit funds directly, in local currency, into the payee's bank account.

The payment information required from the payee differs per country. Common required fields are:

  • Payment Currency
  • Name on Account
  • Bank Name
  • SWIFT or Routing Code
  • Country

A minimum threshold can be defined by the payer, if desired.

Global ACH / Local Bank Transfer

Global ACH / Local Bank Transfer is similar to ACH direct deposit, but applies to many non-US countries (see Payment methods coverage for a complete list). Generally, there is no minimum threshold for payments; however, some currencies may have a maximum limit.

Wire transfer

Wire transfer is a direct bank-to-bank transaction. It's the fastest method to deposit funds directly, in local currency, to the payee's bank account. Using the most advantageous currency exchange rates, this method maximizes the amount of local currency the payee receives when compared to transfers in USD that are converted to local currency.

The payee can add intermediary bank information (i.e., intermediary bank's SWIFT code, name and account number), if necessary, by clicking the "Add intermediary bank information" link below the "Country" field.

Generally, there is no minimum threshold for payments; however, some currencies may require a minimum amount.

The payment information required from the payee differs per country. Common required fields are:

  • Payment Currency
  • Name on Account
  • SWIFT
  • Country

Check

Check refers to paper checks. The payee must provide the name to be written on the check and the address where to send the check. The payee is advised to allow 15 business days for the check to arrive. Checks are for deposit only and cannot be transferred.

The minimum threshold for payment via paper check is USD 50.00.

PayPal

PayPal is an eWallet service that allows payees to receive payments. There is no minimum threshold for payments and PayPal transaction and withdrawal fees apply. Payees need to provide a PayPal email address in the iFrame and select the currency in which they want to be paid. If they do not select a currency, they are paid in the following currency by default:

  • If the local currency is supported, it is the default.
  • If the local currency is not supported, Euros is the default.

In PayPal receipts, as well as the payee's PayPal account activity and payment email notifications, the payer's name and details display, not Tipalti's.

Supported PayPal payment currencies

Tipalti supports the following PayPal payment currencies. This list may be updated periodically.

Currency

ISO code

Australian dollar AUD
Canadian dollar CAD
Czech koruna CZK
Danish krone DKK
Euro EUR
Hong Kong dollar HKD
Hungarian forint HUF
Israeli new shekel ILS
Japanese yen JPY
Mexican peso MXN
New Taiwan dollar TWD
New Zealand dollar NZD
Norwegian krone NOK
Philippine peso PHP
Polish złoty PLN
Pound sterling GBP
Russian ruble RUB
Singapore dollar SGD
Swedish krona SEK
Swiss franc CHF
Thai baht THB
United States dollar USD

Prepaid debit card

A prepaid debit card is a debit card preloaded with money. Intercash is a global provider of prepaid cards, which can be used at over 29 million locations worldwide where Mastercards are accepted (e.g., ATMs, point of sale, online purchases). There is no payment threshold.

To get paid using a prepaid debit card, the payee must apply for a Mastercard® prepaid debit card issued by Intercash. Intercash provides the payee with a SAN (Secondary Account Number), which must be entered in the iFrame.

An Intercash account can receive up to USD 500.00 in a single payment. Payees can increase the limit by upgrading their account level through the Intercash account dashboard.

Hold my payments

The payee can choose to have payments held by the payer company. No disbursement is made until the payee changes this selection.

Pay by Cards

Streamline the payment process with pay by card. Use Tipalti's virtual cards to make USD payments to US-based payees who accept card payments. Payees can manage transactions made using their Tipalti virtual card in the same way they manage payments made using a regular credit card. Using virtual cards provides clear and traceable transaction records, simplifying the payment and reconciliation process.

When the "Payment Method" page has been completed, the payee goes to the "Tax Forms" page (if the Taxation module has been activated).

Payment threshold

The payer may enable payment thresholds. If enabled, for each payment method, the system clearly identifies the minimum threshold for payment (i.e., the minimum amount that is to be disbursed).

If the "Payee threshold" feature is enabled, an "Edit my payment threshold" link displays below the selected payment method. Payees can click this link to define their own payment threshold for any payment method (except the "Hold My Payments" option). The payee threshold cannot be lower than the one defined by the payer.

In addition, there may be thresholds defined by the payment provider. Payees receive payments only when the payment amount is above the highest minimum threshold value. Until then, payments are deferred.

Step 3. Submit tax forms

If the Taxation module has been activated, the payer company is required to collect tax declarations from payees. The following tax forms are offered on the "Tax Forms" page of the iFrame.

  • U.S. W-9 tax forms
  • U.S. W-8 tax forms
    • W-8BEN
    • W-8BEN-E
    • W-8ECI
    • W-8IMY
    • W-8EXP
    • 8233

To ensure payees complete the correct form, Tipalti provides a tax questionnaire to help determine which US tax form is required. If the payer requires a local tax or value-added tax (VAT) identification number, these fields display on the "Tax Forms" page for payees to complete (see Non-US tax collection).

Payees can view their online tax forms at any time. Forms that were completed manually cannot be viewed online, but can be downloaded from the iFrame following payer approval.

Address validation

Tipalti validates the following types of payee addresses for new and existing payees:

  • Contact address
  • "Check" payment method address
  • Tax form addresses (W-8BEN, W-8BEN-E, and W-9)

Addresses are validated automatically in the iFrame/ Supplier Hub when the payee selects the "Next" or "Save" button on each of the following pages:

  1. "Address" page - After entering contact information
  2. "Payment Method" page - After selecting "Check" as the payment method
  3. "Tax Forms" page - After submitting tax forms (W-8BEN, W-8BEN-E, and W-9)

Address validation results

There are three types of validation results:

  • Payee address not verified - The payee needs to confirm the address provided.
  • Payee address verified
  • Payee address verified but with address change suggestion - If, for example, the payee made an error while typing or the zip code is incorrect, etc., the system suggests the relevant changes. The payee can choose to change the address to the suggested one.

Submitting documents

If payees are required to submit additional documents regarding taxation or if you have the Documents module enabled, a "Documents" page displays after the "Tax Forms" page on the "Payment Details" tab. Payees can use this page to upload documents for payer review.

Additional information

Select an option below to learn more.

Updates to payee details

Once payees are registered with the iFrame, they can update their information, as long as there are no restrictions on accounts.

Please be aware that a change in any of the following information may erase banking information and/ or invalidate tax forms. A payee cannot be paid without complete banking information on file and valid tax forms (if tax forms are required).

  • First name
  • Last name
  • Company name
  • Contact address country
  • Payment details country
  • Phone number

A change of letter case (e.g., "amy" to "Amy") in the payee's name fields will not invalidate the payee's tax form.

All changes made in the iFrame must be reviewed and approved (or declined) by the payer in the Tipalti Hub (see Find payees pending review). If changes are declined, the payee is unpayable until the issues are resolved.

If the payer changes payee details via the payee API or Tipalti Hub, or the payer invalidates the payee's tax form via the Tipalti Hub, an email notification of the change is sent to the payee.

Compliance checks

If payees edit the following fields in the iFrame too many times, a compliance check is triggered and a risk case is opened.

  • First name
  • Last name
  • PayPal email
  • Residence country or state

Payees are asked to upload documents and explain the reason for the change. They are also informed that future payments are on hold. Further changes cannot be made while the risk case is open.

Payee information is verified, and the changes are either approved by our Compliance Team or the payee is blocked.

Invoice and payment history

On the "Invoice History" or "Payment History" tabs of the iFrame, payees can:

  • Approve invoices in the self-billing flow
  • Upload new invoices for payer reviewBankgiro for Nordics
  • Track pending invoices and payments (i.e., view statuses)
  • View the payer entity assigned to each invoice and payment
  • View and download invoice and payment history (including related invoices)

Please note: payment summaries in the iFrame/Supplier Hub include enriched data (such as invoice numbers, Bankgiro for Nordics, and card payment details) for payees or AP processors seeking proof of payments.

The following information displays for payees.

Invoice History Tab

Payment History Tab

Invoice date

Date:

  • Payment order approval date
  • Payment order creation date (if no approval is required)
Invoice description Payment method
Invoice status Payment status
Amount and currency Amount submitted and currency

Payment dates for:

  • Scheduled payments
  • Partial payments
  • Multiple payments (when the bill is linked to multiple payment orders)
  • Fully paid vendor credits
Payment date (value date)
— Transaction fee (if applicable)
— NetNow fee (if applicable)
— Related invoices information (invoice date, invoice number, invoice amount, amount submitted)

Invoice vs. bill statuses

The invoice statuses presented on the "Invoice History" tab in the iFrame/ Supplier Hub correspond with bill statuses presented in the Tipalti Hub (see Bill statuses for descriptions).

How the invoice was submitted to Tipalti determines which invoice statuses can be seen in the iFrame/ Supplier Hub. Click the submission method below to see the corresponding statuses in each system.

Payee submits invoice via iFrame/ Supplier Hub

Status shown on "invoice history" tab in iFrame/ Supplier Hub

Status shown in Tipalti Hub (bills module)

In process*

Draft

Pending scan

Pending managed services

Pending review

Pending AP action

Pending approval

Pending payment

Scheduled for payment^

Approved for payment Scheduled for payment‡
Submitted for payment Submitted for payment
Paid Paid
Deleted Deleted
Disputed Disputed
* Indicates the invoice has entered the bill feeding flow.
^ The payer has not yet approved the payment group.
‡ The payer has approved the payment group or no approval is required.

Payee submits invoice via email or payer uploads invoice to the Tipalti Hub

Self-billing invoices will not appear on the "Invoice History" tab until the invoices have been released to the payee for approval.

Status shown on "invoice history" tab in iFrame/ Supplier Hub

Status shown in Tipalti Hub (bills module)

In process*

Pending AP action

Pending approval

Pending payment

Scheduled for payment^

Approved for payment Scheduled for payment‡
Submitted for payment Submitted for payment
Paid Paid
Deleted Deleted
Disputed Disputed
* Indicates the invoice has entered the bill feeding flow.* Indicates the invoice has entered the bill feeding flow.
^ The payer has not yet approved the payment group.^ The payer has not yet approved the payment group.
‡ The payer has approved the payment group or no approval is required.
  • ZD.4.log-1212665864.zip
    20 KB Download
Was this article helpful?

We’d love the opportunity to improve. Submit your feedback.

We’re glad you enjoyed the article!

Have more questions? Submit a request
Return to top
Privacy Policy | Terms of Use | Payer/Sender Rights | Customer Assistance Policy
LinkedIn Instagram Facebook Twitter YouTube
Contact support