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
| Setting | What it does |
|---|---|
| Gateway Title | The name in the payment method menu. Default Pay with Square. |
| Booking Form Information | Text shown under the menu when this gateway is chosen. |
| QuickPay Payment Button | Button text when Quick Pay Buttons are on, or the full URL of an image. Default Pay with Square. |
| Success Message | Shown after the form is submitted, while the customer is sent to Square. |
| Return URL | Where Square sends the customer after paying. Leave it empty to use the Events Manager thank you page. |
| Thank You Message | Shown on that thank you page. |
| Unpaid Bookings Expiry, Expired Booking Action | How 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 Message | Shown 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
| Setting | What it does |
|---|---|
| Include Taxes In Itemized Prices | No (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.