Test your Checkout integration

The first step in testing Checkout is ensuring that when international shoppers attempt to place an order on your site, Checkout correctly shows up instead of your domestic checkout. To test this:

1. Go to Dashboard -> Settings.
2. Under the Checkou section, select Settings.
3. Locate the Store URL field on the settings page. Ensure that it correctly matches your online storefront's URL.
4. Next to the Store URL field, click View as shopper.
5. In the dialog that opens up, select which country you want to view as a shopper from, then click Preview. This will take you to your online store in a new tab and instruct Hello and Checkout to pretend you are a shopper from the specified country.
6. Add one or more items to your cart. Try to add enough items that the total value of your cart exceeds the de minimis value for the country you are testing.
7. Once you are satisfied with the items in your cart, visit your cart page and click the button to checkout with your items.
8. If Checkout and Hello are correctly configured, instead of seeing your domestic checkout, a window will open with your international checkout.
9. Keep the Checkout window open as you will continue to use it for the rest of your testing.

If these steps succeed, your integration works, and international shoppers can see Checkout when they place an order.

If Checkout and Hello don't treat you as an international shopper after following these steps, there is likely an issue with your plugin settings or with your JavaScript integration, depending on how you set up Checkout. See our troubleshooting guide for next steps.

Once you are sure that Checkout properly triggers for international shoppers, the next step is to verify that the information that your integration is sending about your shopper's cart to Checkout is being properly sent over. To do this:

1. In the Checkout window you have open on your site, look on the right-hand side in the Cart section.
2. Verify that the item(s) you added to your cart match what Checkout is displaying.
3. If applicable — verify that the amounts of each item you added match with what Checkout is displaying.
4. Verify that item details, such as the item name, price, description, image, etc. are, correctly matching with your site.

If all the cart information matches what you expect based on what you added to your test cart, your Checkout integration collects cart details properly.

If there is a mismatch or some pieces of information are not displaying, there is likely an issue with your plugin settings or your JavaScript integration, depending on how you set up Checkout. See our troubleshooting guide for next steps.

Next, you will want to verify that shipment rating is properly calculated for your test order. To do this:

1. In the Checkout window that you have open on your site, enter contact info and address as requested.
2. Click Next. You will be taken to the shipping option selection screen of Checkout.
3. You should see shipping options show up that match what you have set up in Dashboard.
4. Verify that the shipping options displayed, their display names, and their prices are what you expect.
5. Select one of the shipping options. This will be used for the next step of the testing.
6. You should see the order totals update on the right-hand side of the Checkout window to reflect your selected shipping option.

If shipping options show up as expected and match what you've set up in Dashboard, it means Checkout was properly able to get a shipment rating based on the address you entered.

If shipping options don't show up at all or do show up but are incorrect, there is likely an issue with the way you configured shipment rating in Dashboard. See our troubleshooting guide for next steps.

Once you've selected a shipping option, Checkout can calculate an accurate total landed cost quote with duties, taxes, and fees. You should see the order totals on the right-hand side of the Checkout window automatically update to reflect the proper duties, taxes, and (if applicable) and associated fees.

If you select a shipping option and no duties, taxes, or fees appear there is likely an issue with your landed cost configuration in Dashboard. See our troubleshooting guide for next steps.

If duties and taxes appear but have a 0.00 value (in whichever currency you are shopping in), it's possible that the item(s) you added to your cart don't add up to exceed the de minmis values for your selected testing country. If that's the case, Checkout and Hello should have already notified you visually that duties and taxes are not due on this order due to its lower value. If that is what you expect, then no action is needed. If you want to see a test with duties and taxes, in this situation you will need to go back and adjust your cart items quantity or add more expensive items to push the cart value above the de minimis value for your selected country.

If duties and taxes appear but are incorrect, there is likely an issue with your landed cost configuration in Dashboard. See our troubleshooting guide for next steps.

1. In the Checkout window that you have open on your site, click Next.
2. You will be taken to the payment section of Checkout.
3. Verify that all desired payment methods show up as selectable.

If the payment methods you see match what you have set up in Dashboard, it means Checkout is working properly.

If the payment methods you see don't match what you have set up in Dashboard, its possible that there is a configuration issue. See our troubleshooting guide for next steps.

Finally, place a test order to make sure that your payment methods work as intended, the order syncs properly, and any shopper notification emails work properly.

To place a test order, use the credit card field and enter one of our test cards, then click Place order.