Language

2Checkout Documentation

Standard Checkout

Our Standard Checkout option provides a complete checkout solution that can handle every part of the buyer’s checkout process on a single page. You can tailor the whole checkout process to your needs by passing in billing/shipping information, currency, language and checkout step.

Integration


Standard Checkout can be utilized with our Plug and Play cart using the Plug and Play cart parameter set or your own shopping cart solution using our Pass through Products parameter set.


Plug and Play Integration

When using our plug and play cart, your products, coupons and shipping methods will need to be created in the seller area. Once created, you can create buy buttons/links which will pass the buyer and one or multiple products to our checkout using our Plug and Play parameters. Products must be passed in using the ‘product_id’ parameter with the 2Checkout Product ID (2CO ID) our system assigns to the product on creation. Standard Checkout will present the shipping methods that you create in the seller area if they are marked as active for the buyer’s country.

HTML Examples

You will need to use at least the three base required parameters for the set (sid, product_id, quantity).

Example Single Product Link

<a href="https://www.2checkout.com/checkout/purchase?sid=1303908&product_id=10&quantity=1">Add to Cart</a>

To put this in explainable terms, our checkout (https://www.2checkout.com/checkout/purchase) is being told that the buyer wants to purchase one (quantity=1) of the product that was assigned an ID of “10″ (product_id=10) by our system from this seller (sid=1303908).

This can also be represented within an HTML form, which can provide you more flexibility in terms of how you construct your site. Below is the base required elements to an HTML form for a single product:

Example Single Product Form
<form action='https://www.2checkout.com/checkout/purchase' method='post'>
<input type='hidden' name='sid' value='1303908' >
<input type='hidden' name='product_id' value='10' >
<input type='hidden' name='quantity' value='1' >
<input name='submit' type='submit' value='Add to Cart' >
</form>

You can also have multiple products within a payment link or HTML form. This is helpful for sellers who sell products as a package or in bulk. To do this, you would add an incrementing digit to the end of both ‘product_id’ and ‘quantity’ for each individual product to be purchased.

Example Multiple Product Link
<a href="https://www.2checkout.com/checkout/purchase?sid=1303908&product_id1=1&quantity1=1&product_id2=2&quantity2=1">Add to Cart</a>


Example Multiple Product Form
<form action='https://www.2checkout.com/checkout/purchase' method='post'>
<input type='hidden' name='sid' value='1303908' >
<input type='hidden' name='product_id1' value='1' >
<input type='hidden' name='quantity1' value='1' >
<input type='hidden' name='product_id2' value='2' >
<input type='hidden' name='quantity2' value='1' >
<input name='submit' type='submit' value='Buy from 2CO' >
</form>

When clicked the buyer is passed to your custom checkout page to complete their order or if they want to add more products, they can simply click the “Return to Shopping” button to return back to your site.

To allow the buyer to return back to their cart without adding an additional product, you can simply provide them with a link to the checkout that does dot pass any additional products.

Example View Cart Link
<a href="https://www.2checkout.com/checkout/purchase?sid=1303908">View Cart</a>

Locking the Quantity Fields

To be as versitable as possible, Standard Checkout allows the buyer to change their quantity while on the checkout page. You can disable this feature and lock the quantity to the value that you passed in using the ‘quantity’ parameter by passing in the ‘fixed’ parameter with a value of ‘Y’.

Example Fixed Cart Form
<form action='https://www.2checkout.com/checkout/purchase' method='post'>
<input type='hidden' name='sid' value='1303908' >
<input type='hidden' name='product_id' value='10' >
<input type='hidden' name='quantity' value='1' >
<input type='hidden' name='fixed' value='Y' >
<input name='submit' type='submit' value='Checkout' >
</form>

Pass Through Products Integration

When using your own shopping cart the last thing you want to worry about is recreating your products or shipping methods in another system. By utilizing our Pass Through Product parameter set, your products, coupons and shipping methods can be passed in dynamically and never need to be created in the seller area.

Pass Through Product Example

This sale includes 1 product with a quantity of 2, a coupon deduction and both shipping and tax surcharges. The form also passes in all the billing and shipping information.

<form action='https://www.2checkout.com/checkout/purchase' method='post'>
<input type='hidden' name='sid' value='1303908' >
<input type='hidden' name='mode' value='2CO' >
<input type='hidden' name='li_0_type' value='product' >
<input type='hidden' name='li_0_name' value='Example Product Name' >
<input type='hidden' name='li_0_product_id' value='Example Product ID' >
<input type='hidden' name='li_0__description' value='Example Product Description' >
<input type='hidden' name='li_0_price' value='10.00' >
<input type='hidden' name='li_0_quantity' value='2' >
<input type='hidden' name='li_0_tangible' value='Y' >
<input type='hidden' name='li_1_type' value='shipping' >
<input type='hidden' name='li_1_name' value='Example Shipping Method' >
<input type='hidden' name='li_1_price' value='1.50' >
<input type='hidden' name='li_2_type' value='coupon' >
<input type='hidden' name='li_2_name' value='Example Coupon' >
<input type='hidden' name='li_2_price' value='1.00' >
<input type='hidden' name='li_3_type' value='tax' >
<input type='hidden' name='li_3_name' value='Example Tax' >
<input type='hidden' name='li_3_price' value='0.50' >
<input type='hidden' name='card_holder_name' value='Checkout Shopper' >
<input type='hidden' name='street_address' value='123 Test St >
<input type='hidden' name='street_address2' value='Suite 200' >
<input type='hidden' name='city' value='Columbus' >
<input type='hidden' name='state' value='OH' >
<input type='hidden' name='zip' value='43228' >
<input type='hidden' name='country' value='USA' >
<input type='hidden' name='email' value='example@2co.com' >
<input type='hidden' name='phone' value='614-921-2450' >
<input type='hidden' name='phone_extension' value='197' >
<input type='hidden' name='ship_name' value='Gift Receiver' >
<input type='hidden' name='ship_street_address' value='1234 Address Road' >
<input type='hidden' name='ship_street_address2' value='Apartment 123' >
<input type='hidden' name='ship_city' value='Columbus' >
<input type='hidden' name='ship_state' value='OH' >
<input type='hidden' name='ship_zip' value='43235' >
<input type='hidden' name='ship_country' value='USA' >
<input name='submit' type='submit' value='Checkout' >
</form>

Skipping Checkout Steps

You can use the ‘purchase_step’ parameter to set the purchase step that the buyer will land on when being directed to the checkout page. Possible values are ‘review-cart’, ‘shipping-information’, ‘shipping-method’, ‘billing-information’ and ‘payment-method’. Please Note: To skip a purchase step, all required fields must be pre-populated with the parameters that are passed in with the sale. If a required field is not pre-populated, the buyer will revert back to the step that needs to be completed.

Example Plug and Play Form
<form action='https://www.2checkout.com/checkout/purchase' method='post'>
<input type='hidden' name='sid' value='1303908' >
<input type='hidden' name='product_id' value='10' >
<input type='hidden' name='quantity' value='1' >
<input type='hidden' name='purcahse_step' value='payment-method' >
<input type='hidden' name='card_holder_name' value='Checkout Shopper' >
<input type='hidden' name='street_address' value='123 Test St' >
<input type='hidden' name='street_address2' value='Suite 200' >
<input type='hidden' name='city' value='Columbus' >
<input type='hidden' name='state' value='OH' >
<input type='hidden' name='zip' value='43228' >
<input type='hidden' name='country' value='USA' >
<input type='hidden' name='email' value='example@2co.com' >
<input type='hidden' name='phone' value='614-921-2450' >
<input type='hidden' name='phone_extension' value='197' >
<input type='hidden' name='ship_name' value='Gift Receiver' >
<input type='hidden' name='ship_street_address' value='1234 Address Road' >
<input type='hidden' name='ship_street_address2' value='Apartment 123' >
<input type='hidden' name='ship_city' value='Columbus' >
<input type='hidden' name='ship_state' value='OH' >
<input type='hidden' name='ship_zip' value='43235' >
<input type='hidden' name='ship_country' value='USA' >
<input name='submit' type='submit' value='Checkout' >
</form>
Example Pass Through Products Form
<form action='https://www.2checkout.com/checkout/purchase' method='post'>
<input type='hidden' name='sid' value='1303908' >
<input type='hidden' name='mode' value='2CO' >
<input type='hidden' name='li_0_type' value='product' >
<input type='hidden' name='li_0_name' value='Example Product Name' >
<input type='hidden' name='li_0_product_id' value='Example Product ID' >
<input type='hidden' name='li_0__description' value='Example Product Description' >
<input type='hidden' name='li_0_price' value='10.00' >
<input type='hidden' name='li_0_quantity' value='2' >
<input type='hidden' name='li_0_tangible' value='Y' >
<input type='hidden' name='li_1_type' value='shipping' >
<input type='hidden' name='li_1_name' value='Example Shipping Method' >
<input type='hidden' name='li_1_price' value='1.50' >
<input type='hidden' name='li_2_type' value='coupon' >
<input type='hidden' name='li_2_name' value='Example Coupon' >
<input type='hidden' name='li_2_price' value='1.00' >
<input type='hidden' name='li_3_type' value='tax' >
<input type='hidden' name='li_3_name' value='Example Tax' >
<input type='hidden' name='li_3_price' value='0.50' >
<input type='hidden' name='card_holder_name' value='Checkout Shopper' >
<input type='hidden' name='street_address' value='123 Test St' >
<input type='hidden' name='street_address2' value='Suite 200' >
<input type='hidden' name='city' value='Columbus' >
<input type='hidden' name='state' value='OH' >
<input type='hidden' name='zip' value='43228' >
<input type='hidden' name='country' value='USA' >
<input type='hidden' name='email' value='example@2co.com' >
<input type='hidden' name='phone' value='614-921-2450' >
<input type='hidden' name='phone_extension' value='197' >
<input type='hidden' name='ship_name' value='Gift Receiver' >
<input type='hidden' name='ship_street_address' value='1234 Address Road' >
<input type='hidden' name='ship_street_address2' value='Apartment 123' >
<input type='hidden' name='ship_city' value='Columbus' >
<input type='hidden' name='ship_state' value='OH' >
<input type='hidden' name='ship_zip' value='43235' >
<input type='hidden' name='ship_country' value='USA' >
<input type='hidden' name='purchase_step' value='payment-method' >
<input name='submit' type='submit' value='Checkout' >
</form>

Return Process

Standard Checkout and Inline Checkout share the same return processes.