Skip to main content

Square Checkout

ProEvents Manager Pro - SquareRequires Events Manager Pro. Compare plans

Square Checkout sends the customer to a payment page hosted by Square after they submit your booking form. Square lists what they are buying, takes the payment and returns them to your site.

Credentials, test mode, payment notifications, refunds and disputes are shared with Square Web Payments and are covered in Set up Square. Follow that page first, then come back here for what is specific to this gateway.

Settings​

Go to Events then Payment Gateways and click Square Checkout.

General Options​

SettingWhat it does
Gateway TitleThe name in the payment method menu. Default Pay with Square.
Booking Form InformationText shown under the menu when this gateway is chosen.
QuickPay Payment ButtonButton text when Quick Pay Buttons are on, or the full URL of an image. Default Pay with Square.
Success MessageShown after the form is submitted, while the customer is sent to Square.
Return URLWhere Square sends the customer after paying. Leave it empty to use the Events Manager thank you page.
Thank You MessageShown on that thank you page.
Unpaid Bookings Expiry, Expired Booking ActionHow long a booking waits for payment and what happens to it then.
Manually approve completed transactions?Leaves paid bookings at Pending for you to approve. Bookings must also need approval in your booking settings.
Cancel URL, Payment Cancelled MessageShown in the settings, but Square's payment page has no cancel link back to your site, so customers don't normally arrive here. See Abandoned payments.

Gateway Options​

SettingWhat it does
Include Taxes In Itemized PricesNo (the default) sends ticket prices without tax, and Square adds the tax as a separate charge named Taxes with the rate. Yes sends ticket prices that already include tax.
Ask For Shipping Address?Yes makes Square's page collect a shipping address from the customer. Default No.

What the customer sees​

Square's page lists one line per ticket type with its quantity and unit price. Surcharges are extra lines, all discounts are added together as one discount on the order, and tax follows the setting above. The customer's email address is filled in for them. A deposit or balance payment is one line for the amount due. Square decides which payment methods to offer on its page.

The booking is approved when Square notifies your site that the payment completed. If the customer gets back to your site first, Events Manager asks Square directly, so they still see the booking confirmed.

Square Checkout works as a Quick Pay button, in Multiple Bookings Mode, on the payment page, for deposits and balances, and for bookings you add in wp-admin.

Abandoned and declined payments​

  • A card is declined on Square's page. The payment link stays open, so the customer can try another card there.
  • The customer leaves Square's page without paying. Your site isn't told. The booking stays at Awaiting Online Payment until its Unpaid Bookings Expiry runs out. Then the payment link is deleted at Square and the Expired Booking Action is applied. Set an expiry so these bookings are cleared.
  • The customer comes back later. My Bookings shows a Resume Payment button on the unpaid booking, which reopens the same payment link or makes a new one. With the payment page on, it is Pay now instead.

If the payment link can't be created at all, the customer sees An unknown error has occurred creating the Square payment link, please contact us for further assistance. and the booking is discarded. Check your credentials for the mode the gateway is in.