Relay provides various simple methods to link any duplicate payees you may have within Relay. Relay detects two payees that share a similar name or email, and asks if you'd like to link them when you select one in a payment or bill payment. You could also link payees from within your Payees tab when selecting Edit.
Payees no longer need an identical email address to be linked. Relay now detects duplicates by name or email and prompts you to resolve them when you pay a bill or send a payment.
What you need before you start
Both payee records must have an identical email address. If they do not, follow the manual merge process instead.
Desktop or mobile app access to your Relay account.
Know which record you want to keep. Relay merges into the payee with saved account details, so identify the empty record first.
When do duplicate payees happen in Relay?
Duplicate payees usually appear when the same vendor is added to Relay twice. The two most common causes:
An accounting integration and a Relay payee. You create a payee in Relay, then connect QuickBooks Online or Xero to Bill Pay (or the integration syncs a vendor with the same name). Relay now holds two payees for one vendor: the one you added and the one synced from your accounting software.
Two payees created in Relay. Two team members add the same vendor, or the same vendor is added with slightly different spelling.
Payees imported from an integration but not associated with an outstanding bill payment in Relay are automatically defaulted to payee status "Inactive". Your inactive payees can be located within your account by navigating to Payments, then selecting Payees. From here, select Payee Status followed by Inactive to see a list of imported (but inactive) payees from Quickbooks or Xero.
Duplicates matter because each payee has its own payment details, and bills from QuickBooks or Xero sync to the synced vendor rather than to the payee that holds your saved account details.
To stop the same vendor syncing in twice, clean up duplicate vendor names in QuickBooks or Xero and check if a payee already exists with an inactive status before manually re-creating one.
How does Relay detect duplicate payees?
Relay treats two payees as potential duplicates when they share a name or an email address. Small differences in capitalization, punctuation, or business suffixes such as "Inc." or "LLC" don't stop a name match.
Relay checks for duplicates when you select a payee in a payment or bill, when you create or rename a payee whose name matches an inactive vendor synced from QuickBooks or Xero, or when you restore an archived payee. It never links, merges, or archives payees on its own — it only prompts you, and nothing changes until you confirm.
What happens when I select a duplicate payee in a payment or bill?
When you choose a payee that has a potential duplicate, Relay shows a prompt before you continue. What you see depends on the kind of duplicate.
Your payee is also a vendor in QuickBooks or Xero
If the payee you selected was manually added in Relay and a matching vendor was also synced from your accounting software but is still inactive, Relay surfaces a warning that states "This payee is also in QuickBooks (or Xero)." The prompt lists the payee you selected and the synced payee it found.
Select Activate & Link to activate the synced vendor and link it to your Relay payee. Your Relay payee's payment details are kept, and bills from QuickBooks or Xero now sync to the right vendor.
Or - Select Not Now or Don't Ask Again to either temporarily or permanently prevent this warning from appearing again when selecting this payee. You will then skip any payee linking for now, allowing you to continue your payment or bill with the payee you selected.
Two duplicate payees (same name or email)
If Relay finds one other payee with the same name or email, it shows both and asks you to choose which payee's payment details to keep. Confirm your choice to link the two payees. Only the payee you keep has its payment details used from then on.
Three or more duplicate payees (same name or email)
If Relay finds two or more other payees with the same name or email, it asks you to Choose one to keep. Select the payee whose payment details you want to use, then select Confirm & archive the rest.
The other payees are archived, and any scheduled or recurring payments to them are canceled.
Archived payees that were added in Relay can be restored later from Filters → Payee status → Archived on the Payees page.
Payees synced from QuickBooks or Xero aren't archived — they return to Inactive instead.
Heads Up: Linked payees can't be unlinked, and archiving a payee cancels its scheduled and recurring payments. It is recommended to review any actions linked to a payee before archiving.
How do I link duplicate payees from Edit payee?
You can link two payees yourself at any time from your Payees page on the web. Only payees with the same name or email address can be linked.
Sign in to your Relay account on the web.
Go to the Payments tab, then select Payees.
Select the payee you want to link to open its details panel, then select Edit.
Check Link this payee with another payee.
From the Linked Payee dropdown, select the other payee. Only payees with the same name or email address as this one can be chosen.
Decide whose payment details to keep. Check Use linked payee's payment information to keep the linked payee's details, or leave it unchecked to keep this payee's details.
Review the pair carefully, then select Save payee. Linked payees can't be unlinked.
Tip: Before linking, open both payees and check which one has the correct ACH or wire details. Only one payee's payment information is kept.
How do I link payees in the Relay mobile app?
You can link two payees from the Payees list in the Relay mobile app.
Sign in to the Relay mobile app.
Tap the Payments tab and select Payees.
Select the payee you want to link and press Link Payee.
Select the payee to link and choose whether to use the linked payee's payment information.
Select Link Payees, and confirm. Linked payees can't be unlinked.
The duplicate prompts that appear when you pay a bill or send a payment are web only.
What happens after I link two payees?
After linking, Relay treats the pair as one payee.
Only the payee you kept appears in your payee list when you send a payment or pay a bill.
Only the kept payee's payment details are used.
Bills synced from QuickBooks or Xero still match the right vendor, and payments sync back to your accounting software.
Things to Know
Linking is between two payees only. A third payee can't be added to a linked pair.
Linked payees can't be unlinked, so confirm your decision before completing a link.
Only payees with the same name or email address can be linked.
Payees that both have payment details can be linked. Only the kept payee's details are used.
The duplicate prompts appear on the web; the Relay mobile app doesn't show them.
You need Add and Edit Payees permissions to link or activate payees. If you don't see these options, ask an administrator to review your team member permissions.
If you restore an archived payee whose name matches an active payee, Relay warns you that it could be a duplicate before restoring it.
Vendors synced from QuickBooks Online or Xero stay Inactive in Relay until a bill references them or you activate them. See How to activate Inactive Quickbooks or Xero Payees in Relay.
Frequently Asked Questions
Can I merge duplicate payees in Relay? Yes. In Relay, merging duplicate payees is called linking. Link two payees that share a name or email address from Edit payee, or accept the prompt Relay shows when you select a duplicate in a payment or bill. The payee you keep provides the payment details, and the link can't be undone.
Why am I being asked about duplicates when I pay a bill? Relay checks for duplicate payees whenever you select a payee in a payment or bill. If another payee shares the same name or email address, Relay prompts you to link them, or to choose which one to keep, so your payment goes to the right payee and your accounting software syncs correctly. Select Not now to continue without changing anything, or select Don't ask again to permanently stop the prompt for that payee.
How do I merge duplicate payees manually if Relay doesn't detect them? Relay only detects payees that share a name or an email address. If both the names and the emails differ, Relay won't detect them as duplicates and they can't be linked. In that case, copy the payment details into the payee you want to keep from Edit payee, then archive the other one. Payees synced from QuickBooks or Xero can't be deleted; deactivating one returns it to Inactive.
I linked the wrong payees — can I unlink them? No. Linked payees can't be unlinked once saved. If you linked the wrong payees, contact our Customer Experience team with both payee names.
Does Relay merge or archive duplicate payees automatically? No — Relay never links, merges, or archives payees on its own. It only prompts you when it finds a potential duplicate, and nothing changes until you confirm. If you select Not now, your payment or bill continues as usual with the payee you chose.
Can I link more than two payees? No. A link is always between two payees. If you have three or more duplicates, Relay prompts you to choose one to keep and, once you select Confirm & archive the rest, archives the others. You can restore an archived Relay payee later from Filters → Payee status → Archived on the Payees page.
Which payee's payment details does Relay keep? The one you choose. In a duplicate prompt, the payee you select to keep is the one whose payment details are used. From Edit payee, Relay keeps this payee's details unless you check Use linked payee's payment information. When your Relay payee is linked to an inactive vendor from QuickBooks or Xero, your Relay payee's details are kept.
Related articles
Talk to our Customer Experience team
If this article did not fully answer your question, our Customer Experience team is here to help.