Developer documentation v1

Get started

Overview First order in 10 minutes Order with AI · MCP Test checkout & events Quickstart & authentication How checkout works Code examples

Build your integration

Checkout widget Embedded checkout Checkout branding Custom success page Stripe Connect payouts Printing credits

API reference

POSTUpload artwork POSTCreate a cart GETRetrieve a cart GETRetrieve an order Webhooks

Resources

Artwork & API limits Errors & retries Going live Affiliate codes Expiry & retention Terms & image rights

OpenAPI specification Docs for AI agents Contact support

Documentation Resources

Resources

Affiliate codes

Apply your approved affiliate preference to new carts.

Optional affiliate code

Approved affiliates can enable Your affiliate link in the partner dashboard. The saved account preference applies to new API and widget carts. Keys do not contain the code; do not send an affiliate_code request field. Checkout prefills the saved code and applies existing eligibility, discount and self-referral rules. Customers can remove or replace it. Existing carts keep their original setting.

PreviousGoing live NextExpiry & retention

TCGPlaytest · Cardify LLC Partner terms Support

ON THIS PAGE

Affiliate codes

Build with your tools

Use the OpenAPI schema in your editor, or give your coding agent our API guide.

Open agent guide

API BASE URLhttps://partner.tcgplaytest.com

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.