PayPal Express Checkout Payment Gateway

The PayPal Express Checkout Payment Gateway add-on allows you to accept trip and tour payments through PayPal Express Checkout. It provides a faster, secure, and seamless checkout experience for your customers while ensuring reliable payment processing for your travel bookings.

In this documentation, you will learn step-by-step about add-on installation, setup, and initial configuration options.

This integration helps travelers pay for trips in real-time while you enjoy a seamless and reliable transaction process.

Prerequisites #

Before you begin using PayPal Express with WP Travel Engine, make sure you have:

• Installed and activated the WP Travel Engine plugin.
• Purchased and installed the Paypal Express Checkout Payment Gateway Addon.

ℹ️ Please check the instructions here to install the addon and activate the License Key.

How to Enable the PayPal Express Checkout Payment Gateway #

1. Go to your WordPress Dashboard.
2. Navigate to WP Travel Engine > Settings > Payment > General.
3. Under the list of payment gateways, locate Paypal Express and check the box to Enable it.
4. Click Save Settings at the bottom of the page.

ℹ️ Note: You can enable PayPal Express alongside other payment options like Stripe or Bank Transfer if you want to offer multiple choices.

Configuring the PayPal Express Checkout Gateway #

To configure the main settings for th PayPal Express Checkout Payment Gateway, navigate to WP Travel Engine > Settings > Payments> PayPal Express.

• Client ID (required): Enter your PayPal Express Client ID.
• PayPal Secret  (required): Enter your PayPal Express Secret Key.

• Show Card Payment Option: Enable this option to display the Pay with Card button on the checkout page.
  When enabled, customers who choose PayPal Express Checkout as their payment method will also have the option to pay directly using a debit or credit card (where supported by PayPal).
  
  

• Click Save Settings.

Manual Payment Capture (If Automatic Capture Fails) #

In some rare cases, a payment made through PayPal Express Checkout may not be automatically captured by your website even though the traveler has completed the payment from their side.

When this happens, WP Travel Engine provides a Capture Manually option inside the booking dashboard so the admin can capture the payment manually.

When Does the “Capture Manually” Button Appear? #

The Capture Manually button appears when:

• A traveler successfully completes payment through PayPal Express Checkout, but
• The automatic payment capture does not complete successfully, and
• The payment status remains Pending in the booking.

This situation can sometimes occur due to temporary communication issues between your website and PayPal.

How to Use It #

1. Navigate to WP Travel Engine → Bookings.
2. Open the booking where the payment status is Pending.
3. Go to the Payment tab.
4. Click the Capture Manually button.
5. The system will attempt to capture the payment from PayPal and update the booking payment status accordingly.

When Should You Use It? #

Use the Capture Manually option when:

• The traveler confirms that the payment was completed.
• PayPal shows that the payment has been sent or authorized.
• The booking in WP Travel Engine still shows the payment as Pending.

After the capture is successful, the payment will be recorded in the booking and reflected in the Payment Summary.

TroubleShooting #

• PayPal Express Not Showing: Make sure the PayPal Express Checkout add-on is activated and enabled under WP Travel Engine > Settings > Payments > General.
• Invalid Client ID or Secret: Verify that you have copied the Client ID and PayPal Secret correctly from your PayPal Developer account. Ensure there are no extra spaces before or after the credentials, then save the settings again.
• Payment Stuck in Pending: Open the booking and click Capture Manually from the Payment tab after confirming the payment was completed in PayPal.
• Capture Manually Button Missing: This button only appears when automatic payment capture fails for an authorized PayPal payment.
• Pay with Card Option Not Showing: Enable Show Card Payment Option in the PayPal Express settings. Availability depends on PayPal and the customer’s region.

FAQS #