Skip to main content
knowledgecenter.2checkout.com

Test ordering system

Overview

Enable the 2Checkout test ordering system to place test orders via the 2Checkout Control Panel or through the 2Checkout API.

We strongly advise you to prepare your system to integrate with the new testing platform. This is especially important for

  • IPN (Instant Payment Notifications)
  • LCN (License Change Notifications)
  • ISE (Instant Search Orders Export)
  • Electronic delivery

Availability

The test order system is available to all 2Checkout accounts.

Requirements

The new 2Checkout order testing system is enabled by default. However, if switched off for your account, follow these instructions to enable it:

  1. Go to Setup -> Ordering options.
  2. Scroll down to the bottom of the page and check the checkbox for the Enable the test order system option.
  3. Save the settings.

What happens if I disable the test system?

  • You will no longer be able to place new test orders via the Control Panel or through the 2Checkout API.
  • The 2Checkout system will continue auto-renew any recurring test subscriptions per their billing cycle setting and also convert test trials placed while the order testing system was active.
  • You will be able to continue managing test orders and subscriptions generated while the testing system was active, including operations such as manual renewals and upgrades.

How do I place a test order using the Control Panel?

You can place 5 types of test orders:

  1. New acquisition
  2. Trial
  3. Automatic renewal/trial conversion
  4. Manual renewal
  5. Upgrade

To kick start the testing process, you first need to generate a test Buy-Link. Using test Buy Links you can replicate the new acquisitions and trial purchase scenarios. Automatic renewalstrial conversionsmanual renewals, and upgrades require that you placed an initial test order and that the 2Checkout system generated a subscription for the test purchase.

How do I generate a test Buy-Link?

  1. Log in to your Merchant Control Panel and navigate to Setup -> Generate links -> Checkout Links.
  2. Choose a purchase flow from the available list.
  3. Select one or more products.
  4. Optional: you can control a collection of advanced options, but none are required to place test orders.
  5. Click on Generate link.
  6. Click on Place a test order. Alternatively, you can also copy the link generated and paste it in your browser's address bar.

Add the DOTEST parameter manually to Buy-Links

You can add the DOTEST parameter manually to Buy Links and use the result to place test orders. For example,

Buy link: https://secure.2checkout.com/order/checkout.php?PRODS=4551041&QTY=1
Test buy link: https://secure.2checkout.com/order/checkout.php?PRODS=4551041&QTY=1&DOTEST=1

DOTEST=1

Optional

Use DOTEST=1 to place orders in a test environment. You need to enter the dummy credit card details for the specific scenario that you're testing.

DOTEST in Buy Links works only if the you enabled the testing system for your account. Otherwise, it has no impact whatsoever.

Cross-selling and Network cross-selling

  1. You can test cross-selling campaigns as long as you enabled the test system.
  2. For network cross-selling test orders to function:
    • You are required to enable the test system.
    • Vendors whose products are part of the network cross-selling campaign also need to have the new testing system enabled.

Lead management

Lead management campaigns are not supported for test orders at this point in time.

Imported subscriptions

The 2Checkout testing system does not support imported subscriptions at this point in time.

myOrder JS object

Test orders are marked accordingly in the myOrder JavaScript object included in the last stage of the purchase process.

testOrder

Boolean

True for test orders, False otherwise.

omniture_vars

Test orders are marked accordingly in the omniture_vars object available for the desktop and mobile versions of the shopping cart.

TEST_ORDER

Boolean

True for test orders, False otherwise.

Upselling

You can test upselling campaigns as long as you enabled the test system.

Promotions

You can use all the promotional capabilities of the 2Checkout platform with test orders.

Retry logic

This functionality is not supported.

Account updater

This functionality is not supported.

Refund a test order

Test orders support total and partial refunds.

Order search

To include or exclude test order data from the order search reports:

  1. Go to Orders & customers -> Order search.
  2. Use the Test orders filter.
    • Include test orders
    • Do not include test orders
    • Show only test orders

