retailcloud Payments: Stripe Embedded Integration

February 06, 2026 05:39

What is retailcloud Payments?

retailcloud Payments is an integrated payment management solution within the retailcloud Console that allows users to set up and manage their payment processing account entirely from one place.

Using Stripe Embedded Components in the background, retailcloud provides a seamless in-app experience for onboarding, payment tracking, payouts, disputes, and terminal configuration without requiring users to leave the Console.

Unlike traditional external payment processor integrations, retailcloud Payments brings Stripe’s core payment management tools into retailcloud itself, allowing merchants to:

Create and connect a Stripe account
Complete Stripe onboarding within Console
View payment transactions
Monitor payouts
Review disputes
Manage business and banking details
Configure Stripe terminals and registers

All of these actions are performed inside:

Console → Financial → Payments

This provides merchants with a unified and simplified payment experience while eliminating the need to separately log in and manage most Stripe functions externally.

Difference between retailcloud Payments and Standard Stripe Payment Processor

retailcloud Console supports two different Stripe-related configurations, and it is important to understand the difference before setup.

retailcloud Payments: Stripe	Standard Stripe Payment Processor
Located under Console → Financial → Payments → Stripe	Located under Console → Settings → Payment Processor → Stripe
Full Stripe account onboarding and management is embedded within retailcloud Console	Only used to configure Stripe as a payment processor/terminal connection
Users can view Stripe payment details, payouts, disputes, documents, and account settings directly in Console	Users cannot access Stripe management UI from Console
Stripe account creation happens inside retailcloud	Stripe account management happens outside retailcloud
Includes embedded Stripe dashboard-style tabs	Only terminal/payment tender connection setup
Best suited for users who want centralized Stripe management inside Console	Best suited for users who only need Stripe as a payment tender

Note: Only one Stripe integration can remain active

If the Standard Stripe Payment Processor is already configured, users must disconnect it before using retailcloud Stripe Payments.

Likewise, if retailcloud Stripe Payments is active, the standard processor setup cannot be configured simultaneously.

How to Connect retailcloud Payments in Console?

Navigate to retailcloud Payments

From the Console menu, navigate to: Financial → Payments
Under the Account page, users will see the option: Get Started with Stripe along with an email input field.

This is the starting point for Stripe account creation.

Create Stripe Account

Enter a valid email address.
Click Continue.

The system will begin the Stripe account creation flow and redirect the user to the next page where the Add Information option will be displayed.

Add Information to Begin Onboarding

Click Add Information.

This step starts the Stripe onboarding process required to begin accepting payments.

The user will then be asked to:

Create a password
Complete QR code verification/authentication
Return back into retailcloud Console automatically

Once verification is completed, the user will be redirected to the Stripe onboarding screen embedded inside Console.

Complete Stripe Onboarding

Users must now provide all required onboarding information, including:

Business details
Personal verification details
Banking information
Tax/compliance details

After all required fields are completed, click: Agree and Submit

Once submitted successfully, the Stripe account becomes linked and the embedded Stripe management screen will load within Console.

Review retailcloud Payment: Stripe Tabs

After onboarding completion, users will be able to access the following Stripe management tabs directly within Console:

Payments

Payouts

Details

Terminal

These embedded tabs allow users to manage Stripe activity without leaving retailcloud.

Configure Location from Terminal Tab

The Locations tab allows merchants to create and manage Stripe Terminal locations that represent physical stores, venues, or service areas.

When creating a location, merchants can provide the location name, address details, and country. Once saved, the location is automatically created in Stripe and synchronized with retailcloud.

By default, United States will be selected.

Existing locations can be edited or deactivated when no readers are assigned.

Configure Readers from Terminal Tab

The Readers tab is used to register and manage Stripe Terminal devices associated with a location.

Merchants can pair one or multiple readers by selecting a location and entering the reader serial number(s). Once paired, readers are linked to the selected location and become available for register mapping.

The Readers page also displays important device information, including:

Serial number
Label
Stripe Location ID
Reader status
Last seen

Readers can be removed at any time, which unpairs them from both Stripe and retailcloud.

Users can pair the reader with two pairing method:

Pairing Code: User can pair with the following details:

Pairing Code
Label
Location

Serial Number: User can pair with the following details:

Serial Number
Location

Configure Register Mapping from Terminal Tab

Navigate to the Terminal - Mapping tab.
This is the most important step required to begin processing payments through Stripe terminals.

Users must configure the following:

Account Number

This field is auto-populated with the connected Stripe Account ID (example: acct_xxxxxxx).
This field is system-generated and cannot be edited.

Maximum Offline Limit

Enter the maximum amount allowed for offline/store-and-forward transactions when internet connectivity is temporarily unavailable.

Store and Register Mapping

Users must now map the payment setup using:

Store Name
Stripe Location ID
Register
Connection Type
Device Serial Number

Click Save after entering all details.

Configure Connection Type and Terminal Serial Number

For each mapped register, choose the appropriate connection type.

Available options include:

Internet
Bluetooth
USB
Tap To Pay
Apps On Device

Then enter the Stripe payment terminal serial number.

This ensures that each POS register communicates with the correct Stripe payment device.

Configure POS to Use Stripe Processor

After Console mapping is saved, the POS register must also be configured.

For ZeroPOS

Navigate to: Hamburger Menu → Configuration → Hardware → MSR

Select: Stripe

Save the configuration.

For 6ixPOS

Navigate to: Hamburger Menu → Configuration → Payments → Payment Processor