Setting up the Merchant
Learn how to set up merchant accounts in the Koard Merchant Management System (MMS) and configure them for tap-to-pay payments.
Complete the steps in order: create the merchant, identify its processor configuration, board a terminal, link a location, create merchant credentials, and create the app key. This is the manual alternative to API setup; complete one of the two, not both. If those items already exist, go to step 1 of your iOS or Android quickstart to confirm that you also have the app key.
A new merchant can take test payments immediately. In UAT, transactions use Koard's features and do not move money. Live payments require an activated merchant account.
| Environment | Dashboard and purpose |
|---|---|
| UAT | app.uat.koard.com, for test configuration and payments. |
| Production | app.koard.com, for separate live configuration during the Launch Checklist. |
Prerequisites
Before you begin, ensure you have:
- Access to the Koard Merchant Management System
- Valid business registration documents
- Tax identification number for each merchant
- Merchant Category Code (MCC) for each business
- Processor credentials (MID, TID, VIN) or Partner ID
1. Create a Merchant
The merchant application collects the business, processor, and location details. After the account exists, configure terminals and start taking payments.
Koard reviews this information against processor rules and Apple's Tap to Pay requirements before the merchant can go live.
Country is permanent: You can't change a merchant's country after you create the account. To use Koard in another supported country, create a new merchant account.
Privacy and security are priorities for Koard. Our merchant data handling follows industry standards for payment processing and Apple's security requirements.
1.1. Navigate to Accounts
- Log into the MMS
- Go to the Accounts tab
- You'll see your account hierarchy
- Click

1.2. Fill Required Fields
Every merchant requires these mandatory fields:
- Account name: Business name or legal entity name
- Tax ID: Unique tax identification number
- MCC: 4-digit Merchant Category Code
- Address: City, state, and postal code. Country is United States.

1.3. Save Merchant
Click Create Account to create the merchant account.
2. Identify the Processor Configuration
A terminal is boarded against one processor configuration, so find it before you create the terminal.
- Open the merchant account and go to the Processors tab.
- Find the configuration for the merchant's processor. The tab lists each configuration's name, processor, and processor config ID.
If the tab shows no processors, or the one you need is missing, contact support@koard.com. Available Processor Configurations explains how access is assigned.
3. Board a Terminal
3.1. Create New Terminal
- On the merchant account, open the Terminals tab and click

- Choose the Processor config you identified in step 2 and enter a Terminal name. The form then shows the fields that processor requires.
3.2. Enter the Processor's Details
Each processor asks for different details. Open the boarding guide for your processor configuration to see what each field means and where the value comes from.
| Processor configuration | Boarding guide |
|---|---|
| TSYS Sierra, Netevia | TSYS Sierra |
| Fiserv | Overview, Nashville, Nashville North (Global), Omaha |
| Worldpay | Worldpay |
| Elavon | Elavon |
| Payroc | Payroc |
Enter each value exactly as the processor assigned it, including leading zeros, then click Create Terminal.
To change a terminal later, open it and click

4. Create a Location and Link the Terminal
A location is where the device takes payments. It links to one terminal, and that terminal decides how the payment is routed. A merchant can have more than one terminal and more than one location.
- Go back to the merchant account to access the Locations tab

- Click
- Assign the terminal to that location
- This gives the merchant a physical location to accept payments from

5. Create Merchant Credentials
Your merchants will use these credentials to authenticate with the Koard SDK and process payments. The credentials are tied to specific locations and terminals, ensuring secure payment processing.
5.1. Generate Credentials
- Navigate to the merchant's credential section
- Click
- Copy the Access code and PIN. The PIN is shown only once.

Security Note: Keep merchant credentials confidential. Deliver them through a trusted channel. Do not hard-code merchant credentials in app source or public repositories.
6. Create the App Key
Your app initializes the Koard SDK with its own API key. Create it in UAT with the tap permission for the app's platform: payments:tap-ios or payments:tap-android. Getting an API Key walks through it.
7. Verify Merchant Setup
| Ready item | Verify before leaving this guide |
|---|---|
| Merchant | The intended account and environment are selected. |
| Terminal | Assigned processor configuration and credentials match, including leading zeros. |
| Location | It belongs to the merchant and links the intended terminal. |
| Merchant credentials | Access code and one-time PIN saved through a trusted channel. |
| App key | Created in step 6 in UAT, with the tap permission for the app's platform. |
If a check fails:
| Issue | Check |
|---|---|
| Duplicate tax IDs | Merchants with the same tax ID are grouped together. |
| Invalid MCC | Use the valid four-digit code for the business. |
| Processor mismatch | Match credentials to the assigned processor configuration and environment. |
| Unusable location | Assign the intended terminal to the merchant's location. |
For account or processor access, contact support@koard.com.
Merchant setup is complete. Continue to step 2 of your platform quickstart: iOS device setup or Android device setup. Production requires separate configuration and the Launch Checklist.
Active Location and Terminal Routing
Your app must provide a way to select the active location in settings. Authenticate the merchant, load that merchant's available locations, and let the operator select the location where the device is taking payments. The selected location_id resolves the linked terminal_id, whose processor configuration, MID, and TID determine payment routing for that merchant.
Show the active location in settings and on the payment screen. Select it before reader preparation or any payment. If the operator changes merchants, clear the previous selection and reload the new merchant's locations. If you remember a choice between sessions, validate that it still belongs to the authenticated merchant and still has a usable linked terminal. Do not silently reuse another merchant's location or select an arbitrary terminal.
- iOS: call
KoardMerchantSDK.shared.setActiveLocationID(location.id), then follow the account-linking and reader preparation flow. - Android: call the suspending
sdk.setActiveLocation(location.id), thensdk.enrollDevice()and the reader preparation flow.
Block payment initiation until location selection and required readiness checks have completed. If a location's terminal changes, reload the configuration and complete the SDK's readiness flow before taking another payment.
Keep your merchant accounts safe
After you set up your merchant accounts, you'll want to keep them secure. Here are our recommendations:
- Keep private information private: Don't share merchant credentials and keep your secret API keys confidential on your own servers. As a reminder, Koard employees will never ask you for your keys.
- Use unique credentials: Generate unique codes and PINs for each merchant. If you reuse credentials across merchants and one account is compromised, an attacker could access multiple merchant accounts.
- Use team members to provide others with access: You can invite others (with limited access) to your Koard MMS account so that they can log in and take certain actions without full administrative access.
- Update your computer and browser regularly: We recommend configuring your computer to automatically download and install updates. This helps protect your system against automated attacks and malware.
- Beware of phishing: All genuine Koard sites use the
koard.comdomain and HTTPS. If you get an email from us that you don't expect, go directly to our site to log in. Don't enter your password after clicking a link in an email. - Enable two-factor verification: When you enable two-factor authentication, you'll need to provide an additional unique code from your mobile device to complete the login process. This means that even if someone steals your username and password, they won't be able to log in.
Next Step
Continue to your platform quickstart at step 2: iOS device setup or Android device setup. Keep using the merchant, location, and credentials you just configured.

