Overview

This document will provide details on how to configure the WooCommerce plugin to work with dev.shift4, as well as the features and functionality that is available for you to use. By leveraging this plugin, you will be able to accept payments safely and securely.

Prerequisities

• A Shift4 Account

  • First you need to sign up for a developer account here https://dev.shift4.com/. 

  • Then you will be able to apply for a live account within the dashboard: https://dev.shift4.com/application 

Features

• Credit Card Payments

• Saved Cards

• Apple Pay

• 3D Secure

• Full & Partial Refunds

• Automatic settlement or authorise only transactions

• WooCommerce Classic Checkout

• WooCommerce Block-based Checkout - COMING SOON

• Order via admin

Technical Notes

Plugin uses the v3.0.0 release of the Shift4 php library.

• Developer documentation can be found in the git repository (This file is not in the release version or on the marketplace) at /README.md and contains a technical overview of the plugin and its architecture for developers wishing to contribute improvements or bug fixes to the code.
  
  
  
  Please visit our Github in order for Release Notes

Configuration

WooCommerce > Settings > Payments

The configuration for each payment method is handled separately so you will see one section for Shift4 Card and and another for Shift4 Apple Pay.  

Shift4 Shared Configuration

This configuration is shared across both Card and Apple Pay sections, therefore it only needs to be updated and configured in one area and the settings will be shared. 

• Public Key - Your Shift4 account Public Key. This can be located in your Shift4 account under Account Settings > API Keys

• Secret Key - Your Shift4 account Secret Key. This can be located in your Shift4 account under Account Settings > API Keys

• Capture Strategy - To set the capture of the payment to be immediate or set it to authorise only to be captured manually later.  

• Debug Logging  - With debug logging enabled all data about charge requests will be recorded to Shift4_Payments so that unexpected behaviour can be identified. When debug is disabled decline responses will still be recorded.

Shift4 Card Payment

• Enable / Disable - To enable or disable card payments via Shift4.

• Title - Title of the payment method that will show in the checkout to the customer. 

• 3DS Mode - To enable or disable 3DS2 verification on card payments. 

  • Disabled - 3DS is completely disabled

  • Frictionless - 3DS will only be used if card 

  • Strict - Only cards that support 3DS will be permitted

• Card Vaulting - To enable the ability for logged in customers to save their card details to use on future transactions.

Shift4 Apple Pay

• Enable / Disable - To enable or disable Apple Pay payments via Shift4.

• Title - Title of the payment method that will show in the checkout to the customer.  

Supported Payment Methods

Card

• Need to ensure card types are enabled in your Shift4 Account

• Card Types that Shift4 supports: 

  • Visa

  • Mastercard

  • Discover

  • American Express

  • Diners Club

  • JCB

Saved Card

• Only customers with an account will be able to store their card for future use. 

Apple Pay

• Need to enable Apple Pay in your Shift4 Account - do to this please email: [email protected]

• You will then need to add the domain of your website in your Shift4 account under Account Settings > Integrations > Add Domain

• This will require a verification file to be uploaded to /.well-known/apple-developer-merchantid-domain-association. The verification file can be downloaded from the Shift4 account. 

Testing

For testing your integration you first need a Shift4 development account which you can setup here: https://dev.shift4.com/ 

1. In your test WooCommerce  store, install the Shift4 for WooCommerce plugin.

2. Using your Shift4 Developer API keys , head to Settings and add in your Test API keys and enable the relevant payment methods

3. You can now test Shift4 transaction in your WooCommerce test store