Estimated Setup Time: Less than 5 Minutes Setup. 5 Easy Steps.

Jovvie Checkout for Woo
Quick Start Setup Guide

Difficulty Level = EASY

Overview

This guide will walk you through setting up Jovvie Checkout as a payment gateway for your WooCommerce store, enabling you to accept in-person payments.

Prerequisites

  • WordPress website with WooCommerce installed
  • Jovvie Checkout plugin file downloaded locally
  • Admin access to your WordPress dashboard
  • Pop-ups enabled in your browser

Step 1: Download and Install the Jovvie Checkout Plugin

  1. Download the Plugin

  2. Access WordPress Dashboard

    • Log into your WordPress admin area

  3. Navigate to Plugins

    • In the left sidebar, click “Plugins”

  4. Add New Plugin

    • Click “Add New” button

  5. Upload Plugin

    • Click “Upload Plugin” button
    • Click “Choose file”
    • Select the Jovvie Checkout WooCommerce gateway plugin file from your computer
    • Click “Install Now”

  6. Activate Plugin

    • Once installation is complete, click “Activate Plugin”

Step 2: Configure WooCommerce Payment Settings

  1. Access WooCommerce Settings

    • In your WordPress dashboard, click “WooCommerce”
    • Click “Settings”
    • Click “Payments” tab

  2. Find Jovvie Payments

    • Locate “Jovvie Payments” in the payment methods list
    • Click “Manage” next to Jovvie Payments

Step 3: Connect with Jovvie Payments

  1. Account Management Tab

    • You’ll see several tabs: Account Management, Location Terminals, and Payment Connect
    • Click on the “Account Management” tab

  2. Under Connection Status section

    • Click the blue “Connect with Jovvie Payments” button
    • A pop-up window will appear (ensure pop-ups are enabled in your browser)

Step 4: Create or Login to Jovvie Account

Option A: Create New Account

  1. In the pop-up, select “Create New Account”
  2. Fill in the required information:
    • Full name
    • Email address
    • Password
  3. Click “Continue”

Option B: Login to Existing Account

  1. In the pop-up, select “Login to Existing Account”
  2. Enter your Jovvie credentials
  3. Click “Continue”

Step 5: Connect with Stripe

  1. Access Stripe Connection

    • After account creation/login, scroll down in the pop-up
    • Click “Connect with Stripe”

  2. Stripe Account Setup

    • If you have an existing Stripe account:
      • Enter your existing Stripe email address
      • Enter your Stripe account password
      • Click “Submit”
    • If you need a new Stripe account:
      • Enter a new email address
      • Follow the prompts to create a new Stripe account

  3. Select Stripe Account

    • Choose the Stripe account you want to connect to Jovvie
    • This account will handle all payment processing and transaction listings

Step 6: Complete WooCommerce Integration

  1. Finalize Connection

    • After Stripe connection is established, click the “Connect” button
    • This generates secure API keys for the connection between Jovvie Payments and Stripe

  2. Verify Connection Status

    • Check that the connection status shows “Connected”
    • Verify that both Public Key and Secret Key fields are populated
    • Verify the Enable/Disable option is selected as Enabled

Step 7: Set Up Webhooks (Recommended)

  1. Access Webhook Settings

    • In the Jovvie payment settings, locate the Webhook URL
    • Copy the provided Webhook URL

  2. Configure Stripe Webhook

    • Log into your Stripe account
    • Navigate to Webhooks section
    • Create a new webhook using the copied URL
    • This ensures proper communication between Stripe and your WooCommerce site

Step 8: Configure Location and Terminals

Set Up Location

  1. Access Location Settings

    • In Jovvie settings, click the “Location Terminals” tab
    • Click “Create New Location”

  2. Enter Location Details

    • Provide a descriptive name for your location
    • Enter the complete business address
    • Click “Save Changes”

  3. Note Location ID

    • Save the generated Location ID – you’ll need this for the Jovvie app setup, if you decide to use Bluetooth readers or Web Internet Readers

