Skip to main content
A Payment Type represents one payment method your business accepts — Cash, Credit Card, Stripe, and so on. Each type can have zero or more processors attached to actually move the money (or, for cash, no processor at all — the cashier just records the amount tendered). Payment types appear as buttons at checkout on both the POS terminal and the online QR ordering page.
Payment Types list screen showing Cash, Card, and Online payment methods

​
Payment Type Fields

Use clear, consistent codes that match your reporting needs — CASH, CARD, EWALLET, ONLINE rather than numbers or abbreviations that may confuse staff reading reports later. Group Code and Fast Payment are purely presentational: they change how the button looks and behaves on the POS, not how the payment is processed.

​
Create a Payment Type

1

Go to Manage → Payment Types

Click Payment Types in the left sidebar under Manage.
2

Click New Payment Type

Fill in the Code, Name, Group Code, Fast Payment, and Active fields.
3

Save

Click Create. The payment type appears in the list immediately and is available on the POS.

​
Attach a Processor

Processors handle the actual transaction for non-cash payment types. The Add processor dropdown on the edit screen is populated dynamically from the backend — it lists whatever processor types are enabled for your account, so the exact set you see may differ from another tenant’s. Commonly available processors include Stripe, Share Commerce, and Share Commerce ePay — see Two Share Commerce Processors below before picking between the latter two. Each processor you add gets its own configuration panel with whatever fields that processor needs — a mix of text inputs, checkboxes, and dropdowns supplied by the backend. Some processors need no configuration at all, in which case the panel simply reads “No configuration required.”
1

Open the edit page

Click the Edit (pencil) icon next to the payment type.
2

Add a processor

In the Processors section, click Add processor, choose one from the dropdown (e.g. Stripe, Share Commerce, or Share Commerce ePay), and it’s added to the list below with its own config panel.
3

Fill in the config panel

Enter whatever fields that processor asks for. For example:
  • Stripe: Secret Key and Webhook Secret
  • Share Commerce: Terminal IP Address, Terminal Port (default 8890), and Terminal Model (A90 Pro or MF919 Pro)
  • Share Commerce ePay: Merchant ID, Secret Key, and Environment (staging or production)
All credentials are encrypted with AES-256 before saving — they are never stored in plain text.
4

Save

Click Save Processors. The processor is now active for that payment type.
Nothing stops you from attaching more than one processor to the same payment type, but that’s not typical usage — most restaurants doing both dine-in card and online/QR ordering end up creating two separate payment types: one for the in-person terminal (Share Commerce) and one for online (Stripe or Share Commerce ePay). Keeping them separate makes reports easier to read, since payment type is what shows up in your sales breakdowns.
Never share your API credentials. They are masked (••••••) after saving. To update a credential, enter a new value — leaving it blank keeps the existing one. If you believe your credentials have been compromised, rotate them immediately in your payment gateway dashboard and update them here.

​
Two Share Commerce Processors

The “Add processor” dropdown lists Share Commerce and Share Commerce ePay as two separate entries, and it’s easy to pick the wrong one since the names look nearly identical. They do very different jobs: Share Commerce = physical countertop card terminal, tap goes here. Share Commerce ePay = online gateway, no device, customer pays from their phone after scanning a QR.
The dropdown may render these with their raw internal labels — “ShareCommerce” for the terminal and “ShareCommerce E-Payment” for the online gateway. If in doubt, check the fields that appear after adding one: Terminal IP Address means you picked the physical terminal; Merchant ID means you picked the online gateway (ePay).
Rule of thumb: customer tapping or inserting a card at the counter → Share Commerce. Customer paying from their own phone after a QR scan → Share Commerce ePay.

​
Deactivate vs Delete

Deleting a payment type that has been used in past transactions is not allowed. Deactivate it instead to keep your historical records intact.

​
Frequently Asked Questions

The list is backend-driven, so it can vary by account, but commonly available processors include:
  • Stripe: Credit/debit cards via Stripe Checkout, for online ordering
  • Share Commerce: Physical countertop card terminal, for in-person POS payments
  • Share Commerce ePay: Online payment gateway, for QR/web ordering
Contact your account manager if you need a processor that isn’t in your dropdown.
Check these things in order:For Stripe:
  1. Your Secret Key starts with sk_live_ (production) or sk_test_ (testing) — don’t mix them
  2. The Webhook Secret starts with whsec_ and matches exactly what is shown in Stripe Dashboard → Developers → Webhooks → your endpoint → Signing secret
  3. Your payment type is set to Active
For Share Commerce (terminal):
  1. The Terminal IP Address is correct and the terminal is on the same network as your POS
  2. The Terminal Port matches what’s configured on the device (default 8890)
  3. The Terminal Model selected matches your actual hardware
For Share Commerce ePay:
  1. Your Merchant ID and Secret Key are correct for the selected Environment (staging vs. production)
  2. Your merchant account is active and verified at Share Commerce
  3. Your payment type is set to Active
See Payment Issues for more help.
Cash types do not require a processor — the cashier records the amount received and the system calculates change. Card/online types typically have a processor that handles the transaction electronically. You can create as many types as you need (e.g. separate types for Visa and Amex if you want to track them separately).
Log in to dashboard.stripe.com, go to Developers → API keys. Use the Secret Key (not the Publishable Key). See Stripe Setup for a step-by-step guide.
Log in to your Share Commerce Merchant Portal to find your Merchant ID and Secret Key. See Share Commerce Setup for a step-by-step guide. If you’re instead setting up the physical countertop terminal, there’s no merchant portal step — you just need the terminal’s IP address and model.

Stripe Setup

Connect Stripe for online payments

Share Commerce Setup

Connect Share Commerce ePay for QR/online ordering

Settings

Configure general tenant and device settings

Payment Issues

Troubleshoot payment problems