Getting Started

How to

Features

Multiple Users & Roles

Payment Gateways

Stripe Terminal

Overview of setting up Stripe Terminal readers support

To support Stripe Terminal, a one-time setup is required for: Jovvie App. 

Prerequisite Requirement: Download and Install the Jovvie App

Android App

iOS App

Sunmi App

Prior to starting Step 1 download the Jovvie app from the Apple App store for iOS devices or the Google Play Store for Android devices. The Jovvie app is required to connect Stripe Terminal readers to the Jovvie Point of Sale by BizSwoop.

STEP 1: Set Up the Jovvie App to POS Stations for Home URL

  1. Install the Jovvie app on your device and launch it.

  2. Tap the Jovvie icon in the upper-right corner.

  3. Select Home URL

  4. For Self-hosted POS, use:

    • Default POS Station: Use your Home URL:

      https://mywebsite.com/pos

    • Custom Station: Use the station ID:

      https://mywebsite.com/pos/[id]

  5. For Cloud POS, use:

    https://pos.bizswoop.app/[application-name]/[pos-station-name]

    Note: The POS Application name and Station name can be customized in your Cloud Account.

 

STEP 2: Set Up the Jovvie App to Accept Payments for the POS

  1. Link your Jovvie payments account:

    • Tap Payment Server > Link Payment Accounts.

    • Tap Already have an account and sign in.

    • After signing in, tap Connect to enable payments.

    • When prompted, tap OK to save API credentials.

    • Tap the Back button to return to settings.

  2. Payments are now linked! Next, set up the Credit Card Gateway.

STEP 3: Configure Credit Card Gateway for Jovvie App

Set Up the Credit Card Gateway

  1. Open Settings > Credit Card Gateways and enable the gateway.

  2. Tap Add Credit Card Gateway.

  3. Select the connection type based on your payment device:

    • Bluetooth: M2; WisePad 3

    • Internet: Stripe Reader S700; Wise POS E

    • Tap to Pay: NFC-enabled device

  4. Retrieve the Stripe Location ID from POS > Stations > Terminal Readers.

  5. Select your payment device as the Device and set the Stripe Location ID.

  6. Close the Credit Card Gateway settings.

  7. A permission screen will appear—accept permissions to connect to the reader.

  8. When setup is complete, a green dot will appear on the credit card icon.

Note: The first connection may require a device update. Keep it powered and plugged in to avoid failures.

Step 4. Process Transactions

The Jovvie app will show the Credit Card icon in the top bar and a status of the Credit Card gateway connection with Stripe Terminal for processing payments. 

Status Color Key

Red: Credit Card connection is not established for processing payments

Yellow: Credit Card connection is connecting to service

Green: Credit Card connection is secure and ready for processing payments

To process a payment:

  1. Tap the Home button to load your POS station and sign-in.

  2. On the payment page, select Swipe/Insert/Tap.

  3. Tap Pay.
    (Select Android/iOS App Terminal when taking payments with the mobile app. Tap the option, then tap Pay to trigger the reader. If you only use the app and do not need Internet readers, go to POS > Settings > Gateways > Swipe/Insert/Tap and set Terminal Types to Android/iOS App Terminal to remove the extra selections)

  4. Follow the prompt to Swipe, Insert, or Tap the credit card on the reader device or phone/mobile device using Tap to Pay.

You’re all set! You can now accept in-person payments with the Jovvie app. 🎉