Skip to content
Corso App Documentation

Overview

Corso supports headless stores that use the Shopify Storefront API for cart and checkout management. Site developers can implement Checkout Plus on a site by placing a single <script /> tag. You may also want to add specific one-line <div /> tags in your theme where you want the Corso Checkout Plus elements to appear.

Checkout Plus will:

  • Manage getting customer buyer consent
  • Retrieve the protection pricing from the Corso API
  • Add the appropriate Corso protection product variant to the cart
Implementation
Testing & Troubleshooting

App Installation

Section titled “App Installation”

This guide assumes that you have installed the Corso App from the Shopify app store.
If you have not completed this step, you can install the app here:
Corso App on Shopify

You must also have accepted the required app subscription, which can be done from inside the app in your Shopify Admin.

Implementation Steps

Section titled “Implementation Steps”

Once the installation is complete, the basic steps to implement Green Shipping Protection on your site are:

  1. Add a script tag to the <head> of any page that needs the widget.
  2. Configure the Checkout Plus elements in the Corso Checkout Plus settings: checkout button, pricing info, opt-out button.
    • If you do not have specific selectors (e.g., element ID or class) for these elements, you may need to add them to your theme.
  3. Style the elements in the Corso Checkout Plus settings.

The placement process can typically be completed in just a few minutes.

👉 The Corso Customer Success Team leads the implementation effort and can bring in members of the product development team as needed to assist.

Functionality

Section titled “Functionality”

At a high level, the widget incorporated into your site works by performing the following steps:

  1. Query the Corso API to retrieve details about how the widget should be displayed.
    • The response includes various settings and styles which can be set from within the Green Shipping Protection app in the Shopify Admin.
  2. Attempt to place the widget on the page.
  3. Based on the contents of the cart, request a protection price from the Corso API.
  4. Display the Checkout Plus elements.
  5. Get buyer consent from the customer to add shipping protection at checkout.