# Get your Tipalti payment statuses through an API > Read your Payment History, Invoice History and Payment Details from the Tipalti Supplier Hub with one API call each. A workflow can check your payments every weekday morning and post the ones marked Paid to your accounting system. Page: https://fous.com/automate/tipalti-supplier-hub Updated: 2026-11-12 Works with your own Tipalti Supplier Hub account. Fous is an independent product. ## What you can build on the Supplier Hub ### Get payment history Reads the Payment History tab: each payment from your payer with its status, amount and the invoices it covers. - Takes: Earliest payment date (optional), status (optional) - Returns: Payment date, amount, currency, status, invoices covered ### Get invoice history Reads the Invoice History tab: the invoices your payer has on record for you, with their numbers, dates and amounts. - Takes: Invoice date from (optional) - Returns: Invoice number, invoice date, amount, currency ### Read your payment details Reads the payment method from Payment Details, with the currency and payment threshold you chose in the Supplier Hub. - Takes: Nothing - Returns: Payment method, currency, payment threshold ## Automate the Supplier Hub with a workflow A [workflow](/product/workflows) runs your methods as one process, with nobody at the screen. A schedule or a call from your own system starts it, the steps run in order, and the result arrives in your inbox or in the systems you already use. ### Payments marked Paid, posted to your accounting system Starts: Every weekday at 8:00 1. Get the payment history for the last 14 days. 2. Keep the payments whose status changed to Paid since the last run. 3. Post each one, with its amount, currency and invoices covered, to your accounting webhook. ### Deferred and Rejected payments, emailed each weekday Starts: Every weekday at 9:00 1. Get the payment history for the last 30 days. 2. Keep the payments in Deferred or Rejected status that were not on the last run. 3. Email you each one with its amount, date and invoices covered. ### New invoices in Invoice History, weekly Starts: Every Monday at 7:00 1. Get the invoice history for the last 60 days. 2. Keep the invoices that were not there on the last run. 3. Email you the list with invoice number, date, amount and currency. You can run a workflow by hand on every plan, Free included. Schedules and webhook triggers come with the paid plans, from $29 a month. ## Once built, one call from your code Once you have built a [method](/product/methods), it is one POST to /v1/runs from your backend, or a tool an AI agent calls over MCP. This is what “Get payment history” would look like. Example request: ``` curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "method": "suppliers.tipalti.com/get_payment_history", "input": { "from_date": "2026-10-01" } }' ``` Example response: ``` { "status": "completed", "data": { "payments": [ { "payment_date": "2026-11-06", "amount": 8420, "currency": "USD", "status": "Paid", "invoices": [ { "invoice_number": "NW-2291", "amount": 5100 } ] } ], "count": 1 } } ``` An example with invented data, not a ready-made endpoint. The method exists in your organization once you build it, and its name, inputs and fields follow your request. ## The Supplier Hub’s own options Tipalti's REST API and iFrames are used by the company that pays you: it creates payees, invites them to the Supplier Hub and creates invoices, and it can embed Invoice History and Payment History in its own website. Tipalti documents no API for payees. As a payee you use the Supplier Hub and the payment status emails. | Option | What it covers | What it takes | | --- | --- | --- | | Tipalti REST API | Payees, invitations to the Supplier Hub, payment methods and invoices, managed by the paying company. | The payer's own Tipalti account. Payees are created and invited through it. | | iFrames | Setup Process, Invoice History and Payment History, shown to payees inside the payer's own website. | Set up by the payer on its website. | | Payment status emails | Emails to suppliers about the status of their payments, in the payer's branding. | Sent on the payer's behalf. Nothing to set up as a payee. | | The Supplier Hub by hand | Payment History, Invoice History, Tax Forms and Payment Details, for the payer that invited you. | A Supplier Hub account from your payer's invitation and the login link it gives you. | Read on November 12, 2026: [Tipalti developer documentation: Payees](https://documentation.tipalti.com/docs/payees-1), [Tipalti developer documentation: iFrames](https://documentation.tipalti.com/docs/iframes), [Tipalti Payee FAQs](https://tipalti.com/resources/support/payee-faqs/). ## Signing in to the Supplier Hub You register through your payer's emailed invitation by creating a password, then sign in with the Supplier Hub login link your payer gives you. Some updates ask for two-factor authentication. With Fous you sign in once through the Supplier Hub's own sign-in with your own account: the login is sealed with AES-256, and an expired session is signed back in. ## Worth knowing - **Your payer decides what you see**: The Payment History tab appears only if your payer has enabled it, and the payment methods offered are the ones your payer made available. Invoice approval, payment timing and amounts are set by the payer. - **Deferred means blocked before the bank**: A Deferred payment was stopped before bank submission because of missing tax forms, invalid banking details or a compliance hold. Rejected marks returned funds. - **The login link, not the invitation**: Registration links are temporary and stop working once used. Only your payer can change your Supplier Hub login email, which may differ from the email in your contact details. - **One payment can cover several invoices**: Payment History shows the invoices that make up each payment, so the payment history method you build can return them with every payment, to match against your receivables. ## More in Procurement - [Petronect](https://fous.com/automate/petronect.md) - [Basware Portal](https://fous.com/automate/basware-portal.md) - [BtoBプラットフォーム 請求書](https://fous.com/automate/infomart-btob-platform-invoice.md) - [Tungsten Network](https://fous.com/automate/tungsten-network.md) - [Taulia supplier portal](https://fous.com/automate/taulia-supplier-portal.md) - [OpenInvoice](https://fous.com/automate/openinvoice.md) - [Coupa Supplier Portal](https://fous.com/automate/coupa-supplier-portal.md) - [JAGGAER Supplier Network](https://fous.com/automate/jaggaer-supplier-network.md) - [SAP Business Network](https://fous.com/automate/sap-business-network.md) - [Oracle Fusion Cloud Supplier Portal](https://fous.com/automate/oracle-fusion-cloud-supplier-portal.md) - [Workday supplier portal](https://fous.com/automate/workday-supplier-portal.md) - [Nalanda](https://fous.com/automate/nalanda.md) - [Avetta](https://fous.com/automate/avetta.md) - [ISNetworld](https://fous.com/automate/isnetworld.md) Other industries: [Confirmation](/automate/confirmation), [Zillow Premier Agent](/automate/zillow-premier-agent), [Omnipart](/automate/omnipart), [Toyota Dealer Daily](/automate/toyota-dealer-daily), [Paylocity](/automate/paylocity), [Hyphen SupplyPro](/automate/hyphen-supplypro). ## Frequently asked questions ### Does the Tipalti Supplier Hub have an API? Not for payees. Tipalti's REST API and iFrames are used by the company that pays you, to create and invite payees, create invoices and show Invoice History and Payment History in its own website. As a payee you have the Supplier Hub itself and the payment status emails. ### How do I check whether a Tipalti payment has been sent? Look at the Payment History tab in the Supplier Hub, if your payer has enabled it. Each payment shows a status: Scheduled, Processing, Sent to payee, Paid, Deferred or Rejected. Tipalti notes that funds may not appear in your account immediately after a payment is marked Paid. ### Why is my Tipalti payment Deferred? The payment was blocked before it reached the bank, because of missing tax forms, invalid banking details or a compliance hold. You can update tax forms on the Tax Forms tab and bank details in Payment Details, and ask your payer about anything else. ### Which tax forms does the Supplier Hub collect? The W-9, W-8BEN and W-8BEN-E, on the Tax Forms tab, where you pick the form and select Complete form. On a W-9, the name on line 1 must match the name tied to the SSN or EIN in IRS records. If you cannot edit or resubmit a form, contact your payer. ### Is Fous affiliated with Tipalti? No. Fous is an independent product. You use it with your own Supplier Hub account, and a method reads and does only what that account can. Fous is an independent product: it is not affiliated with, endorsed by or sponsored by the operator of Tipalti Supplier Hub (Tipalti). The name is used only to say which system this page is about. Something here wrong or out of date? Write to legal@fous.com.