โ† Back Payment Methods

๐Ÿ’ณ Setting Up Payment Methods

Overview

ninoPOS accepts money in two different places, and it is important to know the difference:

This guide covers both. Most of it is about the Payment Settings page, because that is the part you set up once.

Two places money comes in
โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”        โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚   AT THE POS TILL         โ”‚        โ”‚   ONLINE PAYMENTS          โ”‚
โ”‚   (customer in the shop)  โ”‚        โ”‚   (invoice / storefront)   โ”‚
โ”‚                           โ”‚        โ”‚                            โ”‚
โ”‚   ๐Ÿ’ต Cash                 โ”‚        โ”‚   ๐Ÿ’ณ PayPal (cards)        โ”‚
โ”‚   ๐Ÿ’ณ Card                 โ”‚        โ”‚   ๐Ÿ“ฑ Snippe (mobile money) โ”‚
โ”‚   ๐Ÿ“ฑ Mobile money         โ”‚        โ”‚   ๐Ÿฆ Bank transfer         โ”‚
โ”‚                           โ”‚        โ”‚                            โ”‚
โ”‚   Always available.       โ”‚        โ”‚   Turn on + enter          โ”‚
โ”‚   Built in.               โ”‚        โ”‚   details in Settings.     โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜        โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
โš ๏ธ Admin only

Only an admin can open Payment Settings and change these details. Cashiers and other staff will not see this page. This protects your account keys.

Part 1: Online Payment Settings

How to open the page

1
Go to Settings โ†’ Payment Settings

From the left sidebar, click Settings. On the Settings page, open Payment Settings.

You will see the heading Payment Settings with the line "Accept payments via PayPal, Snippe, or bank transfer." There is a Back to Settings link at the top, and Reset and Save buttons in the top right.

๐Ÿ’ก The Save button

The Save button stays grey until you actually change something. After you edit a field, it turns on. Nothing is saved until you click it. Use Reset to throw away changes you have not saved yet.

The page has four parts

Payment Settings Reset Save Accept payments via PayPal, Snippe, or bank transfer. Default provider Which gateway customers see first at checkout. Snippe (mobile money) โ–พ PayPal Snippe (M-Pesa / Mobile Money) recommended for East Africa Merchant ID MPESA123 API key โ€ขโ€ขโ€ขโ€ขโ€ขโ€ขโ€ขโ€ข (set โ€” leave to keep) Encrypted at rest. Bank transfer (manual) 1 2 3
Illustration of the Payment Settings screen โ€” your real screen may look a little different.  1 Choose default provider ยท 2 Enter that provider's credentials ยท 3 Save
2
Choose your Default provider

At the top there is a box called Default provider, with the note "Which gateway customers see first at checkout." Click it and pick one:

  • PayPal
  • Snippe (mobile money)
  • Bank transfer (manual)

You can also leave it on โ€” none โ€”. This decides which provider is used by default โ€” and choosing one here automatically turns it on when you save, so make sure you have filled in that provider's credentials lower down the page first.

3
Turn on and fill in each provider

Each provider is a card with an on/off switch on the right. When you switch it ON, its fields appear. When it is OFF, the fields are hidden and it is not offered to customers.

๐Ÿ’ณ PayPal (for card payments)

Switch on PayPal to accept debit and credit cards from around the world. Fill in these fields:

๐Ÿ’ณ PayPal Switch: ON
AZ1... (paste from PayPal)
Copy this from your PayPal developer account.
โ€ขโ€ขโ€ขโ€ขโ€ขโ€ขโ€ขโ€ข (set โ€” leave to keep)
Kept secret. Encrypted at rest. Leave it as dots to keep the one you already saved.
โ–ผ Sandbox (test) / Live
Use "Sandbox (test)" while trying it out. Switch to "Live" when you are ready to take real money.
โš ๏ธ Test first with Sandbox

Leave Mode on Sandbox (test) until everything works. In Sandbox no real money moves. Only switch to Live when you are sure โ€” otherwise customers may be charged during testing.

โšก Snippe (M-Pesa and mobile money)

This card is titled Snippe (M-Pesa / Mobile Money) and carries the tag "recommended for East Africa". Snippe lets your customers pay online with M-Pesa and other mobile money, and it also handles cards. Switch it on and fill in:

