Skip to content
TCGPlaytestdocsDashboard
Documentation Build your integration
Build your integration

Custom success page

Return customers to your registered website after verified payment.

Your own success page and registered domain

Host a success page on your website and send its address as return_url. It must be HTTPS on the exact origin of your partner account’s website_url (scheme, hostname and port). Paths can differ; a different subdomain is a different origin. The registered website is shown in Dashboard → 3. Add TCGPlaytest to your website. Contact the platform operator if that account address needs changing.

STORE_ORIGIN is an environment variable used by these examples to construct the return URL; it is not an API setting. Use your deployed HTTPS website origin without a trailing slash. Changing website_url in the partner database does not update your application environment: update STORE_ORIGIN and redeploy when changing domains. No platform-wide environment change or API-key rotation is required for a partner domain change.

widget_allowed_origins controls widget access and checkout embedding; it does not authorize additional return domains. HTTP localhost is not a valid return destination; use a registered public HTTPS deployment or tunnel for a complete return-flow test.

Checkout automatically returns to your saved success URL after the payment and order are verified, for both partner-credit and normal customer payments. A short confirmation screen waits if payment notifications are still arriving. Keep the cart ID tied to your customer session. Your success page must read the saved cart’s order_id and verify GET /v1/orders/{id}, or use a verified payment webhook. Never mark an order paid because a browser visited this URL. The checkout’s “Return to partner website” link goes to the registered website, not to a payment-success claim.

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.