Cart and Checkout
Review how Taintless handles basket UI, Tebex checkout, authentication, discounts, and final payment handoff.
Taintless owns the storefront experience before checkout. Tebex owns the final checkout.
That distinction matters. Taintless can make browsing, cart review, product presentation, and checkout handoff feel polished. Tebex remains the source of truth for final totals, taxes, authentication, payment, receipts, and delivery.
Checkout source of truth
The final amount a customer pays is the amount shown by Tebex checkout. Storefront pricing can be localized for presentation, but Tebex controls the final basket.
Media placeholder
Buyer checkout path
Recommended asset: a short video from product detail to cart review to Tebex checkout.
How The Basket Works
A basket is created when the customer takes an action that needs one, such as adding a product or starting a Tebex login flow. Until then, the customer can browse without a basket.
In preview mode, Taintless uses a preview-safe basket so merchants can test layout and interactions without creating real Tebex checkout traffic.
| Action | What should happen |
|---|---|
| Add product | Product appears in cart with the expected quantity and price |
| Add same product again | Quantity increases unless the product disables quantity changes |
| Remove product | Product leaves the cart and totals update |
| Change quantity | Tebex basket updates and returns the corrected total |
| Apply coupon | Tebex validates the coupon and updates the basket |
| Apply creator code | Tebex stores the creator code on the basket |
| Apply gift card | Tebex validates the gift card and updates the basket |
| Proceed to checkout | Customer is sent to the Tebex checkout URL |
Cart Modes
Themes can present cart access in different ways.
| Mode | Best use |
|---|---|
| Drawer | Fast review without leaving the current page |
| Page | Larger baskets, more trust copy, clearer mobile review |
| Both | Stores that want a quick drawer and a full cart page |
Whichever mode you use, test the full path on mobile. A cart that looks fine on desktop can become the weakest part of the sale on a phone.
Authentication Required Products
Some Tebex products require the customer to sign in before the package can be added or delivered. This is common for game-server packages that need FiveM, Steam, Discord, or Minecraft identity.
When testing these products, check:
- The customer sees a clear sign-in prompt.
- The sign-in path returns to the store.
- The product can be added after authentication.
- The basket keeps the right customer identity.
- Checkout opens with the expected items.
Discord-required products can need an additional Discord verification path. Treat that as part of checkout QA, not only integration setup.
Discounts and Codes
Tebex validates discounts. Taintless should make the controls clear and show errors calmly.
| Code type | What to test |
|---|---|
| Coupon | Valid code, invalid code, remove coupon, one active coupon behavior |
| Creator code | Apply code, remove code, checkout still opens |
| Gift card | Apply card, remove card, multiple cards if your Tebex setup supports it |
Do not promise a discount in site copy unless it is configured in Tebex and tested in checkout.
Gift Purchases
Some products can be gifted to another player. Others disable gifting from Tebex.
If gifting matters for the store:
- Pick a product that supports gifting.
- Open the product detail page.
- Start the gift flow.
- Enter the target username.
- Add the product to cart.
- Confirm the cart shows the gift target clearly.
- Continue to checkout.
If a product disables gifting, the UI should not suggest that the customer can gift it.
Checkout QA
Run this before publishing and after major product changes.
Normal Product
- Open Products.
- Open a product detail page.
- Add to cart.
- Open the cart.
- Change quantity.
- Remove the item.
- Add it again.
- Continue to checkout.
- Confirm Tebex checkout opens.
Auth Required Product
- Open a product that requires authentication.
- Try to add it while signed out.
- Complete the Tebex sign-in path.
- Return to the store.
- Add the product.
- Continue to checkout.
Mobile
- Open the mobile preview.
- Add a product from a product card.
- Add a product from product detail.
- Open the cart drawer or cart page.
- Confirm totals and buttons fit comfortably.
- Continue to checkout.
After Checkout
After a customer completes checkout, Tebex sends receipts and handles delivery according to the Tebex store configuration.
The Thank You page should help the customer understand:
- That the order was handled by Tebex.
- Where receipts are sent.
- What to do if delivery is delayed.
- How to reach support.
- Whether Discord or account linking is the next step.
Troubleshooting
| Issue | First place to check |
|---|---|
| Product will not add to cart | Product requirements and authentication rules in Tebex |
| Quantity will not change | Product quantity settings in Tebex |
| Coupon fails | Coupon validity and scope in Tebex |
| Checkout total differs from storefront | Tebex product price, tax, currency, or discount rules |
| Checkout does not open | Basket state, Tebex token, and browser console |
| Thank You page looks empty | Return URL, transaction id, and basket lookup |
The healthiest checkout flow feels boring. The customer understands the product, reviews the basket, reaches Tebex, and knows where to get help after paying.