Knowledge Base » Suppliers » Tech Support » Using the Plug n Play Cart »

How do I add multiple products to the PNP cart using one link?

If you have chosen to upload your products to our database (instead of using a third-party cart), you can create a single link that - when clicked - will add two or more products to the 2CO cart.

https://www.2checkout.com/2co/buyer/purchase?sid=XXXXXX&product_id1=Y&product_id2=Z&quantity1=1&quantity2=1

Be sure to replace the Xs with your numerical seller ID, the Y with the ID of your first product and Z with the ID of your second product.

To add more than two products with one action, simply append a product_id3 and quantity3 parameter, then a product_id4 and quantity4 parameter and so on.

Important Note: When you are testing parameters, please be certain to clear the cookies in your browser between tests to ensure the changes you have made are applied. For more information on clearing the cookies please click here.

How can I customize the appearance of the Order Page?

Customizing the Order Page is just a matter of passing the correct parameters.

The first three customizations were available in V1:

https://www.2checkout.com/2co/buyer/orderpage?sid=XXXXXX&p1=1&p2=30
This link displays items 1 through 30 and this is why: p1=1&p2=30

https://www.2checkout.com/2co/buyer/orderpage?sid=XXXXXX&p1=31&p2=60
This link displays items 31 through 60 and this is why: p1=31&p2=60

https://www.2checkout.com/2co/buyer/orderpage?sid=XXXXXX&p3=1,2,5
This link means show product 1, 2 and 5 on the order form.

The following customizations are new to V2:

Sort by price:
https://www.2checkout.com/2co/buyer/orderpage?sid=XXXXXX&sort=price&sort_order=asc
https://www.2checkout.com/2co/buyer/orderpage?sid=XXXXXX&sort=price&sort_order=desc

Sort by assigned product ID:
https://www.2checkout.com/2co/buyer/orderpage?sid=XXXXXX&sort=assigned_product_id&sort_order=asc
https://www.2checkout.com/2co/buyer/orderpage?sid=XXXXXX&sort=assigned_product_id&sort_order=desc

Displaying product images:
There is now a column for product images on the Order Page. Your product images will appear here once they have been approved to appear in the Shopping Center. Passing the “images” parameter with a value of “N” will remove the display of product images. A value of “Y” will display them. “Y” is the default if the “images” parameter is not passed.

https://www.2checkout.com/2co/buyer/orderpage?sid=XXXXXX&images=Y
https://www.2checkout.com/2co/buyer/orderpage?sid=XXXXXX&images=N

Please note that you will need to replace “XXXXXX” with your own vendor ID.

Important Note: When you are testing parameters, please be certain to clear the cookies in your browser between tests to ensure the changes you have made are applied. For more information on clearing the cookies please click here.

What are the parameters for 2CO’s Plug and Play cart?

Below are the parameters supported by the Plug and Play Cart. These parameters can only be used if you have added your products to the 2CO database. You are using the Plug and Play cart if you are passing in the three parameters listed under the Required section below.

Multi-page Payment Routine:
https://www.2checkout.com/2co/buyer/purchase
Supports all payment methods. Supports tangible and intangible products/services.

Single Page Payment Routine:
https://www.2checkout.com/checkout/spurchase
Credit card-only payment routine only available for intangible products/services.

Required Parameters:
sid - Your 2Checkout vendor account number. (64 characters max)
product_id - The 2CO ID for the product or service in your 2Checkout account.
quantity - The quantity of the product. (99 max value)

Additional Parameters:
demo - Y to enable demo mode, do not pass this in for live sales
fixed - Y to remove the Continue Shopping button and lock the quantity fields
lang - “sp” for Spanish purchase routine pages, defaults to English if this is absent, but “en” may be used for English as well.
return_url - Used to control where the Continue Shopping button will send the customer when clicked. (255 characters max)
merchant_order_id - Specify your order number with this parameter. It will also be included in the confirmation emails to yourself and the customer. (50 characters max)
pay_method - CC for Credit Card, CK for check, PPI for PayPal, PPL for PayPal Pay Later, or FXS for FXSource. This will set the default selection on the payment method step during the checkout process.
skip_landing - If set to 1 it will skip the order review page of the purchase routine. If there are options on the products it will cause an error and redirect the customer back to the order review page.
x_Receipt_Link_URL -Used to specify an approved URL on-the-fly, but is limited to the same domain that is used for your 2Checkout account, otherwise it will fail. (no limit):

  • This parameter will over-ride any URL set on the Look and Feel page.
  • If Direct Return is disabled: If only one product is ordered, it will over-ride the return URLs on the product as well. If more than one product is ordered, then this parameter will control where the “Click Here to Notify [Your Company]” button on the final page takes the customer, but the return URLs on the products will be listed as links below the button, next to the description of the product.
  • If Direct Return is enabled : If one product is ordered, this parameter will NOT over-ride the return URLs on the products. If more than one product is ordered, then this parameter will over-ride the product return URLs. Also keep in mind that many third party shopping carts recommend that Direct Return be disabled to work properly.