Configure Terminals (Choose Your Option)

Web Terminal Readers:

  • Stripe S700
  • Wise POS E

Bluetooth Readers (via Jovvie App):

  • M2 Bluetooth reader
  • WisePad 3 Bluetooth reader
  • Tap to Pay on Android (via Jovvie app)
  • Tap to Pay on iPhone (via Jovvie app)

For Web-Based Readers:

  1. Applies to Stripe S700 and WisePOS E
  2. Power on the device
  3. Generate a registration code in the settings
  4. Assign a descriptive label to the reader

Step 9: Test Your Setup

  1. Access Checkout

    • Go to your WooCommerce store’s checkout page
    • Add items to cart and proceed to checkout

  2. Verify Payment Option

    • Look for “Jovvie Payments” in the payment options
    • Select this option to test the integration

  3. Complete Test Transaction

    • Follow the prompts to process a test payment
    • Verify the payment flows correctly through Jovvie

Step 10: Set Up Tap to Pay and Bluetooth Device Readers

The Jovvie app allows in-person payments with any reader and is required for Bluetooth-enabled devices and Tap to Pay on iOS and Android devices with NFC capabilities.

Note: Supported device readers include Stripe Reader M2, BBPOS WisePad3, Tap to Pay for iPhone, Tap to Pay for Android, Stripe Reader s700, and Wise POS E.

Download the Jovvie App

The Jovvie app is available for both iOS and Android:

Set Up the Jovvie App to Accept In-Person Payments

  1. Launch and Configure the App

    • After installing the Jovvie app on your device, launch the app
    • Tap on the Jovvie icon in the upper-right corner
    • Use your home URL or shop URL for the Home URL
    • Tap to edit the Home URL, and enter the URL

  2. Link Your Payment Account

    • Link your Jovvie payments account to the app by tapping Payment Server > Link Payment Accounts
    • Tap “Already have an account” and sign in to Jovvie as completed in Step 3
    • After signing in, tap “Connect” to enable Payments on the Jovvie app
    • The app will ask for a confirmation to Save API credentials. Tap “OK”
    • From the Payment Server settings, tap the “Back” button

Congrats! You’ve linked Payments to the Jovvie app. Now, let’s set up the Credit Card Gateway.

Set Up the Credit Card Gateway

  1. Enable Credit Card Gateway

    • Tap the “Credit Card Gateways” under settings and Enable the Credit Card Gateway
    • Tap “Add Credit Card Gateway”

  2. Select Connection Type Select the Connection Type that applies to your payment device reader:

    • Bluetooth: M2; WisePad 3
    • Internet: Stripe Reader s700; Wise POS E
    • Tap to Pay: NFC-enabled device

  3. Configure Device Settings

    • Find the Stripe Location ID you set up previously in Step 8 under WooCommerce > Settings > Payments > Jovvie Payments > Location & Terminals
    • Select your payment device reader as the Device, and set the Stripe Location ID
    • Close the Credit Card Gateway Settings

  4. Accept Permissions

    • Once closed, a permission screen will automatically appear in the app
    • Accept the permissions to connect to the reader
    • Once credit card setup is successfully completed, a green dot will appear on the credit card icon

Note: The first time connecting a payment device reader will require an update. Keep the device powered on and plugged in to avoid update failures.

Congrats! Setup is complete, and you can now accept in-person payments with the Jovvie app.

Troubleshooting Tips

  • Pop-up Issues: Ensure your browser allows pop-ups for your WordPress site
  • Connection Problems: Verify that all API keys are properly generated and saved
  • Webhook Errors: Double-check that the webhook URL is correctly configured in your Stripe account
  • Reader Issues: Ensure web-based readers are powered on and properly registered

Support

If you encounter any issues during setup, ensure that:

  • Your WooCommerce plugin is up to date
  • You have proper admin permissions
  • Your internet connection is stable during the setup process
  • All required fields are completed accurately

Your Jovvie Checkout payment gateway is now ready to accept in-person payments through your WooCommerce store!