Jovvie Checkout overview

Jovvie Checkout adds in-person card payments to any app or platform. Customers can tap, insert, or swipe their card on a card reader, or pay with Tap to Pay. This page explains how Checkout works, what each ready-made integration does, and where to start.

With a ready-made integration, your site creates the order, form entry, donation, or ticket order as usual. Jovvie then opens a payment page where you choose a Stripe card reader, and the customer taps, inserts, or swipes their card on the reader.

The ready-made integrations work with Stripe only. An integration you build yourself can use Stripe or NMI. For the differences, see Stripe and NMI: what’s different.

Supported integrations

Jovvie offers ready-made integrations for these plugins:

• WooCommerce: take in-person payments for orders placed through your WooCommerce checkout. The payment option is named Jovvie Payments by default.
• Gravity Forms: take one-time payments with your Gravity Forms forms. The form needs a Jovvie payment feed and a pricing field.
• GiveWP: take donations in person with your GiveWP donation forms. Donors see the payment option as Swipe, Insert or Tap Donations.
• Event Tickets: sell tickets at the door with Tickets Commerce, the checkout built into Event Tickets. The Events Calendar is optional.

Each integration is a separate Jovvie plugin or add-on that you install and connect to your Jovvie account. Your Jovvie account is linked to your Stripe account.

If your app or platform is not listed, a developer can build their own integration. See Build your own Jovvie Checkout integration.

How a payment works

With the ready-made integrations, a payment goes like this:

1. On your site, staff fill in the checkout, form, donation form, or ticket checkout and submit it.
2. Your site creates the order, entry, or donation and sends the browser to the Jovvie payment page.
3. On the payment page, staff select In-Person Payment and choose a reader.
4. The customer pays on the reader.
5. The payment page sends the browser back to your site.
6. Your site marks the order, entry, or donation as paid. When this happens depends on the integration. See What each integration does.

For the payment page steps, see Take a payment on the Jovvie payment page.

A paid order can still look unpaid

The card can be charged before your site updates the order, entry, or donation:

• WooCommerce and Event Tickets: the order is only marked paid when your site receives the payment confirmation from Stripe (a webhook).
• Gravity Forms: if the browser does not come back to your site, the entry stays Processing until an hourly check updates it.
• GiveWP: a one-time donation is only completed when the browser comes back to your site. If the browser is closed or loses its connection first, the donation can stay Pending even though the card was charged.

Before you retry or charge another way, check your Stripe Dashboard. Make sure no payment went through and none is still processing. If you are not sure, contact Jovvie support.

Who can use your readers

The payment page only lists your card readers on a device that is allowed to use them. At least one of these must be true:

• Staff are signed in to WordPress on the device.
• The browser was connected in the plugin settings. See Use Checkout on a shared or kiosk device.
• Staff know your Access PIN and enter it on the payment page.

What each integration does

	WooCommerce	Gravity Forms	GiveWP	Event Tickets
Where you take the payment	Your WooCommerce checkout page, with Jovvie Payments selected and Place order	Your form, after you submit it	Your donation form, with Swipe, Insert or Tap Donations selected	The Tickets Commerce checkout page, with Purchase Tickets
How the payment is recorded	The order starts as Pending payment. Your site moves it to Processing only when it receives the payment confirmation from Stripe. Returning to your site does not complete the order by itself	The entry starts as Processing. When the browser comes back to your site, the add-on checks the payment with Jovvie and marks the entry Paid. If the browser does not return, an hourly check updates the entry	When the payment page sends the browser back to your site, GiveWP checks the payment with Jovvie and marks the donation Complete. If the browser does not return, the donation can stay Pending after a successful charge	Your site marks the order completed when it receives the payment confirmation from Stripe. Returning to your site does not complete the order by itself
If you click ← Back before paying	You go to the order received page, and the order stays Pending payment	You return to a blank form. The entry stays Processing until the hourly check marks it Failed	You return to the donation form, and GiveWP marks the donation Abandoned	You return to the ticket checkout page
Test mode follows	The plugin’s own Test mode setting	The add-on’s own Test Mode setting	GiveWP’s test mode setting	The Tickets Commerce test mode (sandbox) setting
Refunds	Contact Jovvie support for help with refunds	Contact Jovvie support for help with refunds	Make refunds in your Stripe Dashboard. Refunds are not made from inside GiveWP	Make refunds in your Stripe Dashboard

In test mode, no real card is charged. For more, see Use test mode.

Get started

WooCommerce

1. Install and connect Jovvie Checkout for WooCommerce
2. Set up a location and readers in WordPress
3. Take an in-person payment for an order

Gravity Forms

1. Install and connect Jovvie Checkout for Gravity Forms
2. Set up a location and readers in WordPress
3. Add Jovvie to a form
4. Take an in-person payment with a form

GiveWP

1. Install and connect Jovvie Checkout for GiveWP
2. Set up a location and readers in WordPress
3. Turn on Jovvie for your forms
4. Take an in-person donation

Event Tickets

1. Install and connect Jovvie Checkout for Event Tickets
2. Set up a location and readers in WordPress
3. Sell tickets at the door

Related pages

• Web terminals and app terminals
• Where to see your payouts
• Checkout payment page errors

Need help?

Contact Jovvie support.