Use Preview Mode to test your Blackcart Try Before You Buy integration
What Is Preview Mode?
Preview Mode allows you to test your Blackcart Try Before You Buy (TBYB) integration before going live.
Use Cases:
- View the user experience end-to-end before you go live — shopping, checkout, emails, and returns experience
- Verify that Try Before You Buy (TBYB) elements are functioning, placed, and styled according to your guidelines
- Train your Customer Service team — understand what orders look like in the Merchant Portal, and in Shopify, throughout an order's life-cycle
- Preview changes to your (published or unpublished) storefront before activating Blackcart.
- Enable stakeholders who don’t have access to the merchant portal to preview the customer experience before launching live.
What does Preview Mode not test?
- Stripe integration
- EasyPost integration
- Shopify returns integration
Getting Started - How to use Preview Mode
Launching Preview Mode
- To enter Preview Mode, you will need to first log into your merchant portal.
- Once logged in, proceed to the Preview Mode section found on the left Navigation Bar.
- Here on the Preview Mode page, use the drop-down menu to select the theme you would like to preview.
- If the theme you select does not have a valid Blackcart integration, you will see an error. Check you have chosen the correct theme, and that the Blackcart SDK Javascript is being loaded correctly.
- Once you have selected the correct theme, you will have the ability to launch Preview Mode, or copy the link and share it with colleagues.
- Links are valid for up to seven days at which point they will expire and will require a new link.
- Click the Launch Preview button to be directed to your storefront in Preview Mode: where you’ll be able to start reviewing the customer experience.
Note: All orders placed while in Preview Mode will be marked as test orders and no real payment will be accepted.
Storefront
When in Preview Mode your storefront should be the same as if you were previewing via Shopify, except for the toolbar found at the bottom of the window.
This toolbar will allow you to exit out of Preview Mode, as well as provide you with extra information depending on the current state of the order.
- Proceed to the product page of any item enabled for TBYB. Here you should be able to view the new TBYB CTA found on this page, and interact with it.
- To learn more about enabling products for TBYB, visit this article.
- Click the TBYB CTA to add the item to your cart.
- Check your cart drawer (if available) and your cart page (if available) to ensure that the item is showing up labeled as Try Before You Buy and that all other cart elements such as item price, item total, and cart subtotals are showing up correctly here as well.
- Add as many other items to your cart as desired, and when you are ready to test checkout, select the checkout button on your cart. You should then be directed to the Blackcart Checkout.
Blackcart Checkout
The Blackcart Checkout in Preview Mode showcases what the customer will experience when finalizing their order with their TBYB products.
- From the first page of checkout, enter a valid phone number, email address, and shipping address in order to proceed further.
- You will be required to verify your phone number via SMS
- After verification, you'll be directed to the second checkout page where you will enter payment information.
Preview Mode only allows the use of test cards to complete transactions — using a real credit card will not charge the card and result in a checkout failure. Refer to the Preview Mode toolbar which will provide you with three different payment card numbers. These card numbers will prompt the three possible scenarios for customers when ordering their TBYB items.
- Successful Card - Payment is successful, the customer will be redirected to the confirmation page
- Invalid Card - Customer entered an invalid card (postal code mismatch)
- Fraud Failure - Customer payment was flagged for Fraud and will be given the option to pay through the conventional checkout.
To complete your order:
- Enter the credit card number:
- Choose which card to use from the Preview Mode toolbar, and click to Copy the card number to your clipboard
- Paste the card number in the Card Number field
- Expiration Date: Enter any future date
- Name: Enter any name
- CVV/CVC: Enter any three-digit number
- Click the Place Order button
Depending on which card you used, you will either proceed to the Order Confirmation page, see an invalid card error message, or be redirected to the fraud rejection notification.
Order Confirmation
- After a successful transaction, the customer will be directed to the checkout confirmation page.
- From here, you can use the Preview Mode toolbar to take you directly to the Customer Portal to preview the keep and/or returns experience.
- You will also receive an email notification from no-reply@blackcart.com with the following subject line “Your {merchant store name} order {order no} confirmation!”
- The order will also be placed in your Shopify Order Admin as well as in the Blackcart Merchant Portal with a "Test Order" moniker to help identify what is a test order.
- Also note the same Order Number found in your Shopify Admin. If you have an automated 3Pl, you may need to intervene as the order in Shopify will be marked as paid at some point.
Note: Test Orders will be entered into Shopify with a test payment method, marking them as a test order. Items will be marked as fulfilled automatically. Please ensure that any third-party fulfillment services are set up to ignore test orders or orders which are already marked as fulfilled to avoid unintentionally fulfilling test orders.
Fraud Rejection
When using the “Fraud Failure” test credit card, you will be redirected to the Blackcart rejection notice. From there you may continue on to place the same order via the standard Shopify checkout.
Customer Portal
The Customer Portal is also accessible within Preview Mode and will be able to show you the different states an order could be in during the order journey.
- You can access the Customer Portal through the link included in your order confirmation email or access the customer portal link within the order details page in the Merchant Portal.
- The Preview Mode toolbar will be visible in the Customer Portal and will enable you to move the order through the full TBYB lifecycle.
- When you have reviewed the Customer Portal proceed to select the action found on the toolbar to move the order status.
- For more information on different order statuses, click here.
- This action will trigger the email associated with the order status. The order status in the Merchant Portal should also update accordingly.
- For more information on different transactional emails that will be sent through preview mode, click here.
- Continue on through the various statuses to trigger the respective emails associated with the order status.
- Note that you cannot move orders backward, only forwards, for example: You cannot move an order in Trial In Progress status back to Processing.
When you are done viewing the customer experience through Preview Mode select the Exit icon found on the toolbar to exit.