Pay with 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 Accept Payments for the POS

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

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

  3. Link your Jovvie payments account:

    • Tap Payment Server > Link Payment Accounts.

    • Create a New account (free account) or Tap Already have an account.

    • After signing up or signing in, tap Connect with Stripe to pair your account with Stripe.

    • After linking your account, when prompted, tap OK to save API credentials.

    • Tap the Back button to return to settings.

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

STEP 2: 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 Stripe Account.

  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 3: Set Up the Jovvie App to Pay Home URL

  1. Select Home URL
  2. Pay, use:

    • Home URL:

      https://payments.bizswoop.app/pay
 

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 or Create Payment to input a payment

  2. Input amount.

  3. Tap Pay.

  4. Follow the prompt to Swipe, Insert, or Tap the credit card on the reader device or phone/mobile device using Tap to Pay. (For the first payment, you’ll be prompted to enter your checkout PIN for security.)

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