โšก Snippe (M-Pesa / Mobile Money) Switch: ON
MPESA123
Your Snippe merchant number.
โ€ขโ€ขโ€ขโ€ขโ€ขโ€ขโ€ขโ€ข (set โ€” leave to keep)
Kept secret. Encrypted at rest. Leave it as dots to keep the one you already saved.
๐Ÿ’ก M-Pesa is a bigger topic

For step-by-step help getting your Snippe / M-Pesa details and connecting them, see the M-Pesa Setup guide.

๐Ÿฆ Bank transfer (manual)

Switch on Bank transfer (manual) if you want customers to send money straight to your bank account. This is "manual" because the money arrives in your bank the normal way โ€” ninoPOS just shows the customer your details and the instructions. You then confirm the payment yourself once it lands.

๐Ÿฆ Bank transfer (manual) Switch: ON
Nino Traders Ltd
0123456789
CRDB Bank
Kariakoo
CORUTZTZ
For international transfers. Leave blank if not needed.
Please include invoice number as reference.
A short note shown to the customer. Up to 1000 characters.
4
Click Save

When you are done, click Save in the top right. You will see a message that says "Payment settings saved." If a save fails, an error message tells you why โ€” check the field and try again.

๐Ÿ”’ Your secret keys are safe

The Client secret and API key are stored encrypted. When you come back to the page later, they show as dots (โ€ขโ€ขโ€ขโ€ขโ€ขโ€ขโ€ขโ€ข) instead of the real value. If you leave the dots and save, the saved key is kept. Only type in this field when you want to replace the key with a new one.

Field Provider What it is
Client ID PayPal Public ID from your PayPal account
Client secret PayPal Secret key (kept encrypted)
Mode PayPal Sandbox (test) or Live (real money)
Merchant ID Snippe Your Snippe merchant number
API key Snippe Secret key (kept encrypted)
Account name / number, Bank, Branch, SWIFT Bank transfer Your bank details, shown to the customer
Instructions to customer Bank transfer A short note (e.g. "use invoice number as reference")

Part 2: Payment Methods at the POS Till

The POS till has its own payment buttons built in. You do not set these up on the Payment Settings page โ€” they are always there for your cashiers.

When you finish a sale and open the Payment window, you see three buttons under Payment Method:

POS Payment window
โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚  Payment                                    โ”‚
โ”‚                                             โ”‚
โ”‚  Payment Method                             โ”‚
โ”‚  โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”        โ”‚
โ”‚  โ”‚  CASH   โ”‚ โ”‚  CARD   โ”‚ โ”‚ MOBILE  โ”‚        โ”‚
โ”‚  โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜        โ”‚
โ”‚                                             โ”‚
โ”‚  Subtotal ........................ 95,000   โ”‚
โ”‚  Tax ............................. 15,200   โ”‚
โ”‚  Total Due ...................... 110,200   โ”‚
โ”‚                                             โ”‚
โ”‚          [ Complete & Print ]               โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
Button What happens
๐Ÿ’ต CASH A Cash Received box appears. Type what the customer handed you, and the system works out the change.
๐Ÿ’ณ CARD Records the sale as a card payment. You take the card on your own card machine.
๐Ÿ“ฑ MOBILE A list of mobile money providers appears, plus a box for the customer's phone number.

Mobile money providers at the till

When you tap MOBILE, you can pick which network the customer is using:

Choosing the right provider and entering the Customer phone keeps your records clean, so you can tell later exactly how each sale was paid.

๐Ÿ’ก Selling on credit

To let a customer pay later, choose CASH and enter 0 in the Cash Received box for a saved customer. The balance is kept as what they owe. For the full walk-through of the till, see the Making a Sale guide.

Which one should I turn on?

You want to... Use this
Take money face-to-face in the shop POS till buttons (Cash / Card / Mobile) โ€” already on
Let customers pay an invoice with M-Pesa or mobile money online Turn on Snippe
Take card payments online from anywhere Turn on PayPal (or Snippe)
Have customers send money to your bank Turn on Bank transfer (manual)
โš ๏ธ Turning a provider off

If you switch a provider OFF and Save, customers can no longer pick it online. Your saved keys are kept, so you can switch it back on later without typing them again.

Related Articles