Stripe Integration

June 03, 2025 07:11

Overview

Stripe is a leading payment platform that enables businesses to accept credit cards, debit cards, and digital wallet payments (like Apple Pay and Google Pay). It is especially popular for online sales but also supports in-person transactions using dedicated Stripe terminals.

Stripe provides a secure and scalable platform for processing online and in-person payments. retailcloud integrates with Stripe using the official Stripe Terminal SDK, enabling POS and kiosk users to accept card and wallet payments directly through supported Stripe payment terminals.

retailcloud supports integration with Stripe, a powerful and flexible payment processing solution for in-store and online sales. With this integration, merchants can use Stripe terminals to accept a variety of payment methods directly through the retailcloud POS systems.

Stripe is a leading global financial technology platform used by businesses of all sizes to:

Accept in-person and online payments.
Send payouts.
Manage subscriptions and recurring billing.
View real-time reporting, settlements, and financial analytics.

How It Works?

A customer checks out at a POS.
The POS triggers a payment request to the assigned Stripe terminal.
The customer taps, inserts, or swipes their card (or uses Apple Pay/Google Pay).
Stripe authorizes and processes the transaction.
retailcloud records the result and completes the sale.

Key Features

Centralized configuration in Console with OAuth-based secure account pairing.
Support for store mapping for accurate device routing.
Support for card payments, wallet payments, split tenders, refunds, capturing tips, and offline mode.
Merchant-controlled offline transaction limit to maintain security during network outages.

In this guide, you’ll learn:

What Stripe is and how retailcloud uses it.
Step-by-step instructions on how to set up and pair a Stripe account in retailcloud Console.
Details on how to connect payment terminals and registers.
Supported and unsupported transaction types.

How to Setup and Pair Stripe from Console?

Accessing Stripe Integration

To connect your Stripe account:

Log in to your retailcloud Console.
Navigate to Settings → Integration → Stripe.
A modal window titled “Pair your Stripe account” will appear, containing a single primary action button: Connect.
Clicking on Connect will redirect the users to the Stripe’s secure login page.
Here you can log in to an existing Stripe account, or create a new account.
Once signed in, a successful message will be shown as “Authorization was successful. You are being redirected to the retailcloud Console.”
Once the user completes authentication in Stripe and is redirected back to retailcloud, the system confirms a successful connection and automatically updates the integration screen.
- Account Number
  - The Stripe Account ID (e.g., acct_1A2B3C4D5E) is automatically populated in the Account Number field, confirming that the account has been successfully linked.
- Maximum Limit
  - Set limits for offline transactions (store & forward).
  - The user can now enter a “Maximum Limit,” which defines the maximum transaction value that can be processed when the terminal is operating in store-and-forward mode (offline). This ensures transaction limits are enforced even when the terminal is temporarily without internet connectivity.
- Store Mapping
  - Map Store → Stripe Location → Register → Terminal Serial Number
  - Users can map each retailcloud Store to a corresponding Stripe Location.
  - Each retailcloud stores can be linked to a specific Stripe Location ID to ensure that the right terminal register is connected to the right store.
- Register
  - For each mapped store and location, additional configuration can be applied: Registers can be linked to the appropriate Stripe Location.
- Connection Type:
  - Connection Type defines how the POS communicates with the Stripe payment terminal assigned to a register. It tells the POS which hardware connection method to use when sending payment requests, ensuring that transactions are routed correctly and processed without errors.
  - This is configured at the register level in the Console allowing each register to be paired with the appropriate Stripe hardware and connection method based on the store's setup.
  - When configuring a register, users can select one of the following connection types:
    - Internet
    - Bluetooth
    - USB
    - Tap to Pay
- Device Serial Number
  - For each stripe location, you can enter serial numbers of stripe payment devices.
  - For each stripe location, users can input the serial numbers of connected terminals.
  - This helps manage multiple devices per location and ensure accurate routing.
  - This allows:
    - Multiple payment terminals to be managed under one location
    - POS transactions to be accurately routed based on the specific terminal used
    - Better device management and reporting visibility
- POS Capabilities After Configuration
  - Once mapping is completed, Retailcloud POS can use the connected Stripe terminals to support:
    - Card payments
    - Wallet payments
    - Sales processing
    - Refunds
    - Split payments
    - and other standard payment workflows supported by the terminal.
- Save the Configuration
  - When the configuration is complete, selecting Save updates and stores the details in the retailcloud backend.
  - A confirmation notification is displayed to the user, indicating successful setup.
  - From this point forward, the Stripe and retailcloud connection is fully active.
- Disconnect
  - The interface also now shows a Disconnect button, allowing users to revoke the connection at any time. This confirms that the Stripe account pairing is complete, active, and ready for use in production.

Articles in this section