Note: Test orders are included in this report by default, but you have the option of excluding these items from the order search results and the export reports or to search test orders exclusively.

Subscriptions

Subscriptions generated for test orders are accompanied by the Test label. To include or exclude test subscription data from subscription search:

  1. Go to Orders & customers -> Subscription management.
  2. Optional: Click on More search filters.
  3. Use the Test subscription filter.
    • Include test orders
    • Do not include test orders
    • Show only test orders

Customers

Customer accounts generated for test orders behave just like those created for real orders. The 2Checkout system can associate both real and test orders/subscriptions with customer accounts.

Invoices

The 2Checkout system does not generate invoices for test orders.

Channel Manager (Partner) test orders

This functionality is not supported at this point in time.

Affiliate test orders

2Checkout affiliates that have joined your program can place test orders using your products only if you enable the test system.

  • Test cards. Affiliates can use the same dummy credit/debit cards on the established list.
  • Affiliate reports. Affiliates can see test orders only in their Orders report. 2Checkout does not include test orders in all other affiliate reports.
  • Affiliate JS myOrder object. The Affiliate JavaScript myOrder object includes test orders.

FAQ

  1. What happens if I disable the test system?
    • You will no longer be able to place new test orders via the 2Checkout Control Panel or through the 2Checkout API.
    • The 2Checkout system will continue auto-renew any recurring test subscriptions per their billing cycle setting and also convert test trials placed while the order testing system was active.
    • You will be able to continue managing test orders and subscriptions generated while the testing system was active, including operations such as manual renewals and upgrades.
  2. Can I renew/convert a trial manually?
    • 2Checkout converts trials automatically, unless automatic billing (auto-renewal) is disabled either in the order details page or in myAccount. To convert a trial on-demand to a paid subscription, use the 2Checkout APINote: You cannot convert trials by placing manual renewal orders using the shopping cart.
  3. Can I request a refund for a test order?
    • Yes. You can use either the order details page in the 2Checkout Control Panel, IRN (Instant Refund Notification), or myAccount to request refunds for one or multiple orders.
  4. What payment methods are supported by the test ordering system?
    • We're working to add support for additional payment methods, but currently, the test order system supports only credit cards.
  5. Are test orders synchronized in Salesforce?
    • This functionality is not supported at this point in time.
  6. Is backup media delivered for test orders?
    • No. The 2Checkout system does not deliver backup media for test orders.
  7. Subscription billing charges alignment via myAccount
    • 2Checkout myAccount offers billing charges alignment (or co-termination) capabilities to customers owning two or more active subscriptions for different products acquired from you, with unsynchronized expiration/renewal dates. The co-termination process enables the proration of subscriptions, setting a single renewal date for multiple items. The 2Checkout system will renew subscriptions with aligned billing cycles (sharing the same co-termination date) as part of a single order. As a direct result, following the renewal process, 2Checkout issues a single invoice to customers. You cannot align a test subscription with a real subscription using 2Checkout myAccount billing charges alignment capabilities. However, you can align the billing charges of 2 test subscriptions that meet the necessary requirements. 
  8. What happens if I use a real card for a test order?
    • The 2Checkout system will only accept dummy cards for test orders. The dummy payment gateway which processes authorizations for test orders will reject any cards that are not on the established list.
  9. What happens when I try to update the card associated with a test subscription in the 2Checkout Control Panel or in myAccount using a real card?
    • The 2Checkout system will only accept dummy cards for test orders. The dummy payment gateway which processes authorizations for test orders will reject any cards that are not on the established list.
  10. Can I place a test manual renewal or a test upgrade order for a 'real' subscription?
    • No. Test manual renewals and test upgrades can be performed exclusively on test subscriptions.
  11. Are test customer accounts created for test orders/subscriptions?
    • No. All customer accounts generated by the 2Checkout system are 'real' accounts.
  12. Do tokenized payment links work for test orders?
    • Yes. This functionality is supported. 
  • Was this article helpful?