The Buy Button

The Buy Button is a customisable URL which can be used on any page offering direct-to-cart, or direct-to-checkout product purchases. For Bundle Products the user will always land on the product page where they can configure their bundle and then add to cart.

For example, you can write an article and add the Buy Button URLs within the text to add any product to your cart, or send them directly to the checkout.

Or, you could add a donation link into an email, which adds the givers’ details and donation amount directly into the checkout (provided those details were known, of course).

URL syntax:
[store domain]{/path}/cart/[product string]?[other-parameters]

e.g. https://example.com/cart/RSK-MC-22:1?type=buy

See It In Action

Direct-to-Checkout

In the below example we are sending a customer directly to the checkout to purchase a product. Where, RSK-MC-22 is the product code and 1is the quantity to purchase, the product string would be RSK-MC-22:1

https://storeconnectdemo.com/cart/RSK-MC-22:1?type=buy

Add-to-Cart

You can add-to-cart using the parameter type=add

https://storeconnectdemo.com/cart/RSK-MC-22:1?type=add

Variable Pricing

With Variable Pricing enabled in the product’s Price Book you can customise the sell price of the product. Where, 35000 is the sell price of $350.00 and 4500 would be the sell price of $45.00.

https://storeconnectdemo.com/cart/RSK-MC-22:1:35000?type=buy

Using a Promotion Code

Embedding a Promotion Code is also possible by adding code=PROMOCODE to the query of the URL. This is case sensitive and can be done as follows.

https://storeconnectdemo.com/cart/commercial-flat-press-bench:1?type=buy&code=10OFFGYM

Pre-Filled Details

To streamline the transaction even further, you can pre-fill any details you may already know of the customer. Where, name=Bob%20Smith is the fullname with a space %20 in between the two words.

https://storeconnectdemo.com/cart/RSK-MC-22:1?name=Bob%20Smith;email=bobsmith@example.com

An Image Link

Using the customised Buy Button URL, it is easy to add the link to an image.

How It Works

Product String

[sfid or slug or product code]:[quantity]{:[custom price]}

Adding two products, a pair of sneakers and a donation of $50:

sneakers:1,donation-open-ended:1:5000

Other Parameters

type
type indicates the type of action to perform, either just add to cart, or start the checkout.

Options:

add adds to cart
buy adds to cart and starts the checkout (default when no parameter is added)

sneakers:1,donation-open-ended:1:5000?buy=add

return
return specifies where to send the customer after the action is complete, i.e after added to cart or after checkout is completed.

Options:

true returns to the referrer url (default when no parameter is added)
false continue with the StoreConnect flow and do not route the customer
anything else is assumed to be a callback url to send the customer to

sneakers:1,donation-open-ended:1:5000?buy=add;return=false

Name and address fields
These are all optional and get saved into the session and used in the checkout if supplied:

name
fn (first name)
ln (last name)
email
phone
street
city
state
country
postcode

sneakers:1,donation-open-ended:1:5000?buy=add;return=false;name=Bob%20Smith

Back to Documentation