---
title: Troubleshooting Vendor Connection Issues
description: As a payer user on the PaymentWorks platform, you might encounter situations where a supplier file is uploaded for an approved vendor, but the connection between the vendor's New Vendor Registration a
---

[Skip to content](https://help.paymentworks.com/knowledge-base/troubleshooting-vendor-connection-issues#main-content)

[![PW Logo\_light\_Green\_ White](https://help.paymentworks.com/hs-fs/hubfs/2026%20PaymentWorks%20Brand%20Guidelines/PW%20Logo_light_Green_%20White.png?width=200&height=34&name=PW%20Logo_light_Green_%20White.png)](https://www.paymentworks.com/)

- [Help Center](https://help.paymentworks.com/knowledge-base/how-to-use-the-paymentworks-knowledge-base)

Open main navigation

Close main navigation

- [Help Center](https://help.paymentworks.com/knowledge-base/how-to-use-the-paymentworks-knowledge-base)
- [Contact Support](https://help.paymentworks.com/contactsupport)

[Contact Support](https://help.paymentworks.com/contactsupport?hsLang=en)

 Hello. How can we help you?

- There are no suggestions because the search field is empty.

1. [Help Center](https://help.paymentworks.com/knowledge-base?hsLang=en)
2. [Payer Knowledge Base](https://help.paymentworks.com/knowledge-base/payer-knowledge-base?hsLang=en)
3. [Sending Invitations & Reviewing Payee Status](https://help.paymentworks.com/knowledge-base/payer-knowledge-base?hsLang=en#sending-invitations-reviewing-payee-status)

# Troubleshooting Vendor Connection Issues

As a **payer user** on the PaymentWorks platform, you might encounter situations where a supplier file is uploaded for an approved vendor, but the connection between the vendor's New Vendor Registration and their supplier profile is not established. In such cases, the New Vendor Registration remains in an “approved” status instead of moving to a “connected” status.

This guide provides step-by-step troubleshooting instructions to help you identify and resolve issues with vendor connections.

---

#### **Troubleshooting Steps**

### **For Payers Manually Uploading Supplier Files**

1. **Confirm Registration Status**
   
     - Ensure the New Vendor Registration is in an **“approved”** or **“processed”** status. Only registrations in these statuses can proceed to the “connected” status.
2. **Verify the TIN Match**
   
     - Compare the TIN (Tax Identification Number) on your supplier file with the TIN in the New Vendor Registration.
     - Ensure the TIN values match **exactly**.
     - If the vendor’s TIN starts with **0**, ensure your spreadsheet is formatted as **text** to preserve the leading zero.
3. **Check the Request ID**
   
     - Ensure the **Request ID** on your supplier file matches the Request ID on the New Vendor Registration.
4. **Review Vendor Number and Site Code**
   
     - Verify that the **vendor number/site code combination** on your supplier file: 
           - Has not been used for another vendor connection.
           - If the vendor was previously registered in PaymentWorks, confirm that their supplier profile isn’t already connected.
5. **Check for Unicode/Foreign Characters**
   
     - If a “UTF-8” error occurs during upload, it indicates the presence of unsupported unicode or foreign characters in the file. Remove these characters and try uploading again.

---

### **For Payers Using Automated Supplier File Integration**

1. **Review ERP Logs**
   
     - Check your ERP logs for errors during the automated file transfer process.
2. **Pinpoint the Integration Issue**
   
     - Determine where in the integration process the issue occurred: 
           - Check if vendor registration data in PaymentWorks synced into your ERP system.
           - Confirm if the issue occurred **before** or **after** this sync.
3. **Check Supplier Upload in PaymentWorks**
   
     - Navigate to the **Supplier Upload page** to confirm the automated file upload occurred successfully in PaymentWorks.
4. **Confirm Supplier Profile Creation**
   
     - Verify under the **Suppliers tab** in PaymentWorks that the vendors from the upload file have had supplier profiles created.

---

#### **Additional Steps**

- **Retry the File Upload** 
    - If no issues are identified, re-upload the file to attempt a second connection.
- **Contact PaymentWorks Support** 
    - If the connection still fails after troubleshooting, contact [PaymentWorks Support](https://help.paymentworks.com/contactsupport?hsLang=en) for further assistance.

---

#### **Important Notes**

- **File Re-Upload** 
    - Re-uploading the file may resolve the issue if it was caused by a temporary system or formatting error.
- **Data Integrity** 
    - Double-check data integrity in your supplier file to ensure there are no formatting errors or inconsistencies.
- **Learn More** 
    - For additional help with supplier uploads and troubleshooting, refer to the Knowledge Base articles: 
          - [How to Format and Upload Supplier Files in PaymentWorks](https://help.paymentworks.com/knowledge-base/supplier-upload-file-format?hsLang=en)
          - [Connect Supplier User Interface (UI)](https://help.paymentworks.com/knowledge-base/connect-supplier-user-interface-ui?hsLang=en)

---

By following these steps, you can troubleshoot and resolve most vendor connection issues on the PaymentWorks platform effectively.

- [Payee Knowledge Base](https://help.paymentworks.com/knowledge-base/payee-knowledge-base?hsLang=en#main-content)

    - [Verification Process & Document Uploads](https://help.paymentworks.com/knowledge-base/payee-knowledge-base?hsLang=en#verification-process-document-uploads)
    - [Account Login & Updates](https://help.paymentworks.com/knowledge-base/payee-knowledge-base?hsLang=en#account-login-updates)
    - [Invoices & Payments](https://help.paymentworks.com/knowledge-base/payee-knowledge-base?hsLang=en#invoices-payments)
    - [Invitations & Customer Registrations](https://help.paymentworks.com/knowledge-base/payee-knowledge-base?hsLang=en#invitations-customer-registrations)
    - [Account Creation & Onboarding](https://help.paymentworks.com/knowledge-base/payee-knowledge-base?hsLang=en#account-creation-onboarding)
    - [Payee Profile](https://help.paymentworks.com/knowledge-base/payee-knowledge-base?hsLang=en#payee-profile)
    - [Manage Your Data](https://help.paymentworks.com/knowledge-base/payee-knowledge-base?hsLang=en#manage-your-data)
    - [Customer Table & Quick Connect](https://help.paymentworks.com/knowledge-base/payee-knowledge-base?hsLang=en#customer-table-quick-connect)
    - [Payment Methods & Bank Information](https://help.paymentworks.com/knowledge-base/payee-knowledge-base?hsLang=en#payment-methods-bank-information)
    - [FAQs](https://help.paymentworks.com/knowledge-base/payee-knowledge-base?hsLang=en#faqs)
- [Payer Knowledge Base](https://help.paymentworks.com/knowledge-base/payer-knowledge-base?hsLang=en#main-content)

    - [Profile Manager](https://help.paymentworks.com/knowledge-base/payer-knowledge-base?hsLang=en#profile-manager)
    - [Platform Updates & Announcements](https://help.paymentworks.com/knowledge-base/payer-knowledge-base?hsLang=en#platform-updates-announcements)
    - [Sending Invitations & Reviewing Payee Status](https://help.paymentworks.com/knowledge-base/payer-knowledge-base?hsLang=en#sending-invitations-reviewing-payee-status)
    - [New Vendor Registrations & Updates](https://help.paymentworks.com/knowledge-base/payer-knowledge-base?hsLang=en#new-vendor-registrations-updates)
    - [Supplier & Invoice File Uploads](https://help.paymentworks.com/knowledge-base/payer-knowledge-base?hsLang=en#supplier-invoice-file-uploads)
    - [Payments & Invoicing](https://help.paymentworks.com/knowledge-base/payer-knowledge-base?hsLang=en#payments-invoicing)
    - [Training Videos](https://help.paymentworks.com/knowledge-base/payer-knowledge-base?hsLang=en#training-videos)
    - [SSO/Login & User Permissions](https://help.paymentworks.com/knowledge-base/payer-knowledge-base?hsLang=en#sso-login-user-permissions)
    - [Implementation & Configuration](https://help.paymentworks.com/knowledge-base/payer-knowledge-base?hsLang=en#implementation-configuration)
    - [Frequently Asked Questions (FAQs)](https://help.paymentworks.com/knowledge-base/payer-knowledge-base?hsLang=en#frequently-asked-questions-faqs)
- [Developer Portal](https://help.paymentworks.com/knowledge-base/developer-portal?hsLang=en)
- [Contact Support](https://help.paymentworks.com/knowledge-base/contact-support?hsLang=en)

- [Help Center](https://help.paymentworks.com/knowledge-base/how-to-use-the-paymentworks-knowledge-base)
- [Contact Support](https://help.paymentworks.com/contactsupport)

[![PW Logo\_light\_Green\_ White](https://help.paymentworks.com/hs-fs/hubfs/2026%20PaymentWorks%20Brand%20Guidelines/PW%20Logo_light_Green_%20White.png?width=200&height=34&name=PW%20Logo_light_Green_%20White.png "PW Logo_light_Green_ White")](http://paymentworks.com)

Copyright © 2025, PaymentWorks