For support on the Free Membership Script, you need to contact the maker MembershipClientPro.com, who provides the script free for Vendors to use. You can contact them at Lite@MembershipClientPro.com
Knowledge Base » Suppliers » Tech Support »
Sub-categories:
Articles in this Category:
- I need assistance with membership script support, who do I contact?
- How can I use a third-party affiliate script with 2CO?
- Do you offer a referral bonus program?
- Does your system offer an integrated affiliate solution?
- How do I create or edit actual product options for my products?
- How do I set up a new recurring product?
- How do I set up a new product?
- What are ‘product options’?
- How do I upload a CSV file of my products?
- What Authorize.net parameters does 2CO support?
+0
-0
I need assistance with membership script support, who do I contact?
December 30th, 2006, by: knowledgebase+0
-0
How can I use a third-party affiliate script with 2CO?
December 30th, 2006, by: knowledgebase2Checkout.com supports almost any affiliate program that works off of a hidden image tag on the sales confirmation page.
To setup third-party affiliate script, log in to your account and click on the “Account” tab, then click on “Site Management” subcategory. From here you can fill in the string that is provided by your affiliate program as the Affiliate URL. 2Checkout.com payment routines will fill in dynamic parameters like “order number”, “order total”, “your product id”, “quantity ordered”.
The Affiliate link will only work if you have Direct Return OFF. The hidden image tag is placed on the 2Checkout confirmation page after the sale and with Direct Return ON, this page is by passed.
To have the string populated dynamically, put the following variables in the appropriate location. The payment routine will fill them in after the sale is complete:
$a_order – 2Checkout.com Order Id.
$a_total – Total Dollars Paid.
$a_product – Your product id
$a_quantity – Quantity of product id sold.
Example src string:
https://affiliate.com/sale.cgi?order=$a_order&total=$a_total&product=$a_product&quantity=$a_quantity
If the buyer bought 1 of your product id 01-Widget for $2.00, after the sale the string would become
http://affiliate.com/sale.cgi?order=123456&total=2.00&product=01-Widget&quantity=1
+0
-0
Do you offer a referral bonus program?
December 30th, 2006, by: knowledgebase2Checkout Suppliers and Affiliates can earn money by referring new vendors to 2Checkout.com. To earn referral commissions place a link to the following URL on your site:
>> https://www.2checkout.com/2co/signup?affiliate=XXXXXX (be sure to replace the XXXXXX with your account number, it will not work the way it is)
And, if someone clicks on this, signs up, and their account is active for 60 days, you will receive an $11.00 USD bonus.
If you’re already a 2Checkout Supplier or Affiliate, this is built into your account. To participate in our affiliate program you must first sign up for a free affiliate account at the following url: https://www.2checkout.com/va/signup.
You can access a detailed list of your affiliate information by logging into your account, selecting ‘Vendor Reporting – Reports’ under the helpful links menu, and then clicking on the ‘Affiliate Signups’ link. This page will show the date the order was placed, whether or not the vendor stayed with us long enough for you to earn your bonus, the vendor’s website address, and the amount of the bonus you received.
You may use one of the following graphics for your referral links:
+0
-0
Does your system offer an integrated affiliate solution?
December 30th, 2006, by: knowledgebase2Checkout’s integrated affiliate program is the industry’s first FREE affiliate program. No additional fees are charged by 2Checkout for participating as a supplier or as an affiliate. As a supplier, you can offer affiliates a commission for successfully re-marketing your products on their websites. In this Pay-Per-Sale program, you choose the commission amount, and do not pay anything until a sale is made and the funds are deposited.
Our affiliate program provides our suppliers with many benefits over traditional affiliate programs.
Benefits for the supplier:
- No additional fees from 2Checkout.
- No additional software changes to your website.
- Ability to resell other suppliers products.
- No worries about keeping track of affiliate sales, 2Checkout pays your affiliates directly.
- Begin earning and paying commissions immediately after product enrollment.
Benefits for the affiliate:
- Free affiliate account.
- No ugly banner ads.
- HTML code and product images provided by 2Checkout.
- Ability to resell all of our suppliers affiliate products.
- Easy to navigate interface that provides up to date reporting for sale and payment information.
- Ability to receive payments by all of our supported payment methods.
The affiliate program is available to all of our suppliers and affiliates can now signup for free affiliate accounts. Affiliates can signup for their free account at the following url: https://www.2checkout.com/va/signup.
To access this program you must login to our new vendor interface at the following url: https://www.2checkout.com/va/
To make your products available for affiliate sales, simply edit your products by clicking on the ‘Products’ tab at the top of your supplier home page, then clicking on the ‘Edit’ sub-tab. Here you can add a category and commission for the products that you would like to offer in the affiliate program. To find products for you to sell on a commission basis on your website, just click on the ‘Affiliates’ tab at the top of the page, then click on the ‘Browse Opportunities’ sub-tab. From here you can select a category to find products that will interest visitors to your website.
A new feature guide which may help you navigate the affiliate area can be found here:
https://www.2checkout.com/static/va/documentation/FeatureGuide/content/06_Affiliates.html
We have also provided our suppliers with an in depth tutorial on adding products to the affiliate program and a tutorial for new affiliates that explains how to find affiliate opportunities.
—-Related Articles—-
- How can I use a third-party affiliate script with 2CO?
- Tutorial: Adding Products to the Affiliate Program
- Tutorial: Finding Affiliate Opportunities
- New Vendor Admin: List Opportunities
+0
-0
How do I create or edit actual product options for my products?
December 30th, 2006, by: knowledgebaseCreating Product Options
To create or edit the product options themselves, go to your products list. On your products list page, you will see an ‘Edit Product Options’ link. Clicking it will link you to the ‘edit product options’ page.
Once you find your way to the ‘edit product options’ page, you will see a list of all your product options. This list contains data fields and existing option names, option values, and any surcharges associated with them. It also has the ability for deleting options. To create new product options, fill in the set of data fields near the top of the page. Choose a name for the new option, as well as any values and surcharges.
- Option Name: The name of the option you create. Once you create it, it will appear in your product options list as a link.
- Option Values: These are the values assigned to the option name you create. They are the actual choices offered for the given option. For instance, if you have ‘Size’ as an option, the values might be ‘Small’, ‘Medium’, and ‘Large’.
- Value Surcharge: This is the additional cost you may charge customers to choose a certain option. Surcharges may be specified in whole numbers (5) or as decimals to two places (5.00, 4.99, etc.). You do not have to add surcharges.
For example, you own a clothing business and sell a variety of apparel. The clothing you sell is not made with just one type of material. All the apparel you sell is made with one of three choices: cotton, wool, or silk. You want your customers to be able to choose what material they want their clothes to be fashioned from. You will create a product option to do this. As the option name, you choose ‘Material’ and enter it into the correct field. As for option values, you would set three: cotton, wool, and silk. You decide to add a surcharge for wool and silk, as the base price advertised on your site is for cotton, and we know that wool and silk are more expensive. So, in the corresponding surcharge fields, you enter the appropriate amounts. For cotton, you would enter 0.00 to specify no surcharge. You decide to charge an extra $10.00 for wool. Enter 10.00 to do so. As for silk, well that is expensive, so you decide to charge an additional $25.00 for that. 25.00 should be entered to accomplish this. When you are finished, click on ‘Save Changes’ to save your options. This will effectively add an option called ‘Material’ to your product options list.
The example used here is precisely that, and the values and surcharges displayed are totally arbitrary. The actual number and types of options and values are unlimited. If, instead of material, you want to offer different sizes or colors, so be it. This system allows you to create
product options as unique as you want, and as you see fit.
Editing Existing Product Options
To edit existing product options, click on the name of the one you wish to edit. It will appear in your list as a link. It will lead you to a page with another set of data fields and delete options. Most of the fields will have previously saved data, but two will be empty. To edit an existing value, simply click in the correct field and change it to what you want. To change the name of the option, click that field and enter what you want. To delete a value, check the box next to the relative values. To add a new set of values, enter the suitable option value and surcharge. When you are totally finished adding, editing, or deleting, click on the ‘Save Changes’ button.
Removing Product Options
To delete a product option on the ‘edit product option’ page, check the delete option box next to the corresponding product option. Check any and all options you wish to delete. To finalize your actions, click ‘Save Changes’.
If you created your products using the Product Upload method, you may create product options for them, as well. You must create your product options for each product using the explanation above in this section. Product options are NOT created in the CVS Template.
Associating Product Options With Your Products
To associate or dissociate product options, you must do this from the ‘edit product’ page. This page is found by going to your products list and clicking on an ‘Edit’ link. The ‘Edit’ link you click should be that of whichever product you want to add options to. At the bottom of the ‘edit product’ page, you will see a list of all available options you created. This list appears in the form of a table, with labeled headings. There are four headings:
1. ‘Available’: The options associated (available) with the particular product you are editing will have a check in the box under the ‘Available’ heading. If the box is not checked, that set of options is not available for (associated with) that product. Warning Product Option Association To associate or dissociate a set of options, simply check or uncheck the corresponding
box, as needed.
2. ‘Option’: This denotes the name of the product option.
3. ‘Values’: This displays the values for each option.
4. ‘Surcharge’: This displays the extra charges you may charge to customers for choosing a given product option.
When finished, click the ‘Save Changes’ button at the bottom of the page. This will save your changes.
+0
-0
How do I set up a new recurring product?
December 30th, 2006, by: knowledgebaseTo create a new recurring product in our system, you’ll need to first add the item to our database. The steps below should be followed in the order they are given to ensure problem-free results.
1. Login to your account.
2. Click ‘Set up Products’ on the main page.
3. Click ‘New Recurring Product’ in the upper right hand corner of the screen.
4. You will see a screen with several fields. Any field with an ‘*’ is required and must be completed. All others are optional. Below a description of each field follows.
Your Product ID (Required) – This is an internal reference number for your use. A part number, bin location or other reference that will be useful to you. This field can consist of only letters and numbers with no spaces or special characters.
Name (Required) – This is the name or title of your product. Keep this as short as possible (no more than 30 characters) or it can cause the payment page to become distorted.
Description – This is what your product is. We recommend you keep this short as well to keep the payment page from becoming distorted.
Price (Required) – This is how much the customer will be charged each payment cycle. Do not include any currency symbols (like ‘$’) in this field or errors will result.
Start Up Fee – This is a one time fee billed together with the first installment. This amount will be billed only once, not on a recurring basis.
Weight – If you plan to use our shipping systems and will ship by weight, specify the weight here.
Handling – If there are any product-specific handling charges, they go here. These charges are above and beyond your normal shipping charges, and are only applied if this product is purchased, they are applied for each product ordered, i.e. if 3 of this product are ordered, the customer will be charged 3 times this amount. Do not use currency signs (like ‘$’) and do not use commas. Prices can be specified in whole numbers or as decimals to 2 places (example: 4.95).
Tangible (Required) – This indicates whether or not your product is tangible. Tangible goods must be shipped in a timely manner in order for you to receive payment. Tangible goods are also subject to sales tax for Ohio customers. This field must be set correctly, if 2Checkout becomes aware you have deliberately lied about whether or not a good is tangible, your account will be suspended, and further penalties may apply. Note that if you set this field to intangible, the customer will not be charged for shipping and the option to select shipping methods will not be shown on the order page.
Pending URL – The Pending URL field is no longer used and may be left blank as 2Checkout no longer accepts e-checks as a payment method.
Approved URL – This is the URL your customer will be returned to when the payment has been confirmed. Most credit card orders will be sent here.
Recurrence (Required) – This is a two-part field. The first part is a numerical field that tells us how long between billings as a number. The second box tells us the unit of time measurement, current options are; weeks, months and years. So, if you want a customer to be billed once every month, you would put in a ‘1′ in the first box, and then select ‘months’ from the second drop-down box. Note that we no longer support daily recurring billing.
Duration (Required) – Like the last setting, this is a two-part field. The first part is a numerical field that tells us how long to continue billing as a number. The second box tells us what unit of time you are referring to. If you put in ‘6′ and then selected ‘months’ from the second drop down, your charge would automatically cease billing after 6 months. If you want to bill the customer until they or you cancel, leave the first box blank and select ‘Forever’ from the second box.
5. Once you have configured the product to your satisfaction, press ‘Create Recurring Product’ to save the product to the database.
Note: For help setting up a single-bill product, please see below.
—-Related Articles—-
+0
-0
How do I set up a new product?
December 30th, 2006, by: knowledgebaseTo create a new product in our system, you’ll need to first add the item to our database. The steps below should be followed in the order they are given to ensure problem-free results.
1. Login to your account.
2. Click ‘Set up Products’ on the main page.
3. Click ‘New Product’ in the upper right hand corner of the screen.
4. You will see a screen with several fields. Any field with an ‘*’ is required and must be completed. All others are optional. Below a description of each field follows.
Your Product ID (Required) – This is an internal reference number for your use. A part number, bin location or other reference that will be useful to you. This field can consist of only letters and numbers with no spaces or special characters.
Name (Required) – This is the name or title of your product. Keep this as short as possible (no more than 30 characters) as it can cause the payment page to become distorted.
Description – This is what your product is. We recommend you keep this short as well to keep the payment page from becoming distorted.
Price (Required) – This is how much the customer will be charged each payment cycle. Do not include any currency symbols (like ‘$’) in this field or errors will result.
Weight – If you plan to use our shipping systems and will ship by weight, specify the weight here.
Handling – If there are any product-specific handling charges, they go here. These charges are above and beyond your normal shipping charges, and are only applied if this product is purchased, they are applied for each product ordered, i.e. if 3 of this product are ordered, the customer will be charged 3 times this amount. Do not use currency signs (like ‘$’) and do not use commas. Prices can be specified in whole numbers or as decimals to 2 places (example: 4.95).
Tangible (Required) – This indicates whether or not your product is tangible. Tangible goods must be shipped in a timely manner in order for you to receive payment. Tangible goods are also subject to sales tax for Ohio customers. This field must be set correctly, if 2Checkout becomes aware you have deliberately lied about whether or not a good is tangible, your account will be suspended, and further penalties may apply. Note that if you set this field to intangible, the customer will not be charged for shipping and the option to select shipping methods will not be shown on the order page.
Pending URL – The Pending URL field is no longer used and may be left blank as 2Checkout no longer accepts e-checks as a payment method.
Approved URL – This is the URL your customer will be returned to when the payment has been confirmed. Most credit card orders will be sent here.
5. Once you have configured the product to your satisfaction, press ‘Create Product’ to save the product to the database.
Note: For help creating recurring products (products where the customer is automatically re-billed a set amount after a certain amount of time has elapsed) please see the tutorials linked below.
—-Related Articles—-
+0
-0
What are ‘product options’?
December 30th, 2006, by: knowledgebaseProduct options are variable selections of certain products offered to customers.
For instance, a customer wants to buy an extra-large, red sweater from a clothing business. That sweater has two product options associated with it: size and color.
Two product options would be created in this example. One would govern all the different sizes offered, the other would govern the different colors. 2CO has a method which allows you to set up options like these.
The number of options you can have for a product is unlimited.
Related Article: New Vendor Admin: Product Options
+0
-0
How do I upload a CSV file of my products?
December 30th, 2006, by: knowledgebaseYou are able to upload a CSV file with your product information to our Version 2 database. Your CSV file must be in a specific format and all lines must be correct in order for the upload to be successful. If there is an error with the upload, our system will give you an error message stating which lines do not follow the proper format.
To upload a CSV file with your products, you will need to click on option 4 (set up products) from your account homepage. Next you will want to select the “Upload New Products” link located in the upper right corner of your computer screen. Simply browse your computer for the correct CSV file and select the upload button.
If you have any troubles with the upload, please use the following links to troubleshoot and set up your CSV file.
Here is a template:
https://www.2checkout.com/downloads/product_upload_template.csv
Here are instructions that explain the format:
https://www.2checkout.com/2co/admin/product_upload?instruct=1
+0
-0
What Authorize.net parameters does 2CO support?
December 30th, 2006, by: knowledgebaseBelow you will find a listing of the supported Authorize.net-compatible parameters and what information each parameter should contain. This parameter set is used by third party carts and custom designed scripts. Please note that 2Checkout must know what is being sold in every sale. There are parameters available that allow for dynamic product creation. These will be discussed as well, and must be used if you are using this parameter set, but they are not Authorize.Net specific. If you would like to test your integration of these parameters, try using our developers.2Checkout area.
Multi-page Payment Routine:
https://www.2checkout.com/checkout/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:
x_login – Your numerical 2checkout vendor account number.
x_amount – The total amount to be billed, without a currency symbol, and only two decimal places if used (8 characters, decimal, 2 characters: Example: 99999999.99)
x_invoice_num – A unique order id from your system. (64 characters max)
Product Identification Parameters:
Suppliers using this parameter set must pass in parameters to identify what is being sold during the purchase. These parameters will also benefit suppliers as when used correctly the product information will be displayed to customers on the purchase pages and will be listed on the suppliers 2Checkout.com sale detail page.
id_type – Due to changes in with the Product Identification parameters this parameter should be passed in once during the purchase and will need to have its value set to 1.
c_prod – The ID of the product that is being purchased. The quantity of product being purchased can passed with this parameter by placing a comma after the ID and then the quantity in numeric format.
c_name – The value of this parameter should contain the name of the product to be created. (128 characters max)
c_description – The value of this parameter should contain a short description of the product to be sold. (255 characters max)
c_price – The price of your product. Please note that in order to prevent a discrepancy between the total parameter and the sum of the product identification c_price parameters which may confuse the customer, the product price will not be displayed on the purchase page. (8 characters, decimal, 2 characters: Example: 99999999.99)
You can use these identification parameters to pass in multiple products as well. To do so you will need to append a digit to each parameter. For example, c_prod_1, c_name_1, c_description_1, c_price_1 will describe the first product, then to describe the second product you would use a 2 so the parameters will read c_prod_2, c_name_2 and so on.
Additional Parameters:
demo – Y to enable demo mode. Do not pass this in for live sales. Can also be controlled within the account.
lang – Chinese – zh, Danish – da, Dutch – nl, French – fr, German – gr, Greek – el, Italian – it, Japanese – jp, Norwegian – no, Portuguese – pt, Slovenian – sl, Spanish – es_ib, Spanish – es_la, Swedish – sv, defaults to English if this is absent, but en may be used for English as well.
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, AL for Acculynk PIN-debit, PPI for PayPal, or PPL for PayPal Pay Later. 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.
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. This parameter will over-ride any URL set on the Look and Feel page. (no limit)
To populate the billing information page you may pass in:
x_First_Name – buyers first name (64 characters max)
x_Last_Name – buyers last name (64 characters max)
x_Phone – buyers phone number (16 characters max)
x_Email - buyers email address (64 characters max)
x_Address – buyers address (64 characters max)
x_City – buyers city (64 characters max)
x_State – buyers state (64 characters max)
x_Zip – buyers zip code (16 characters max)
x_Country – buyers country (64 characters max)
To populate the shipping information page you may pass in:
x_Ship_To_First_Name
x_Ship_To_Last_Name
x_Ship_To_Address
x_Ship_To_City
x_Ship_To_Country
x_Ship_To_State
x_Ship_To_Zip
Please note that since this parameter set is for third party shopping carts, we do not collect shipping information for these types of orders. This is because your cart is responsible for calculating the shipping and it is passed in as part of the x_amount parameter.
It is also important to note that when using the Authorize.Net set of parameters, 2CO only requires the three listed under the required section. We will therefore not passback strictly Authorize.Net style parameters for everything unless they are passed in to us. This is not often a problem as most carts do this anyways. For example, x_First_Name and x_Last_Name will prepopulate the billing name, but 2CO uses card_holder_name for this. card_holder_name will then be returned unless x_First_Name and x_Last_Name are passed into 2Checkout.
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.
Return Parameters:
You can receive back all of the parameters that were passed in as well as the following parameters:
x_2checked – Y if card was successfully processed.
x_MD5_Hash – The MD5 hash that can be used to verify that the sale came from a 2CO server.
x_trans_id – the 2CO order number for the order.
Using this parameter set, we are not receiving any product information. As you can see, you are only passing in a total amount to us. Usually, the cart will have some means of using the x_invoice_num to determine what was purchased after the sale. A return URL will need to be set up on the Look and Feel page for the cart to correctly determine this.
Consult the documentation that came with your cart or contact the cart manufacturer for assistance with setting this up or to determine what URL you should enter on the Look and Feel page for your cart to receive the product information.
Recurring billing can not be done with this parameter set. You must use the Plug-N-Play parameter set and have the products defined within the 2CO database for recurring billing.
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
