Express Checkout for Virtual Card

Express Virtual Checkout can be initiated from a merchant's cart page or Product Detail Page to encourage customers to pay with Zip earlier in the checkout process.

Cart Page Example

PDP Example

📘

Virtual Checkout on PDP

With Express checkout on PDP, as customers will be checking out with Zip straight from the product page, it is recommended to only implement this for items where a customer's cart will typically only contain that one item.

Express Flow

Zip will collect the shipping and customer address information in the Express flow, and pass this information back to the merchant, along with the billing address for the virtual card. This allows the customer to bypass the shipping and billing information pages for a faster checkout experience.

How to Implement

• Add checkoutFlow="express"as a button attribute.
• Implement the Multi-Page Checkout Handler to save a successful onComplete callback result and retrieve it on page load of the payment page and populate shopper, shipping address, billing address, and payment information.

📘

Shipping and Tax Calculations

Estimated shipping and tax costs are calculated for customers in the Zip checkout flow. Once the order is placed, you can authorize the actual shipping and tax amounts on the Zip issued virtual card, and the customer's payment plan will update accordingly.

Shipping Preferences for Express

There are some instances where a merchant might want to limit which states they ship to. Implement the bottom attributes to restrict addresses in certain states.

Button Attributes for Express

Example with shipping locations allowed only in Wisconsin, US, New York, US, and Canada

<zip-button 
	merchantid="Insert merchant Id" 
	merchantreference="order-123x" 
	shippingamount="0" 			
	taxamount="0" 
	allowedshippinglocations="WI-US, NY-US, CA"> 
</zip-button>

Example with shipping locations denied in Wisconsin, US, New York, US, and Canada

<zip-button 
	merchantid="Insert merchant Id" 
	merchantreference="order-123x" 
	shippingamount="0" 			
	taxamount="0" 
	deniedshippinglocations="WI-US, NY-US, CA">
</zip-button>

Open Checkout

var shippingPreferences = {
    "allowedShippingLocations": [
        {
            "country": "US",
            "state": "NY"
        },
        {
            "country": "US",
            "state": "WI"
        },
        {
            "country": "CA"
        },
    ]
}

// Setup
const checkoutConfig = {
    forceIframe: document.getElementById('forceIframe').checked,
    shippingPreferences: shippingPreferences, // shippingPreferences needs to be in the data structure from above.
};

await window.quadpay.virtualCheckout.openCheckout(merchantId, order, checkoutConfig);