Upgrading from Cab Grid Stripe Integration version 2?

Due to significant changes in the the checkout process offered by Stripe, the upgrade to version 3.0 of the Cab Grid Stripe Integration plugin for WordPress is a manual process. Read on for more details…

Cab Grid Stripe Integration Add-on plugin version 2+ users can begin the update from within the Cab Grid Stripe tab in their WordPress Admin.

Version 1.x users will need to purchase a new license and install the new version manually.

Below is a guide to setting up version 3 of the Cab Grid Stripe Integration add-on plugin. However, we recommend you also look at our overview of using Stripe with Cab Grid Pro. Configuration instructions for version 2 are also available.

Assuming it has been installed, the Cab Grid Stripe Add-on WordPress admin interface provides the following options. These are accessible by choosing the STRIPE tab on the main Cab Grid Pro Admin page, or choosing the Stripe item in the Cab Grid Pro sub-menu in the WordPress Admin.

Note: The options available in the Cab Grid Pro Stripe Add-on admin tab will vary depending on payment type selected.

Previous versions of the Cab Grid Stripe Add-on (<=2.3) utilised a pop-up checkout interface. Stripe have discontinued this interface in order to support Strong Customer Authentication (SCA). The new Stripe Checkout functionality replaces this feature with a checkout experience hosted directly by Stripe.

Stripe Account

A free Stripe account is required to use this add-on.

Payment Type Accepted

After a booking request is submitting, the Cab Grid Stripe Add-on will offer customers the payment methods selected here. Money will be received by your Stripe account ready to pay out to your bank account.

Stripe offers many payment options in addition to basic credit card processing. These include iDEAL (Netherlands), GiroPay (Germany) and SoFort (Austria, Belgium, Germany, Italy, Netherlands, Spain).

Stripe Checkout

Stripe Checkout directs customers to a checkout page hosted by Stripe and accepts payment via a credit or debit card. Other methods are also supported (e.g. Apple Pay and Google Pay) and can be configured via your Stripe account. It is also possible to customise the look and feel of Checkout via the Stripe Dashboard. For more info, see Stripe Docs.

When Stripe Checkout is selected, no other (on site) payment methods are available.
Stripe Pop-up to Stripe Checkout

Other Payment Methods

Currently, the following payment methods are available. Customers are guided through the checkout process depending on a choice based on the payment methods selected.

  • Credit/Debit Cards
    The required input fields (card number, expiry, CVC, etc) are presented within the Cab Grid interface.
    If required, the customer will be prompted to complete Strong Customer Authentication checks (e.g. 3D-Secure 2).
    Your website should be served over a secure https connection.
    If the transaction is successful, the ‘Success Message‘ is presented to the customer.
  • iDEAL
    The customer will be guided through the process of making an iDEAL payment.
    When complete, the customer is sent to the ‘Redirect URL‘ page as specified.
  • SoFort
    For SoFort payments, the customer must select the country where their bank account is held.
    Customers are guided through the process of making a payment via SoFort.
    When complete, the customer is sent to the ‘Redirect URL‘ page as specified.
  • GiroPay
    The customer will be guided through the process of making a GiroPay payment.
    When complete, the customer is sent to the ‘Redirect URL‘ page as specified.

Notes:
– Additional payment methods (iDeal, SoFort, GiroPay) must also be activated in your Stripe Account Dashboard.
– Available settings will vary depending on the payment types accepted.
– Beyond standard card processing, most require a secure connection (HTTPS).
– iDEAL, GiroPay & SoFort only process payments in EURO. Currency will be automatically set.
– The Webhook URL must be to the Stripe account if further processing is required (e.g. via the Booking Management Add-on). See below and our GiroPay, iDEAL, SoFort article.

Currency

Choose the currency for Stripe transactions by selecting from the drop-down. This lists all currencies supported by Stripe.

– This is independent of the currency symbol, which is set in the main Cab Grid Pro OPTIONS tab.
– Some payment types only accept certain currencies, so currency may be automatically changed.

Surcharge/Deposit (charge amount variation)

Use a formula to adjust the price to apply a surcharge or deposit discount. Enter a formula in this box and it will be applied to the calculated price.

It is advisable to describe any price modifications in the ‘Booking Sent Message‘ field under the OPTIONS tab on the Cab Grid Pro admin page in WordPress.

Surcharge

If an additional fee should be charged for online Stripe transactions, this can be entered here.
Example 1: To add a fixed amount of $3.50, enter +3
Example 2: To add a 3 percent surcharge, enter *1.03

Deposit

If a deposit (or part) payment is preferred instead of full payment, a formula can be defined to calculate the fee paid.
Example 1: To take a 15% deposit, enter *0.15
Example 2: To insure the deposit is not too low add a fixed amount enter *0.15+3 to charge 15% of full price and add $3.00.
Example 3: To charge a flat rate deposit enter *0+5 (to charge $5 for all bookings regardless of amount).

Currently, the Booking Management Add-on will mark any booking that receives a payment (full or part) as paid. Users should verify the amount paid manually via the Stripe.com dashboard or Stripe’s payment notification email.

