Settings — Payments

Feature Overview

Payments settings are the control center for how your restaurant accepts, processes, and manages money. From connecting your credit card processor to configuring which payment methods appear at checkout, every financial flow through the POS and online ordering runs through the rules you set here. Getting these settings right ensures seamless transactions for guests and accurate payment reporting for your team.

How It Affects the System

• The Payment Processor configuration connects your restaurant to your credit card processing provider (such as NMI or Card Connect). The processor selected here handles all card authorizations, captures, and voids. Incorrect settings will cause card transactions to fail.
• Payment Devices become visible once a card payment method is active. This section lists the physical card readers (terminals) registered to your restaurant. Devices must be registered here to accept payments.
• Card Payments settings control how credit and debit card transactions behave — including enabling or disabling specific card types and any card-specific checkout behavior.
• A Service Fee (if configured for your account) is displayed at the top of the page. This is a percentage added to credit/debit card transactions. When the fee is set to 0%, no service fee is shown on either the online ordering payment page or the POS payment screen. To change or remove your service fee, contact Katalyst support.
• The Katalyst Subscription block displays your current Katalyst subscription plan details.
• Payment method availability on the POS is directly driven by which methods are active here. If a payment type is not configured, staff will not see it as an option at checkout.

Prerequisites / Requirements

• Restaurant edit or view permissions are required.
• A valid payment processing account (NMI, Card Connect, or other supported provider) must be set up before payment devices can be registered.

Step-by-Step Guide

Accessing Payment Settings

1. Navigate to Settings > Payments.
2. If a service fee is active for your account, an informational note appears at the top of the page describing the fee percentage and which payment types it applies to.

Configuring Your Payment Processor

1. In the Payment Processor section, select your processing provider from the available options.
2. Enter the required credentials provided by your payment processor (API keys, merchant ID, terminal IDs, etc.).
3. Click Save to apply the processor settings.

Registering a Payment Device (Card Reader)

1. Once a card payment method is active, the Payment Devices section will appear.
2. Click + Add Device to register a new card terminal.
3. Enter the device's serial number or terminal ID as provided by your hardware.
4. Assign the device to the appropriate POS station.
5. Click Save to register the device.

Managing Accepted Card Types

1. In the Card Payments section, toggle individual card types (Visa, Mastercard, Amex, Discover, etc.) on or off.
2. Only toggled-on card types will be available as payment options on the POS.

Viewing Your Subscription Details

1. Scroll to the Katalyst Subscription section to view your current plan and billing information.

Common Troubleshooting / FAQs

Q: Credit card payments are failing at the POS. First, verify that your payment processor credentials are correctly entered in Settings > Payments. An incorrect API key or terminal ID will cause all card transactions to fail. Contact your payment processor's support line to confirm your credentials are active. Also verify that the payment device is registered and assigned to the correct POS station.

Q: A new card terminal is not working after I registered it. After registering a device in Settings > Payments, the POS application on that terminal may need to be restarted to establish the connection. Power cycle the terminal and reopen the Katalyst POS app. If the terminal still does not connect, confirm the terminal ID entered matches exactly what is shown on the physical device.