Knowledge Base » Suppliers » Tech Support »

Do you have an API that we can use to integrate 2checkout into our custom billing application?

An API (Application Programming Interface) is used in many different contexts in this industry. 2Checkout offers a full featured Back Office API that provides suppliers and 3rd party developers with the ability to automate account, product and order management processes. Using the 2Checkout Back Office API along with the Instant Notification Service (INS) alleviates the necessity of logging into the standard GUI account interface on a day-to-day basis.

The current supported methods offered by our API allow the user to retrieve:

  • Detailed account information including both company and contact information.
  • Detailed payment information for both pending and past payments.
  • Detailed product information including product options and coupons.
  • Detailed sales information supporting both simple and complex search queries.

The current supported update calls allow the user to:

  • Create, edit and delete products, product options and coupons.
  • Refund sales by both invoice and individual line item.
  • Stop recurring line items.
  • Reauthorize and mark sales as shipped.
  • Add order comments and send comments to the customer.

If you are interested, please review our Back Office API documentation for a full specification on each supported method and instructions on how to create an API username.

For site integration with 2Checkout, we offer a Common Gateway Interface (CGI). This means a site will need to contain an HTML form or link with cgi parameters appended which passes the correct parameters (and the customer) to our site for checkout. Passing in the Proper Parameters will result in the customer going through the rest of our checkout process (such as entering their credit card information), and after verification, a successful sale.

A site/shopping cart can pass orders into our purchase routine by using one of our supported parameter sets listed below.

When using a third party cart parameter set you will need to make sure that you implement the Product Identification parameters listed in the articles above.

If you would like to test your integration of these parameter sets, please try using the testing tools available in our developers area.

This article was updated January 27, 2010 to include the new Back Office API information.

Why are the shipping charges I set up in the Admin not being added to the form when using my 3rd Party Cart?

If you are using a 3rd party cart, all shipping charges should be handled in the cart prior to getting to our payment form. The shipping features in the Admin are for our Plug N Play carts and links.

Can I use 2CO w/ a Yahoo Store?

As far as we know, you cannot use our services with a Yahoo! store because of the way they have chosen to set up their payment processing gateway. We are not compatible with their gateway services at this point in time.

You may be able to find a 3rd Party Shopping Cart that can meet your needs.
http://www.2checkout.com/community/blog/category/knowledge-base/tech-support/3rd-party-carts/recommended-carts/

What carts are 2CO compatible with?

A third party shopping cart is not necessary in order to use our service. We provide you with the option of using our easy-to-use Plug-N-Play shopping cart. Our PNP shopping cart uses simple HTML links, so you do not need to install extra software.

However, if you wish to use a third party shopping cart with our service, you may do so. The 2Checkout service generally is compatible with the following third party shopping carts:

  • Any cart listed in our Recommended Cart section.
  • Any shopping cart compatible with the Authorize.net parameter set, provided that it allows you to change the gateway URL. Nearly all shopping carts today support the Authorize.net standard.
  • Any shopping cart that advertises 2Checkout support on their Web site should work with our service.
  • Miscellaneous shopping carts. If your shopping cart does not fit either of the above criteria, or if it is simply in question, there is a way to determine whether or not your cart supports our service. Simply check with the manufacturer of the shopping cart to confirm it’s compatibility. You can contact the maker personally, go to their Web site, or read any documentation that may have been provided with the cart, itself.

TECHNICAL SUPPORT

2Checkout cannot provide technical support for questions regarding third party shopping carts. Basically, we did not develop them, so, therefore, we do not have any working knowledge of their inner mechanisms. Questions about configuration and/or setup should be directed towards the maker of the cart. However, we can provide technical support for questions or information needed to set up the shopping cart to work with our service.

You may find additional help regarding third party shopping carts from other vendors of ours by going to our Community, located at: http://www.2checkout.com/community/public/

Using frames with 2Checkout

Due to current credit card regulations, 2Checkout is no longer able to allow the purchase routine to be loaded with in a frame set. By loading our site in a frame, the customer would remain on the suppliers server while navigating though out purchase routine. Because 2Checkout is an authorized reseller and not a payment gateway or payment processor it is required that customers are aware that they are ordering from us at the time of purchase. To correct this the 2CheckOut transaction pages will break out of a frame set if they are loaded inside of one. Attempting to load the 2CheckOut transaction pages within a frame set will prevent them from working as intended and will generate a parameter error. If your site uses frames you may still integrate with 2Checkout by using target=”_blank” to load the 2Checkout purchase routine in a new window.

Example of an HTML form loading in a new window.

