Skip to content

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.

ActionWhat should happen
Add productProduct appears in cart with the expected quantity and price
Add same product againQuantity increases unless the product disables quantity changes
Remove productProduct leaves the cart and totals update
Change quantityTebex basket updates and returns the corrected total
Apply couponTebex validates the coupon and updates the basket
Apply creator codeTebex stores the creator code on the basket
Apply gift cardTebex validates the gift card and updates the basket
Proceed to checkoutCustomer is sent to the Tebex checkout URL

Cart Modes

Themes can present cart access in different ways.

ModeBest use
DrawerFast review without leaving the current page
PageLarger baskets, more trust copy, clearer mobile review
BothStores 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:

  1. The customer sees a clear sign-in prompt.
  2. The sign-in path returns to the store.
  3. The product can be added after authentication.
  4. The basket keeps the right customer identity.
  5. 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 typeWhat to test
CouponValid code, invalid code, remove coupon, one active coupon behavior
Creator codeApply code, remove code, checkout still opens
Gift cardApply 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:

  1. Pick a product that supports gifting.
  2. Open the product detail page.
  3. Start the gift flow.
  4. Enter the target username.
  5. Add the product to cart.
  6. Confirm the cart shows the gift target clearly.
  7. 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

  1. Open Products.
  2. Open a product detail page.
  3. Add to cart.
  4. Open the cart.
  5. Change quantity.
  6. Remove the item.
  7. Add it again.
  8. Continue to checkout.
  9. Confirm Tebex checkout opens.

Auth Required Product

  1. Open a product that requires authentication.
  2. Try to add it while signed out.
  3. Complete the Tebex sign-in path.
  4. Return to the store.
  5. Add the product.
  6. Continue to checkout.

Mobile

  1. Open the mobile preview.
  2. Add a product from a product card.
  3. Add a product from product detail.
  4. Open the cart drawer or cart page.
  5. Confirm totals and buttons fit comfortably.
  6. 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:

  1. That the order was handled by Tebex.
  2. Where receipts are sent.
  3. What to do if delivery is delayed.
  4. How to reach support.
  5. Whether Discord or account linking is the next step.

Troubleshooting

IssueFirst place to check
Product will not add to cartProduct requirements and authentication rules in Tebex
Quantity will not changeProduct quantity settings in Tebex
Coupon failsCoupon validity and scope in Tebex
Checkout total differs from storefrontTebex product price, tax, currency, or discount rules
Checkout does not openBasket state, Tebex token, and browser console
Thank You page looks emptyReturn 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.