Configuration

Order Lines (Cart)

Providing the contents of the Shopper's cart on the Merchant site allows Connect to determine what items in the cart are leasable and which are not.

Cart (order)

Providing delivery costs and cart item information for the order is required. An order Id is optional, but desired. See the Success call back section regarding providing order number and delivery date information to Connect after the checkout process has completed.

Cart (item details)

Providing the unique order line information below allows Connect to determine which items are leasable and present the proper lease-to-own pricing to the Shopper.

Delivery date cannot be empty.

Remove the date from the cart and return the date later using the provided deliveryConfirmationUrl. See the Callbacks Success section for more details.

Passing sales tax

Examples of how you can pass the sales tax for the cart items:

cart: {
  orderId: "5423344523",
    items: [
      {
        brand: "Apple",
        description: "iPhone SE 64GB Midnight",
        category: "Cell Phones",
        identifier: "MMX53LL/A",
        imgUrl: "",
        unitPrice: 429.00,
        tax: 31.10,
        quantity: 1,
        condition: "new",
        deliveryDate: "2023-08-30"
      },
      {
        brand: "Apple",
        description: "AppleCare+ for iPhone SE (3rd generation)",
        category: "Warranty",
        identifier: "sEH62LL/A",
        imgUrl: "",
        unitPrice: 79.00,
        tax: 0,
        quantity: 1,
        condition: "new",
        deliveryDate: "2023-08-21"
      }
    ],
    deliveryCost: 10.99,
    deliveryCostSalesTax: 4.00
},

cart: {
  orderId: "5423344523",
    items: [
      {
        brand: "Apple",
        description: "iPhone SE 64GB Midnight",
        category: "Cell Phones",
        identifier: "MMX53LL/A",
        imgUrl: "",
        unitPrice: 429.00,
        tax: 26.26,
        quantity: 1,
        condition: "new",
        deliveryDate: "2023-08-30"
      },
      {
        brand: "Apple",
        description: "AppleCare+ for iPhone SE (3rd generation)",
        category: "Warranty",
        identifier: "sEH62LL/A",
        imgUrl: "",
        unitPrice: 79.00,
        tax: 4.84,
        quantity: 1,
        condition: "new",
        deliveryDate: "2023-08-21"
      }
    ],
    deliveryCost: 10.99,
    deliveryCostSalesTax: 4.00
},

Connect prefill

Payment card

Connect prefill can populate the payment card information on your checkout page when you share payment field information. Check out our interactive Experience demo to observe the payment card autofill function in action.

Using the querySelector() type, a Merchant can allow Connect to "find" (select) the siteConfig elements below and prefill the fields with our virtual card numbers. This creates a seamless checkout experience on your site.

Shopper information

Customer information entered on a Merchant's checkout page can be passed to Connect and used to prefill the lease application. Prefilling the lease application creates an improved customer experience and streamlines the Connect lease application flow.

Address

customer: {
	id: "32355323456",
	firstName: "John",
	lastName: "Doe",
	email: "[email protected]",
	phone: "5555555554",
	address: {
		shipping: {
			line1: "123 Main Street",
			city: "No Where",
			state: "UT",
			zip: "84555"
		},
		billing: {
			line1: "321 South Street",
			city: "Some Where",
			state: "UT",
			zip: "85444"
		}
	}
},

Callbacks

The below callbacks are used to relay state to the application implementing Connect.

Success

A successful checkout indicates a Shopper's lease-to-own experience with Progressive is complete. The Shopper is returned to your site's checkout page to use the virtual card generated for the lease.

When checkout is successful as described above, Connect provides your system with two unique, one-time use URLs. Store the URLs and use them to update Progressive with order details post-purchase.

The URL endpoints should only be called once the complete order has been delivered. Once Progressive receives a Merchant's delivery confirmation, the lease obligation begins for the customer. Merchants generally use these functions post-purchase in cases where the order Id or delivery date were not provided with the required cart information.

When a Merchant is ready to acknowledge the entire order has been delivered or delivery is scheduled, call the URL endpoints to submit the information. Examples are below.

//Progressive will provide this information with each successful checkout and lease.
onSuccess: function(s) {
	SaveLeaseId(s.id);
	SaveDeliveryConfirmationUrl(s.deliveryConfirmationUrl);
	SaveOrderConfirmationUrl(s.orderConfirmationUrl)
},

//POST api/v1/update-delivery?leaseId={obfuscatedLeaseId}&code={uniqueCode}
{
    "deliveryDate": "2023-08-21" // this is the delivery date that should be associated with the lease
}

//POST api/v1/update-order?leaseId={obfuscatedLeaseId}&code={code}
{
    "orderId": "123456" // this is the orderId that should be associated with the lease
}

Cancel

The onCancel callback will be executed when the shopper exits Connect prior to completing the lease-to-own experience.

Failure

The onFailure callback will be executed when an unrecoverable error occurs during the Connect lease-to-own experience.