<form action='https://www.2checkout.com/checkout/purchase' target='_blank'
method='post'>
<input type='hidden' name='sid' value='123456' >
<input type='hidden' name='product_id' value='101' >
<input type='hidden' name='quantity' value='1' >
<input name='submit' type='submit' value='Buy from 2CO' >
</form>

Example of a purchase link loading in a new window.

<a href="https://www.2checkout.com/checkout/purchase?sid=123456&quantity=1
&product_id=101" mce_href="https://www.2checkout.com/checkout/purchase?sid=123456&
quantity=1&product_id=101" target='_blank'> Test Product </a>

Why are the products from a previous sale still in the cart when I came back to place another order?

The reason for the products to not be removed from the cart from previous purchase is because you have tested a demo sale more than once without actually completing the sale. This means the product was “cookied” into the cart. The cart will remember items you put in the cart, and will only clear out by either a live purchase, or by putting a zero in and saving changes. This should not happen for a new buyer, or a buyer who completed a sale previously.

Why do I get a parameter error when adding multiple buy buttons on the same page?

Each button added to the page needs to have its own opening and closing form field. This tells the browser that each form is separate, and not part of the same one.

The following correct example generated two separate buy buttons:

<form action="https://www.2checkout.com/checkout/purchase" method="post">
<input type="hidden" name="sid" value="XXXXXX" />
<input type="hidden" name="product_id" value="10" />
<input type="text" name="quantity" size="5" value="1" />
<input type="submit" name="submit" value="Buy from 2CO" />
</form><form action="https://www.2checkout.com/checkout/purchase" method="post">
<input type="hidden" name="sid" value="XXXXXX" />
<input type="hidden" name="product_id" value="10" />
<input type="text" name="quantity" size="5" value="1" />
<input type="submit" name="submit" value="Buy from 2CO" />
</form>

** Notice that there are two opening tags ( <form> ) and two closing tags ( </form> ).

Another possibility, if you are using an HTML editor, is the editor may be adding extra numbers to the parameters, thinking each identical one is part of the same form, and not a separate form. Look at the parameters in the forms, and make sure there are not extra numbers added to it.
Incorrect Example:

<form action="https://www.2checkout.com/checkout/purchase" method="post">
<input type="hidden" name="sid1" value="XXXXXX" />
<input type="hidden" name="product_id" value="10" />
<input type="text" name="quantity" size="5" value="1" />
<input type="submit" name="submit" value="Buy from 2CO" />
</form>

** Notice that the in second line from the name=”sid1″, this should always be name=”sid”

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.

Receiving parameter error message from HTML code on web page, what could cause this?

Please be sure you are calling the products using OUR product_id number, not the one you added to the product. This is most likely the problem you are having. If this is not the issue, then submit a Help Desk Ticket below and give us a link so we can do a test purchase on your cart. If possible, include the purchase link or form you are using to send the parameters to our system.

You can open a support ticket here

Can I Integrate Your Plug n’ Play Cart into a Macromedia Flash-based website?

Yes.

Because our Plug n’ Play cart functions through the use of standard HTML forms, you can use the PNP cart in any website creation utility that supports HTML forms, including Macromedia’s Flash product.

When placing a test order, I add items to my cart, close my browser and then come back, but the items are still there. Why?

The 2Checkout purchase routine sets a cookie on the user’s computer when they begin a purchase. This cookie remembers what the customer had placed into their cart. This way, if the customer loses their Internet connection or is otherwise unable to complete their order, they are not forced the entire checkout process over when they come back to finish their order.

Because you are using the same computer, you may see items in the cart from the previous order. Your customers will not see this because they are using different computers and Customer #2’s computer will not have the cookie set by Customer #1’s computer.

Page 17 of 20« First...«1516171819»...Last »

Recent Posts from the Community:

Not answer

posted by: zeroscripts

No emails

posted by: tools
More from the community »

Spotlight Supplier

Spotlight Supplier

Premium Web Hosting

Spotlight Shopping Cart

Spotlight Shopping Cart

VPASP Shopping Cart


Popular Tags

2Checkout.com account admin affiliate API approved url ASP Carts Banking Wizard beta business cart chargeback charity compliance consumer fraud contact coupon credit card csv currency demo demo shop direct return dispute Downloadable Products Duct Tape Marketing E-Commerce ecommerce email error exchange rate features Fees Fraud fraud protection help holiday HTML images INS integration international International Fraud Awarness Week internet sales invoice languages logo Marketing mark shipping MasterCard MD5 hash multiple online sales Operating Regulations order parameters partners passback payment payments payoneer PayPal PCI PHP Carts plug and play policies policy product products prohibited purchase purchase routine recurring reference refund release level Remote Hosted Carts resources restricted return return url risk sale sales script Security services setup Shipping signup social networks software Spotlight Supplier Agreement third party cart third party carts tutorial update updates vendor admin