Overview

Introduction

Simple Cloud Integration (SCI) is a cloud-based payment integration that enables your POS to make in-store payments and other transactions via an EFTPOS terminal.

SCI communicates entirely through cloud APIs — there is nothing to install or run locally. Your POS calls the SCI APIs directly, and mx51 handles the connection to the terminal.

How it works

SCI exposes two separate APIs, each with its own authentication method that your POS integrates with:

The base URL for the SCI API is unique per terminal pairing and is returned when you complete a pairing. You must store it alongside each pairing record.

How to integrate SCI

The following guides will walk you through the steps to develop your SCI integration and get it certified.

1. Getting started
   1. Obtain your credentials from mx51.
   2. Complete the pairing flow to connect your POS to an EFTPOS terminal.
   3. Implement the pairing UI requirements.
2. Transactions
   1. Understand the polling loop and how to process transaction updates.
   2. Implement the Action Framework to render your transaction UI dynamically.
3. Purchases, refunds and signatures
   1. Create purchase, refund and other transaction types.
   2. Handle signature transactions.
4. Transaction recovery
   1. Handle network failures and transaction timeouts gracefully.
   2. Implement the override flow — a mandatory mechanism that allows merchants to manually confirm a transaction outcome when it cannot be provided by the SCI API.
5. Develop any additional features such as tips and surcharges, MOTO, cashout, settlement and terminal receipt configuration.
6. Test your integration and get it certified by our team.

Resources

• SCI API documentation
• Gecko Bank guide
• Glossary

📘

About us

At mx51, we provide Payments as a Service (PaaS) and a range of complementary services to our partners, empowering them to connect with merchants and their customers. Learn more about us