To populate the billing information page you may pass in:
card_holder_name - Card holder’s name. (128 characters max)

The card holder’s name can also be populated using the first_name, middle_initial, and last_name parameters. IMPORTANT: If you use these three parameters, the data will be combined into and returned as card_holder_name to your Approved URL script.

street_address - Card holder’s street address (64 characters max)
street_address2 - The second line for the street address, typically suburb or apartment number information (64 characters max)
city - Card holder’s city (64 characters max)
state - Card holder’s state (64 characters max)
zip - Card holder’s zip (16 characters max)
country - Card holder’s country (64 characters max)
email - Card holder’s email address (64 characters max)
phone - Card holder’s phone number (16 characters max)
phone_extension - Card holder’s phone extension (9 characters max)

To populate the shipping information page you may pass in:
ship_name
ship_street_address
ship_street_address2
ship_city
ship_state
ship_zip
ship_country

Please note that shipping information will only be collected for items that are defined as tangible in our system. Shipping is also only charged for tangible items. We will ask for shipping information if you pass in any of the shipping parameters, regardless of whether the item is tangible or not. This does not mean we will apply shipping charges to the sale, but their information will be collected.

The billing information page will also be populated with the information from the shipping page if the shipping information is collected on that sale and the billing information is not passed in.

Custom Parameters:
You may pass in any additional parameters that you may need and they will be returned to you at the end of the sale. The only restrictions on custom parameters are that they can not share the name of ANY parameter that our system uses, even from the other sets. Please note that you WILL need a return script set up on the Look and Feel page to receive any of these parameters back as they are not included in the confirmation emails.

Passing Multiple Plug and Play Products:
You may also pass multiple plug and play products in one form. To do this add a corresponding digit to the quantity and product_id parameters to group them for each product. For example, if we wanted to pass two products into the system we would be passing in first the sid parameter, then product_id1 and quantity1, and then product_id2 and quantity2.

Example:

<form action='https://www.2checkout.com/2co/buyer/purchase' method='post'>
<input type='hidden' name='sid' value='123' >
<input type='hidden' name='quantity1' value='1' >
<input type='hidden' name='product_id1' value='1008' />
<input type='hidden' name='quantity2' value='1' >
<input type='hidden' name='product_id2' value='1014' >
<input type='hidden' name='quantity3' value='1' >
<input type='hidden' name='product_id3' value='1011' >
<input name="submit" type='submit' value='Buy from 2CO' >
</form>

You can receive back all of the parameters that were passed in as well as the following parameters:
order_number - 2Checkout.com order number
total - the total amount of the purchase
ship_method - the shipping method that was selected for this order (if applicable)
credit_card_processed - Y if successful (Approved), K if waiting for approval (Pending)
merchant_product_id - your product ID for purchased item
key - the MD5 hash that can be used to verify that the sale came from one of our servers

Also note that this is the only parameter set that can be used for recurring billing with our service.

Important: You can not mix the three parameter sets. This will cause problems during payment or may prevent the payment pages from working at all.

Important Note: When you are testing parameters, please be certain to clear the cookies in your browser between tests to ensure the changes you have made are applied. For more information on clearing the cookies please click here.

Related Article: Country Codes

How can I customize the look and feel of the buy buttons?

It is possible to use Cascading Style Sheets (CSS) to customize the look and feel of our buy buttons on your website. For more details on this, we recommend that you review the following third-party tutorial.

http://www.webreference.com/programming/css_stylish/

Please note that 2CO does not provide assistance with designing any aspect of your website - including button formatting - as part of our support package, and this information is therefore provided your reference only.

How can I make a view cart link?

You can easily make a link that allows customers to get back to their cart from your website by using the link below.

> https://www.2checkout.com/2co/buyer/purchase?sid=XXXXXX

Note: Be sure to replace “XXXXXX” with your numerical seller identification number.

How can I send my website visitors to a single page that displays all of my products?

For vendors who have chosen to add products to our database, we provide you with the ability to link customers to a single page where they can view ALL of the products offered, and order from that page.

Simply link them to your accounts order page at the link below. Be sure to replace the SID shown with your numerical seller ID.

https://www.2checkout.com/2co/buyer/orderpage?sid=XXXXXX

What are the different Shipping methods with the Plug N Play Cart?

