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:

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

  1. Log into the MMS
  2. Go to the Accounts tab
  3. You'll see your account hierarchy
  4. Click
getting-started-1

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.
getting-started-2

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.

  1. Open the merchant account and go to the Processors tab.
  2. 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

  1. On the merchant account, open the Terminals tab and click
getting-started-3
  1. 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

getting-started-4

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.

  1. Go back to the merchant account to access the Locations tab
locations-1
  1. Click
  1. Assign the terminal to that location
  2. This gives the merchant a physical location to accept payments from
getting-started-5

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

  1. Navigate to the merchant's credential section
  2. Click
  1. Copy the Access code and PIN. The PIN is shown only once.
getting-started-6

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), then sdk.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.com domain 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.