Synchrony Payment App Integration Guide for WooCommerce Merchants

Introduction

WooCommerce is an open-source e-commerce plugin for WordPress that is used to create online e-commerce shops.

About This Document

This document provides the steps to integrate the Synchrony payment plugin  into the installed WooCommerce site in WordPress.

Intended Audience

This document is intended for the merchant and/or merchant development team to integrate the Synchrony payment extension to their application, and to use the applications for consumers to apply for and pay with Synchrony at checkout.

Terms and Definitions

Term	Definition
Merchant	Merchant enrolled with Synchrony to provide financing and payment options.
Merchant ID	A unique 16-digit identification number assigned to a merchant.
Partner ID	A unique 10 alphanumeric code assigned to the partner.
Authorization	The purchase was approved by Synchrony, and the merchant can prepare the merchandise for shipping.
Captured	After the order is placed and approved by Synchrony Financing and when the order is shipped, the order is captured, and this begins the funding process, so the merchant gets paid.
Activation Key	Unique one time use code Synchrony emails to selected merchants to facilitate activation of the extension.  Not all merchants will use the Activation Key process.

Technical Support

For technical support related to the Synchrony payment app, send an email to [e-mail].

High-Level Steps to Integrate Synchrony Payment plugin

The high-level steps to install and configure the Synchrony payment plugin  to WooCommerce site is as shown.

Prerequisites

Before installing and configuring the Synchrony payment plugin to your WooCommerce site, make sure the following prerequisites are met:

• Merchant is enrolled in an Synchrony eCommerce program and has been provided an Activation Key or Partner ID.  If you have not been provided an Activation Key or Partner ID, please contact Synchrony at [e-mail]  
• WooCommerce extension is installed in WordPress. For details, see Installing and Uninstalling WooCommerce.

Installing and Integrating Synchrony Payments plugin

To install the Synchrony payment app and integrate it into WooCommerce site:

Log into your WooCommerce Admin Console.

On the left panel, click Plugins.

Click Add New Plugin.

The Add Plugins page is displayed.

Enter Synchrony in Search Plugin text box.

Synchrony Payments plugin will show.

Click on Install Now.

Click on Activate button.

Click on Settings under Synchrony Payments.

Click on Finish set up button.

Synchrony setting page is displayed.

Select Production tab.  The business principal will have received an Activation Key via email from Synchrony after enrolling.  If a new Activation Key is required, please email [e-mail] Activation Keys are one time use only and expire after 14 days.

Some merchants will use a Partner ID.  This will be provided during a go live call.  Partner ID is not your MID.

Note: Sandbox testing is currently not available. Please contact Synchrony for more details.

In the API Access Activation section, provide the Activation Key  for your Synchrony account to allow it to authenticate with the Synchrony APIs based on merchant enrollment.

• Select Use Activation Key.
• Activation Key: Enter activation key
• Domain List: Enter domain

• Add Another Domain: If you have multiple domains, click on Add Another Domain link and enter other domain

  

Click on Activate to save details.

Success message is displayed.

 

Configuring Synchrony Payment App

In the General section:

• Which pages would like to advertise on?: Set it to All (recommended) to enable the advertising widget on all pages.
• Click on Continue To Next Step button.

• General setting will save and Page Options will open.

• Product Display Page (PDP) Advertising Placement: Set default to WooCommerce single product summery page.
• Parent Element ID or Class (Price Block Section): Leave it blank. Add a custom CSS selector if you want the widget to update the price.
• Unique Element ID or Class (Price): Leave it blank. Add a custom CSS selector if you want the widget to update the price.
• Product Listing Page: Select Lowest Price as recommended. Choose how the price is shown on listing pages for variable products.
• Widget Display in collection page(PLP): Select Browser Rule Execution (recommended) from the dropdown. This allows you to choose the synchrony widget promotion rules to run.
• PLP Multi Product Element: This field will auto populate. Change this class for customized product listing page to show widgets..

• Digital Buy Available in Cart: By default, it is set to NO (recommended). You can change it to Yes if you want to show “Pay with Synchrony” button in Cart page.

  

• Cart Button Image URL: It is set to Synchrony button image. Do not change the image URL.
• Cart Button Image Alt Text:  It is set to Pay With Synchrony.  Do not change the Image alt text.
• Module Version: Current version will display.

• API Request Timeout: Leave it to default value. Do not modify this values unless advised by the Synchrony team.

• Click on Continue To Next Step Button to save the settings. Payment Processing section will open.

Enable Synchrony Payment Method: Set it to Yes to enable the payment method.

• Title: Name for the payment method. By default, it is Synchrony Financing – Pay Over Time  Do not change the payment method name. This will be displayed in the payment method section during checkout.
• Logo: Leave it blank. This allows you to display an image for Checkout button.