2Checkout can automatically calculate shipping costs in the following ways:

  • Shipping by weight, based on the weight you set in your product details.
  • Shipping by order total, surcharge based on the orders total.
  • Flat fee shipping per order.
  • Per product handling fee.
  • Additional surcharge fee for specific countries.
  • Ability to create multiple shipping options that are selectable by the customer.

Related Articles

Can 2CheckOut automatically calculate shipping costs?

2checkout does not automatically calculate shipping cost, however we do provide a customizable shipping method system. You can charge a specific amount per item by including a handling charge for each product, or you can create base amount shipping methods which would apply to an entire order, or a combination of both a base charge for an order and an additional charge for individual items. Shipping can also be calculated based on the weight assigned to a product in combination with a weight based shipping method. Full details on creating shipping methods can be found in Chapter 5 of our User’s Guide.

How do I Prevent Customers from Ordering from Certain Countries?

Many suppliers use their shipping methods to restrict sales from certain countries. If you are selling intangible products you may want to restrict your yours from certain countries as well.

Restricting intangible orders from certain countries.

You may restrict orders from certain countries for intangible products by using the E-Good Country Blacklist feature in your account. This feature will restrict intangible orders to certain countries based on the billing country the customer selects in the purchase routine. If a customer enters a billing country that is restricted in E-Good Country Blacklist they will receive the following error:

Our supplier cannot currently offer these products to you based on your current location of ( COUNTRY NAME )

If you still wish to continue with your purchase please use the button provided below to go back and remove these products from your shopping cart:

* (PRODUCT NAME)

To access this feature in the 2CO Classic Sellers Area (V2), please follow the instructions below.

1. Login to your account at https://www.2checkout.com/2co/login

2. Click on ‘eGood Allowable Countries’.

3. You should arrive at a page with two columns. On the left are the countries you accept orders from currently. On the right are the countries you have blocked.

4. Highlight the country you want to move from one list to another.You may use CTRL+CLICK to highlight more than one at a time. Using the arrow buttons, indicate which list you want to move the highlighted countries to.

5. When you are finished making changes, click ‘Home’ in the top right-hand corner to return to your account homepage. Your changes will automatically be saved.

To access this feature in our New (VA) Vendor Sellers Area please login at the following url: https://www.2checkout.com/va/
Once you have logged in click the ‘Shipping’ tab and then select the ‘E-Goods’ subcategory. From here you may scroll thought the countries in your Allowed list and select the countries you wish to remove. Once you have selected the countries you wish to remove you may click on the ‘Deny’ button at the bottom of the list. This will move the country to your Denied list. If you wish to allow a country on your Denied list, you may select the country and click on the ‘Allow’ button at the bottom of the list.

Restricting shipping to certain countries.

Tangible Products: (Products set up as tangible when they were added to our database.)

2Checkout allows you to restrict the shipping of tangible products to certain countries based on the shipping country the customer selects in the purchase routine. If a customer enters a shipping country that is not supported by your shipping method they will receive the following error:

No shipping available to your country

To restrict the shipping of tangible products to certain countries in the 2CO Classic Sellers Area (V2), please follow the instructions below.

1. Login to your account at https://www.2checkout.com/2co/login

2. Click on ‘Shipping Methods’.

3. You should see a table of shipping methods you have previously set up. If you haven’t yet set up your shipping methods, please see the tutorial linked below entitled ‘How do I set up shipping charges by weight, flat rate or by country?’

To not allow a particular shipping method to be selected when the customer is in a given country, check the ‘Remove’ box associated for that country and shipping method and then press ‘Submit Changes’. You will notice that ‘Method Not Allowed’ now appears for that method.

To disallow orders from a given country, check all of the ‘Remove’ boxes associated with that country for all methods and then press ‘Submit Changes’. If all methods for a given country are removed, the country disappears from the list and no one can order from that country.

When you have finished making changes, press ‘Submit Changes’ and your settings will be saved.

To restrict the shipping of tangible products to certain countries in our New (VA) Vendor Sellers Area please login at the following url: https://www.2checkout.com/va/
Once you have logged in click the ‘Shipping’ tab and then select the ‘List’ subcategory. From here you may click the edit icon next to the shipping method you wish to edit. This will open the shipping wizard where you will need to select ‘Custom List’ under the countries section. This will open the custom country list where you can select the check box for the country you wish to restrict. Once you have selected the countries you wish to restrict you may click on the ‘Continue’ button at the bottom of the page. You will then need to click the ‘Save’ button to save your changes and exit the shipping wizard.

Related Articles

How do I set up shipping charges by weight, flat rate or by country?

This tutorial describes how to set up shipping methods in your account for the first time. If you are looking to edit shipping methods that you have already defined, please see that article which is linked at the bottom of this page.

1. Login to your account at https://www.2checkout.com/2co/login.

2. Click on ‘Shipping Methods’.

