PayPal Advanced
ProEvents Manager Pro - PayPalRequires Events Manager Pro. Compare plans
PayPal Advanced adds card fields to your booking form. The customer types their card details, submits the form and stays on your page. The fields are served by PayPal inside your form, so the card number goes from the customer's browser to PayPal and never reaches your site.
For PayPal's own buttons, see PayPal Checkout. The PayPal page compares the two.
- Events Manager Pro 3.2.7 or later and the Events Manager Pro - PayPal plugin, both activated. This page describes PayPal add-on 1.5.0.
- A PayPal Business account whose REST app has card fields enabled. PayPal decides this by account and country, so check with PayPal if you are unsure.
- Your site served over HTTPS and reachable from the internet.
Set up PayPal Advanced
PayPal Advanced uses the same PayPal app, credentials and webhook as PayPal Checkout. If PayPal Checkout already works on your site, skip to step 4.
-
In the PayPal Developer Dashboard, create a REST API app in Sandbox mode, and note its Client ID and Secret.
-
In WordPress, go to Events then Payment Gateways, click Paypal Advanced and open the [Test] API Keys/Notifications tab. Paste the values into Client ID and Client Secret and click Save Changes.
-
Check the notice at the top of the page. It confirms that the credentials were saved and the webhook was created or updated. The webhook and its events are the same as for PayPal Checkout, and you don't create anything in PayPal by hand.
-
Go back to Events then Payment Gateways and click Activate under Paypal Advanced.
-
Open a priced event on your site and choose the card payment method. You should see the card fields. Pay with a PayPal sandbox test card and check that the booking is Approved.
-
To go live, save a live app's credentials on the [Live] API Keys/Notifications tab, then click Enable Live Mode in the banner above the tabs.
Settings
On the General Options tab, Gateway Title is the name in the payment method menu and defaults to Credit Card. Booking Form Information, Success Message, Return URL, Thank You Message, Unpaid Bookings Expiry, Expired Booking Action and Manually approve completed transactions? work as described for PayPal Checkout. There is no quick pay button, because the customer has to fill in card fields first.
On the PayPal Options tab, Include Taxes In Itemized Prices set to Yes sends PayPal ticket prices with tax included, and No sends the tax total separately. The help text under the field describes these the other way round.
What the customer sees
Choosing this payment method shows four fields in the booking form: Name on Card, Card Number, Expires and CVV. Empty or invalid fields are flagged before the form is submitted.
When the form is submitted the booking is saved, the card is sent to PayPal and the payment is captured. If the card's bank requires Strong Customer Authentication, PayPal shows the 3D Secure challenge first. A payment whose authentication fails is not captured, and the customer is asked to try again or use another payment method.
This gateway can also be used when you add a booking for a customer from wp-admin.
Declined cards, unpaid bookings, refunds and disputes
These follow the same rules as PayPal Checkout:
- A declined card shows Your payment was declined. Please try another card or payment method. and the booking is deleted so the customer can try again.
- A payment PayPal holds as pending sets the booking to Pending until PayPal settles it. See Pending payments.
- A booking left unpaid is checked with PayPal when its Unpaid Bookings Expiry runs out, then approved if it was paid, or given the Expired Booking Action if not.
- Refunds are made in PayPal. A full refund cancels the booking and a partial one sets it to Pending. See Refunds.
- A dispute is recorded as a Disputed transaction. See Disputes.
Troubleshooting
The form shows "Payment method not enabled in PayPal App settings, please contact a site administrator about this."
PayPal reports that card fields are not available for your app. Check the features enabled on the app in the PayPal Developer Dashboard, for the sandbox app and the live app separately, and ask PayPal whether your account is eligible for card fields. Until then, use PayPal Checkout, which can offer a card button without this.
The card fields do not appear at all
Check that the gateway is Active, that the page is loaded over https://, and that credentials are saved for the mode the gateway is in.
"Could not verify the 3DS verification"
The customer's bank did not confirm the 3D Secure check. Nothing was charged. They can try again or use another card.