Shopify Set Up Guide

Introduction

Synchrony provides the following two applications for use in your Shopify site:

  • Synchrony Marketing and Messaging app
  • Synchrony Payment app

 

The Synchrony Marketing and Messaging app is a plain widget used to display the Synchrony Financing related advertisements and promotional financing offers on all product pages. For example, display the advertisement on a particular laptop page that says Synchrony can provide 6 months promo option for your purchase. This application displays the available promotional offerings based on the price ranges and terms selected by the merchant. It also displays the lowest available price per month for each item.

 

When the consumer clicks through to learn more, the details of available offers will be presented. Depending upon the merchant's available offerings, consumers will be presented with one or more offers, the details of those offers, and the opportunity to prequalify for the offer in a Synchrony modal. After completing the prequalification flow, if qualified, the consumer will be presented with their offer(s) and can complete their application and move on to making a purchase or can close the modal and return to the original product page.

 

The Synchrony Payment application provides an option to use Synchrony Financing at checkout. For consumers, who applied and were approved at the Product Page, can select Pay with Synchrony at checkout and complete their purchase. Consumers can also complete the Prequalification flow at checkout and complete their purchase.

 

Consumers with an existing Synchrony Credit Card on the merchant's program, can select Pay with Synchrony, complete an account number lookup process, and use their account. Merchants will use their Shopify console to process the payment as part of their normal order flow. Shipping the product will capture the order payment details, and initiate funding for the order. Funding is completed within two business days once order is shipped.

About this document

This document provides the steps to integrate the Synchrony Shopify applications into an enrolled merchant's Shopify eCommerce site.

Intended audience

This document is intended for the merchant and/or merchant development team to install the Synchrony Marketing and Payment Gateway applications, and to successfully use the applications for consumers to apply for and pay with Synchrony at checkout.

Terms and definitions

  • 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.
  • PDP: Product Display Page
  • Widget: An element of a graphical user interface that displays information or provides a specific way for a user to interact with the operating system (OS) or an application.
  • 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.

Technical Support

For technical support related to the Synchrony Messaging or Payment Gateway applications, send an email to eCommerce@syf.com.

Integrating Synchrony Marketing Messaging App

The high-level steps to integrate the Synchrony Marketing Messaging App are as shown.

  1. Log into your Shopify Admin Console.
  2. Click Settings.
    Shopify settings example
  3. Click Apps and sales channels.
    Click Apps and sales channels
  4. Click Shopify App Store or go to https://apps.shopify.com/synchrony-marketing.
    Shopify app store
  5. Click Add app.
    Shopify add app
    The Install page is displayed.
  6. Click Install app.
    Shopify install app
    The configuration page is displayed.
  7. In Account Settings section > API credentials, specify the following for Production and Sandbox:
    Shopify API account settings
    • Unifi SYF Partner ID: Enter the partner ID provided by the Synchrony Integration team.
    • Unifi Widget Config:
      • All - Display Unifi Widget on both PDP (Product Display Page) and Cart page.
      • PDP - Display Unifi Widget only on the Product Display Page.
      • CART- Display Unifi Widget only on Checkout or Cart page.
    • Unifi Widget Cart: Enter element ID or class name to display the widget next to element on Checkout/Cart page.
    • Unifi Widget in PDP: Enter element ID or class name to display the widget next to element on Product Display Page.
  8. Customize your Online Store > Themes section to enable the Synchrony Marketing Messaging App embed:
    Shopify customize store

Product Price Variance Setting

Following fields are used to set the price variance.

  • Price Observer Section in Cart: Enter Parent element ID or class name of the price block section on Checkout/Cart page.
  • Price Target Section in Cart: Enter the unique element ID or class name to display the price on Checkout/Cart page.
  • Price Observer Section in PDP: Enter Parent element ID or class name of the price block section on Product Display Page.
  • Price Target Section in PDP: Enter the unique element ID or class name to display the price on Product Display Page.
    Unique ID code example
Notes:
  • The last three parameters are the style sheet IDs, or the actual IDs grabbed from the merchant website.
  • Partner ID is same for Production and Sandbox. However, internally the URLs are different.

9. Click Save. The configuration settings are saved.

Integrating Synchrony Payment Gateway App

To integrate the payment app:

  1. Log into your Shopify Admin console.
  2. Go to https://apps.shopify.com/syf.
  3. Click Add app.
    Shopify app store example
  4. Click Install app.
    Shopify app install page
    The configuration page is displayed.
  5. In Account Settings section > API credentials, specify the following for Production and Sandbox:
    • Unifi SYF Partner ID: Enter the partner ID provided by the Synchrony Integration team.
    • Gateway Settings:
      • Address Passed to Gateway: Select Billing Address.
      • Capture Payment Only When Order is Fulfilled: Select No.
      • Custom Checkout Page: Select Yes.
      Partner ID is same for Production and Sandbox. However, internally the URLs are different.
      Shopify Unifi Partner ID example
  6. Click Save. The configuration settings are saved.
  7. Go to the Shopify Admin Dashboard > Payments section.
    Shopify admin payments section
  8. Click Add payment methods.
    Shopify add payment methods
  9. Search for the payment method called Synchrony.
    Shopify search payment methods
  10. Click Activate for Synchrony Financing.
    Shopify activate payment methods
    The following message is displayed: “You are connected to Synchrony Financing as <Partner ID> . Activate your account to start accepting payments.”

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 1-800-333-1082 or email us at eCommerce@syf.com

Troubleshooting

This section provides the resolution for the following issues:

  • Product Price Variance Issue
  • UniFi Widget Alignment Issue

UniFi Widget Alignment Issue

  1. Login to the Shopify Admin console.
  2. Click Online store > Themes, and then click Customize.
    Online store customize preview
  3. Search for default product page.
    Default product example
  4. Click Add Block and search for Synchrony. Select the block to add. Widget block can be moved as fit to the page.
    Add product block example