3. You should arrive at a page telling you that no shipping methods have been se tup yet. Click on the specified button to continue. A new window will open.

4. You will see the following fields. Below is an explanation of each.

Name - This is what your shipping method will be called. You could put the name of the company here or anything else. (Examples: DHL, Federal Express, Pickup)

Base - This is the base amount to charge. All charges are computed from this amount. Enter as a figure to two decimal places without a currency symbol. (Example: 5.95, 4.00)

Weight - If you will be offering flat rate shipping for this shipping method, leave this box unchecked. If the charge will be based on weight and you plan to specify the weight for each product in your account, please check this box.

Countries - If you only want to offer shipping to customers within your country, check ‘Home Country Only’. To sell to all countries, check ‘All Trusted Countries’. Note that you can disallow orders from specific countries in the next step.

5. Click ‘Create Method’ to save this shipping method.

6. If you wish to add additional methods, you may do so by repeating steps one through five in the boxes provided to the right.

7. When you are done adding all methods, please click ‘Close this Window’.

8. You will be returned to a page that shows each of the shipping
method(s) you have created, together with any existing methods (if any) that were already in your account. This page will have a spreadsheet-like appearance. Going across the page, you will have a listing of each method you created. Going down the page, is a listing of all countries you currently accept shipments from.

To not allow a particular shipping method to be selected when the customer is in a given country, check the ‘Remove’ box associated for that country and shipping method and then press ‘Submit Changes’. You will notice that ‘Method Not Allowed’ now appears for that method.

To disallow orders from a given country, check all of the ‘Remove’ boxes associated with that country for all methods and then press ‘Submit Changes’. If all methods for a given country are removed, the country disappears from the list and no one can order from that country.

The above two sections only apply to tangible orders. You can restrict intangible orders by using the e-good blacklist utility.

You will also see an option to add a surcharge for one or more countries. A surcharge is an additional charged applied to all orders from the specified country in addition to the base rate that has been set for that method.

Formula: Base Rate + Surcharge = Amount Charged on Payment Screen

For example, if you create a method called ‘DHL’ with a base charge of ‘5.00′ and specify a surcharge of ‘10.00′ for Canada, any Canadian customer who attempts to order and specifies &quot;Canada&quot; as their country will be charged $15.00.

The ‘Total’ line tells you what the cost will be to customers ordering from that country. If you don’t want to add a surcharge and only want to charge the base rate, leave it as is (0.00).

9. If you elected to apply shipping charges by weight when you added the method, then you will see ‘Weight Charges Apply’ under the method(s) that have been so designated. Click on the link to set up your rate table. You must set up a rate table in order to charge shipping by weight.

Every shipping method with a weight charge has a default of 1 Currency Unit per pound of goods. When you enter a new division you are entering an upper bound for a weight group. For example you create a division of 5lbs with a surcharge of 10 Currency Units. This will add a surcharge of 10 for all orders from 0-5lbs.

If an order is 5.01 lbs in weight it will fall into the next highest weight division.

If an order is heavier than any specified division the system will take the cost of the heaviest division and add the overweight amount for that method until it surpasses the weight of the order.

For example:

5lbs and 10 Currency Units is the largest weight division you have and the current overweight amount is 1 Currency Unit.

The charge for an 11 pound order would be 16 Currency Units. 10 Units for the 5lb division and 1 Unit for each pound over the 5lb division.

To change the overweight amount from the default of 1 Currency Unit/pound you can set this at the bottom of the page. This will area will also show you examples of weights that are beyond your current weight divisions and what the shipping charges would be.

If you wish to add a set amount for each pound worth of products added to the cart, specify this amount under ‘Each above add’ as a number to two decimal places with no currency symbol. Remember that this amount is in addition to the base charge and any surcharges for specific countries. (Example: 1.35)

Under ‘New’, type a numerical unit of measure in pounds. Then specify a dollar amount to the right of this field in the box.

When you have finished, press ‘Close Window’ and you will be returned to the main shipping screen.

Continue to set up a weight charge table for each shipping method you have designated as being calculated by weight as described in step nine of this tutorial.

Note: If you are using a third-party cart, any settings for shipping made in your 2CO account will NOT apply to items bought through the cart. Your cart will be responsible for setting up shipping and applying it to the orders.

Related Articles

Page 2 of 3«123»

Recent Posts from the Community:

Voucher possible?

posted by: isay

Pay from 2co

posted by: starcom

Vendor Issue

posted by: manz135
More from the community »

Now a faster, easier way to get paid – the 2CO reloadable MasterCard®.

Sign up today and receive a $10 credit on your card.


Click here to learn more.

Spotlight Supplier

Spotlight Supplier

Chocolate Shoppe

Spotlight Product

Spotlight Product

Canadian Mini Muks


Popular Tags