Skip to main content

Payment Page and Payment Links

ProSince 3.10Requires Events Manager Pro. Compare plans

The payment page lets someone pay a booking that is waiting for payment, from one checkout page, with any of your payment methods that support it. People get to it two ways: a Pay now button in My Bookings, or a payment link you send them yourself.

Payment links are a way to get paid for bookings you take over the phone, on WhatsApp, by text or by email. You add the booking in your dashboard, copy its link, and send it. The customer opens it on their phone or computer, checks what they booked and pays. The booking confirms itself once the payment is recorded.

Before you start

Turn on the payment page​

The payment page is off until you switch it on, so nothing changes on your site after updating.

Go to Events then Settings then Bookings then Payment Gateway Options, set Payment page to Yes and save your settings.

The Payment page setting is the last one in Payment Gateway Options.

Paying from My Bookings​

With the payment page on, every booking that is still awaiting payment gets a Pay now action in its Actions menu on the My Bookings page. It takes the place of the separate Resume Payment buttons that Stripe Checkout, Square Checkout and PayPal Standard used to add, so there is one way to pay whichever method the booking started with.

Pay now opens the checkout on top of My Bookings, so your customer never leaves the page. They can close it with the close button or the Escape key. After paying, View my bookings closes the checkout and refreshes the list, with the booking now confirmed.

The checkout​

The checkout shows the booking details on the left (contact details, booking form answers, attendees, the event and location) and a summary of what was booked on the right, with the total and any coupons, taxes or surcharges. Nothing on it can be edited, so the amount paid always matches the booking.

Under Payment your customer picks one of your payment methods and presses Pay, which shows the amount due. Card methods like Stripe Elements, PayPal Advanced and Square Web Payments take the card right on the page, and PayPal Checkout opens PayPal's own window. Hosted methods like Stripe Checkout, Square Checkout and PayPal Standard send them to the provider to pay, then bring them back to the checkout to see the result.

If the booking was made to pay offline, Pay later is listed with the other payment methods. Choosing it shows your offline instructions (the Offline gateway's Booking Form Information text) and hides the Pay button, so the customer can still pay that way instead and the booking stays as it is. See Pay later on the payment page.

On a phone the page is one column, and the booking summary folds into a bar at the top that shows the amount due. Tapping it opens the full summary.

Once the payment is recorded, the checkout says so and the booking is confirmed. If the payment provider is still confirming a payment, the checkout says it is processing and updates when the payment goes through.

Every booking awaiting payment has its own payment link. Anyone with the link can open the checkout without logging in, which makes it a good fit for bookings you take yourself.

Add the booking​

Go to Events then Bookings, open the event's bookings and click Add Booking. Choose the tickets and enter your customer's details, or pick an existing user from the list at the top.

Under Payment and Confirmation, leave Amount Paid empty and leave Fully Paid and Confirm Booking? unticked, so the booking is saved as awaiting payment. Then click Submit Booking.

You don't have to add bookings this way to use payment links. Any booking awaiting payment has one, including bookings made on your site to pay at the door or by bank transfer, and bookings whose online payment was never finished.

Open the booking from Events then Bookings. Below the booking details there is a Payment link box. Click Copy link.

Send it​

Paste the link into a WhatsApp message, a text, an email or whatever you use to talk to your customer. When they open it they see the checkout for that booking and can pay with any of your payment methods. You'll see the payment on the booking as usual, and the booking is confirmed once it is paid in full, unless you set that payment method to approve bookings manually.

Send the link only to the person paying

Anyone with the link can see the booking's details and pay for it. If a link reaches the wrong person, click Reset link in the Payment link box. Links sent before then stop working, and the box shows a new link you can send instead.

Payment links stay valid while the booking can be paid. Once a booking is paid, cancelled or rejected, its link shows the booking's status instead of a payment form, and no longer shows the customer's details.

Use the #_BOOKINGPAYURL placeholder to put a booking's payment link in your booking emails, for example in the email sent while a booking is awaiting payment:

<a href="#_BOOKINGPAYURL">Pay for your booking online</a>

The placeholder is empty when the payment page is switched off or the booking can't be paid online, so it is safe to leave in your templates.

When a payment is declined or abandoned​

A booking is never deleted or cancelled because a payment from the payment page was declined, abandoned or ran out of time. It goes back to how it was before, for example awaiting payment at the door, so your customer can try again.

If a card is declined, the checkout shows the error above the payment methods and your customer can try again or choose another method straight away.

If someone cancels on a hosted checkout, they come back to your checkout with the booking as it was. If they leave without paying, the booking waits for the payment method's normal expiry time in case the payment still comes through, then goes back to how it was. The expiry is counted from when they pressed Pay, not from when the booking was made.

Bookings that can't be paid online​

  • Deposit Paid bookings can pay their balance here, with any of your payment methods that takes part payments. See Partial Payments (Deposits).
  • Other partly paid bookings, such as a booking awaiting payment that already has some money recorded against it, show what has been paid and the amount still due, with a note that the remaining balance can't be paid online. Your offline instructions show too, if the booking was made to pay offline.
  • Cancelled, rejected and paid bookings show their status instead of a payment form.
  • Multiple Bookings carts are paid as a whole, through the cart's main booking. The payment link of a cart is only shown to people who can manage the whole cart.
  • If the event was cancelled, or there are no longer enough spaces for a booking that doesn't hold its spaces, the checkout explains why when your customer tries to pay.

If you switch the payment page off, links you already sent stop opening the checkout.

For developers​

  • Bookings in the REST API and MCP include a pay_url field for people who can manage the booking, while the payment page is on and the booking can be paid.
  • The checkout templates are in templates/checkout/ in Events Manager Pro. Copy any of them to wp-content/themes/your-theme/plugins/events-manager-pro/checkout/ to override them. The checkout loads without your theme's stylesheets so a theme can't break it; return false from the em_checkout_page_dequeue_theme_styles filter to keep them.
  • Filters include em_payment_page_enabled, em_payment_page_url, em_payment_page_gateways, em_payment_page_is_payable, em_payment_page_can_access and em_payment_page_state.
  • A gateway offers itself on the payment page by setting public static $supports_payment_page = true. It should also implement close_abandoned_payment(), which answers whether nothing can still be paid with it for a booking. Without it, a declined or abandoned payment can't be put back straight away and waits for the expiry instead. payment_page_prepare() and payment_page_feedback() let a gateway read what the checkout posts and return its usual booking form response, and the em_gateway_return_url and em_gateway_cancel_url filters bring payers back to the checkout from a hosted page.