Skip to content
TCGPlaytestdocsDashboard
Documentation Resources
Resources

Going live

Partner launch checklist: verified orders, allowed origins and live checkout.

Partner launch checklist

Use this checklist for your storefront. Platform deployment, database and Stripe account setup are handled by TCGPlaytest operations.

  1. Complete one verified sandbox order

    Follow First order in 10 minutes. Confirm that your Test webhook verifies the signature, stores the expected order state and handles retries without clearing purchased items twice. A queued event or browser redirect is not proof.

  2. Register the exact website origins

    Save your production HTTPS website in the dashboard. Add any extra widget origins separately. Your return URL and webhook URL must use the registered website origin. Confirm live delivery details open on an allowed origin and fail on an unlisted origin.

  3. Use the live key on your server

    Create a live API key from the production dashboard and set your server API base to https://partner.tcgplaytest.com. Never put the secret key in browser JavaScript. The standalone widget uses your public partner identifier with data-mode="live".

  4. Configure the Live order webhook

    Live and Test webhook settings and secrets are separate. Verify raw-body signatures, save event IDs durably and process each event once. Reconcile with the order API when events arrive late or out of order.

  5. Check the storefront handoff

    Browser JavaScript calls TCGPlaytest.checkout(cart) for live delivery details. Stripe opens outside the iframe. Verify the saved cart and order on your server before showing payment confirmation or removing purchased quantities; preserve later cart edits.

  6. Check optional funding and payouts

    Ordinary hosted checkout does not require Stripe Connect. If you use printing credit, accept its terms and fund the live balance. If you use Connect payouts, complete onboarding and confirm that your account is ready.

  7. Arrange a controlled launch check

    The simulator does not verify actual payment totals, discounts, shipping charges, tax or payouts. Coordinate a Stripe test-mode check and final launch approval with TCGPlaytest before opening sales. Keep the tested order references and webhook evidence.

Common mistakes

Test is not a payment rehearsal. Hosted/Connect sandbox checkout simulates payment and fulfillment; it never charges, prints or ships.

Staging is a different origin. Allow it explicitly when embedding, and use keys and webhook settings from the matching partner dashboard.

A configuration error needs operator help. For a 503, missing delivery details, exhausted webhook retries or a payment-mode error, send support the timestamp, cart ID and request ID. Do not send API keys or webhook secrets.

References: embedded checkout, webhooks, verified success pages.

24 topics

Get startedOverview

Everything you need to turn artwork into printed cards.

Get startedFirst order in 10 minutes

A runnable sandbox example from test key to verified webhook delivery.

Get startedOrder with AI · MCP

Connect ChatGPT, Claude, Gemini or your developer tools, preview your cards and check out without a TCGPlaytest account or customer API key.

Get startedTest checkout & events

Simulate checkout, verify the order, return to your store and trigger signed test events.

Get startedQuickstart & authentication

Set up your account, protect your API key and make your first integration.

Get startedHow checkout works

Create a cart, wait for artwork validation and open checkout on your website.

Get startedCode examples

Working server examples in your preferred language.

Build your integrationCheckout widget

Connect finished images to a ready-made review and checkout experience.

Build your integrationEmbedded checkout

Keep delivery details and artwork confirmation inside your own website.

Build your integrationCheckout branding

Make checkout feel like your store with saved branding and style presets.

Build your integrationCustom success page

Return customers to your registered website after verified payment.

Build your integrationStripe Connect payouts

Set your card selling price and receive earnings, with a 5% reserve for 15 days.

Build your integrationPrinting credits

Use your balance for printing, with customer shipping and tax paid through Stripe.

API referenceUpload artwork

Request a temporary upload URL. Send file bytes directly to private storage.

API referenceCreate a cart

Submit finished artwork, quantities and your success URL for validation.

API referenceRetrieve a cart

Read validation progress, quality warnings and checkout availability.

API referenceRetrieve an order

Track a funded manufacturing order from payment to shipment.

API referenceWebhooks

Receive signed order updates on your server.

ResourcesArtwork & API limits

File specifications, card limits and request allowances for this deployment.

ResourcesErrors & retries

Understand failures and retry safely without creating duplicate carts.

ResourcesGoing live

Partner launch checklist: verified orders, allowed origins and live checkout.

ResourcesAffiliate codes

Apply your approved affiliate preference to new carts.

ResourcesExpiry & retention

Understand cart lifetimes, artwork storage and cleanup.

ResourcesTerms & image rights

Know your responsibilities and the customer acceptance requirements.