• Order Fulfilment: Select one of the following:
• Authorize Only: Allows authorization only. It will not capture the payment at the time of the order. Instead, payment must be manually captured in the form of an invoice.  Synchrony recommends that Authorize Only be used.
• Authorize & Capture: Allows authorization and settlement in the same transaction. It will capture the funds immediately at the time of the order.  Synchrony recommends that Authorize & Capture is only used by merchants that ship the same day or the next day after order capture.
• Address Used for Payment Processing: Set it to Billing Address (recommended) If the merchant selects Shipping Address, customers will be able to choose any shipping address.  The merchant will assume liability for delivery address disputes.
• Allow Ship to Store: Set it to NO. Please call Synchrony before enabling this option.

• Debug Mode: Set it to NO. Setting it to Yes, enables you to debugging issues.
• Send Error Logs to Synchrony Server: Set it to Yes. This setting sends error logs to Synchrony server for continuous monitoring and support.
• Checkout Modal Presentation: Set it to Redirect. Redirect: The Payment screen opens as a new Page. Overlay: The Payment screen appears as a modal Overlay on the Magento checkout Page.

• Enable MPP Banner: By default, it is set to NO. You can change it to Yes if you want to show Synchrony Advertising Banner. Follow the instruction under Advertising setting section.

• Enable Custom Order (Non-Block): By default set to NO. Select Yes if you want to enable custom order feature on non-block checkout page.
• Cache Time Out: Set it to default 30. Please contact Synchrony before change the value.
• Custom CSS: This will allow to overwrite the style with respect to Synchrony elements.

Click on Publish button. The configuration settings are saved.

Advertising Banner Settings 

Synchrony eCommerce Solutions offers a wide range of financing solutions giving you more choice and helping enable growth for your business. Promote Synchrony financing on your website. Advertise that you offer financing through ready-to use, downloadable assets. Once connected to your eCommerce platform, these banners and bricks can be used on your site, in social media and in email to encourage customers to learn more about financing and to apply.

• Banners with a “Learn More” call to action must link to the Multiproduct Presentment(MPP). 

• Banners with no “Learn More” call to action are not required to link to MPP.

• Recommended Placements:
• Homepage
• Category Pages
• Informational + FAQ Pages

Go to Partner Centre to download assets. 

Click on Marketing Assets to download compliant assets.

Extract the zip to local drive. You’ll find clickable and Non-clickable images for desktop, tablet and mobile mode.

Clickable images will not become clickable until connected to your MPP. 

Adding Banner as Block

Go to pages, select the page where you want to show Synchrony advertising banner.

Example: Select checkout page.

Click on + button. Select Image.

Click on Media Library if you have already uploaded an image from Synchrony provided marketing assets or click on Upload button.

Select the image which you want to show as banner.

Click on Settings to open the right panel if settings plane is not visible.

Click on Advanced, Enter “MPPAnywhereClass” in ADDITIONAL CSS CLASSES box.

Click on Save button.

Page updated message will display. Click on View Page.

Newly added MPP Banner will display on checkout page. Click on the banner, MPP model window will open. Enter the amount to learn more about available financing options.

 

Shortcode

A shortcode is a small piece of code, enclosed in square brackets, that allows you to easily add specific functionality or content to your online store. These shortcodes are used in WordPress pages, posts, and widgets to dynamically display products, product categories, cart information, checkout forms, and more, without needing to write custom code.

Synchrony provides following shortcodes to enable specific functions.

Product Page: [synchrony_product_widget]- To show Synchrony widget on product page.

Cart Page: [synchrony_cart_widget]- To show the widget on Cart page.

Synchrony Checkout button: [synchrony_button]- To show the button “Pay with Synchrony” on checkout page

.

Checkout Page: [synchrony_checkout_widget]- To show Synchrony widget on checkout page.

Promotions

Promotions are financing offers, such as 6 months deferred interest. Each promotion has a cost, which is expressed as the Merchant Discount Rate. This Merchant Discount Rate is subtracted from the funded amount of the purchase, and this amount represents the cost of financing provided by Synchrony. Merchants cannot pass on the cost of financing to consumers. Available promotions are determined by Synchrony.

The Merchant Discount Rate is determined by the Product Solution selected during enrolment.  If you would like to discuss other Product Solution sets, please contact Synchrony at 800-333-1082 or email us at [e-mail].

Troubleshooting

There are several reasons that plugins fail to install properly.  Sometimes third-party extensions associated with shipping, tax and one step checkout can cause issues with sub-total and grand total calculations. Certain themes and front-end customizations can cause display issues as well. It is recommended that you email Synchrony at [e-mail] and request a technical call with the installation team and configuration experts. Please include your WordPress version and a recent set of logs with your request.