Mode

Stripe can operate in either LIVE or TEST mode.

Test Mode

In TEST mode, only test card numbers are valid (e.g. 4242 4242 4242 4242). Any expiry date and CVC number (3 digits) can be used. Test mode simulates the functions of a real transaction without actually processing it.

For other payment types (GiroPay, SoFort & iDEAL), Stripe will simulate the payment process for testing.

Note: In test mode, the he Stripe payment interface is only visible for logged in WordPress administrators. For all other visitors, Stripe is not available while in test mode.

Live Mode

In LIVE mode, only real valid card numbers and payments (bank transactions) are accepted and processed.

Stripe provides API keys for both LIVE and TEST modes. They are separate and distinct. Depending on what mode you have set, the Cab Grid Stripe admin interface will present fields for the appropriate API keys.

Publishable Key (LIVE/TEST)

The publishable key is required for Stripe to function. Stripe requires API keys for both LIVE and TEST modes. These are a separate and distinct strings of characters.

Publishable API keys usually begin pk_test_ or pk_live_ and can be obtained from the Stripe dashboard after logging in.

To obtain either LIVE & TEST API keys you must click the switch labelled, “View Test Data” under the API menu on the left side of your Stripe Dashboard

Secret Key (LIVE/TEST)

The secret key is also required for Stripe to function properly on your site. Stripe requires API keys for both LIVE and TEST modes. These are separate and a distinct strings of characters.

Publishable API keys usually begin sk_test_ or sk_live_ and can be obtained from the Stripe dashboard after logging in.

To obtain either LIVE & TEST API keys you must click the switch labelled, “View Test Data” under the API menu on the left side of your Stripe Dashboard. See illustration above.

Loading

Stripe advise loading their components on every page to improve fraud prevention. However, the Cab Grid Stripe Integration Add-on can be set to defer loading Stripe until it is required (after the custom submits a booking request and is ready to checkout).

This may offer some [perception of] loading time (speed) improvements, but may not be as reliable.

This setting is labelled, “Load Stripe” under the STRIPE tab in Cab Grid Pro. It has the following options:

  • with page load – default setting, loads Stripe with every page so it is ready to use at any time.
  • after booking request submitted – dynamically loads Stripe components when the customer submits a booking request.

(Note: this feature also requires Cab Grid Pro v5.2.2 or higher.)

Icon/Checkout Image

(Icon applies when ‘Stripe Checkout‘ is the only payment method selected.)

This is an image that is displayed at the top of the Stripe checkout interface. However, if there is a vehicle image associated with the journey, this is used instead.

In the Stripe Cab Grid admin tab, clicking the text box opens the media browser where you can either upload or select an image to be used.

Checkout Title

(Title applies when ‘Stripe Checkout‘ is the only payment method selected.)

This is text that is shown at the top of the Stripe checkout box. It would usually be your company name.

Label

This is the text shown on the checkout buttons. There are two instances: Firstly, if only Stripe checkout payment type is selected, the button that opens the checkout box and, secondly, the button that submits the payment details. The same text (as entered here) is used to label both buttons.

Success Message

(Success Message applies when ‘Credit/Debit Cards‘ payment method is selected.)

This is the message shown to visitors if the Stripe card transaction is successfully processed. It would potentially provide information or instructions concerning the booking.

The success message box now accepts text substitutions allow data from the booking to be inserted in to the message.

Redirect URL

(Redirect URL applies when Stripe Checkout or additional payment mechanisms are selected. e.g. GiroPay, iDEAL and/or SoFort.)

This is the web address of the page customers see when the transaction is completed. It will usually be a dedicated WordPress page which needs to be created independently. It would normally provide details of the next steps in the process (booking confirmation etc.).

This page is shown regardless of the outcome of the transaction (if it either fails or succeeds), and therefore should contain generic information. More significant and detailed messages are sent by the webhook functionality – especially if the Booking Management Add-on is installed.

Webhook URL

(Webhook URL is displayed when Stripe Checkout or additional payment options are selected. e.g. GiroPay, iDEAL and/or SoFort.)

This is a READ-ONLY field. It cannot be edited. It provides the web address (URL) of the page that processes payments in the background. For example, if the Cab Grid Booking Management Add-on is installed, it will set the booking to paid.

The URL provided here should be entered in the Stripe admin panel (when logged in). Detailed instructions can be found here.

Invoicing

If the Booking Management Add-on is installed, an email message can be sent directly to the customer automatically when a payment is successfully completed. This can be formatted like an invoice or receipt. It is configured in the PAID message field under the SETTINGS tab.

Stripe is also capable of generating and sending invoices directly to customers. See https://stripe.com/docs/billing/invoices#invoices for more info on how to send an invoice through Stripe.

Tags: , , , , , , , , , ,

x
  •  
  • Discount/Promo Code
  • Extras

    Select additional items to add to your booking

    • Water

      Water

      Chilled mineral water

      -+

      $1.49


No price found for this journey