If you've spent any time in the Valpay portal or the Adyen Customer Area you've probably noticed there are a lot of IDs floating around. Each one points to a different piece of how a merchant is set up, so knowing which is which makes building against the API a lot easier and saves a ton of back and forth when you reach out to support. Here's what each one is for and what it usually looks like.
The quick reference
ID | What it's for | What it looks like |
Merchant Account | The Adyen account that processes payments for your platform in a region | A text name, like YourCompany_Payments |
Legal Entity ID | The merchant's business identity used for KYC and verification | Starts with LE, like LE32XXXXXXXXXXXXXXXXXXXXX |
Account Holder ID | What the merchant is allowed to do (process payments, receive payouts) | Starts with AH |
Business Line ID | Describes what the merchant sells and how (in person, online) | Starts with SE |
Balance Account ID | Where the merchant's funds sit before they're paid out | Starts with BA |
Transfer Instrument ID | The verified bank account payouts go to | Starts with SE |
Valpay Merchant ID | Valpay's own ID for the merchant | A long ID with dashes, like 9cf290ca-212b-4f01-b5a3-xxxxxxxxxxxx |
Valpay Store ID | Valpay's own ID for a single location | A long ID with dashes, same format as above |
Adyen Store ID | Adyen's ID for that same location | Starts with ST |
Sub-Merchant ID | The ID card schemes require on every transaction to identify the merchant behind a payment facilitator | Two codes joined by an @, like BB731560@6369253D |
Split Configuration ID | The rules for how each payment gets divided up (fees, merchant share) | Starts with SCNF |
PSP Reference | Adyen's unique ID for a single transaction. In the Valpay portal you'll see it called the Transaction ID or Processor Reference | 16 characters, letters and numbers |
Merchant Reference | Your own reference for a transaction, like an order or invoice number | Whatever you send on the payment |
How they all fit together
Think of it as layers. At the top is the Merchant Account, which is the Adyen account your platform processes payments through. You'll usually have one per region, so a partner live in the US and the UK would have one for each.
Under that, every business you board gets a Legal Entity. This is who the business is: the legal name, address, owners, tax details. It's what Adyen verifies during onboarding, so if a merchant is stuck in KYC or Adyen is asking for more documents, the Legal Entity ID is the one that matters.
The Legal Entity has one or more Business Lines, which tell Adyen what kind of business it is and the channel it sells through. A merchant that takes payments in store and online can have a business line for each. These come up mostly when adding payment methods, since Adyen needs to know which business line the method belongs to.
Next is the Account Holder. If the Legal Entity is who the business is, the Account Holder is what it's allowed to do. Capabilities like receiving payments and sending payouts live here, and if one of those gets switched off, this is where you'll see it.
Each Account Holder has one or more Balance Accounts. This is where the merchant's money lands after a payment settles and where fees get taken out. A merchant can have more than one, for example a separate balance account per store or per currency. If you've got a question about a payout amount or a deposit that looks off, the Balance Account ID is what we'll ask for.
Each Balance Account pays out to a Transfer Instrument, which is just Adyen's name for the merchant's verified bank account. When a merchant changes their bank details a new Transfer Instrument gets created, so you might see more than one on a merchant over time.
Finally there are Stores, one for each location the merchant takes payments from. This is where it gets a little confusing because every store has two IDs. The Valpay Store ID is our internal ID and it's what you'll see in the Valpay portal. The Adyen Store ID is Adyen's ID for that same store and it's what shows up in Adyen reports and the Customer Area. They point to the exact same location, they're just two systems keeping track of it. Terminals get assigned at the store level, and every payment has to include the store so it routes to the right merchant.
Each store also has a Split Configuration attached. That's the set of rules that decides how a payment gets divided once it settles, like how much goes to the merchant's balance account and how much covers fees.
Most merchants also have a Sub-Merchant ID. Because Valpay is a payment facilitator, the card schemes need to know which merchant is actually behind each payment, and this is the ID that tells them. Valpay sends it to Adyen on the merchant's transactions so you don't need to do anything with it day to day. Some partners do use it in their own software though, for example when setting up web payments, so if your integration asks for a Sub-Merchant ID this is the one.
Which ID to send when you contact support
Sending the right ID up front means we can jump straight into the issue instead of trying to track the merchant down first. Here's what we'll usually need:
If your question is about | Send us |
A specific transaction, refund or chargeback | PSP Reference, which shows as the Transaction ID or Processor Reference in the Valpay portal (and the Merchant Reference if you have it) |
A payout or deposit amount | Balance Account ID and the payout date |
Onboarding, KYC or requested documents | Legal Entity ID |
Changing or verifying bank details | Transfer Instrument ID or Legal Entity ID |
A terminal or a store not processing | Adyen Store ID or Valpay Store ID, plus the terminal serial number |
Payment methods not showing up | Adyen Store ID and Business Line ID |
Fees or how a payment was split | Valpay Store ID |
If you're not sure, the Valpay Merchant ID plus the store name is always a good starting point and we can find the rest from there.
A couple of things to watch for
Business Line IDs and Transfer Instrument IDs both start with SE, so they're easy to mix up. Check what the ID is attached to before sending it over.
The Valpay Store ID and the Adyen Store ID are not interchangeable in API calls. When a request asks for the store, use the Store ID provided to you after onboarding was completed.
Some older merchants may have a Legal Entity ID that doesn't start with LE. That's expected and it still works the same way.
