Guides
Reference pages tell you what every field means. Guides tell you how to get one
job done, end to end, with verified curl and @dscodotco/sdk code you can
paste. Each one names its prerequisites up front and cross-links the matching
reference and concepts pages in a Related footer.
New here? Start with Create your store, then Get your API keys, then Add your first product.
All examples target the RUO Pro production host https://api.ruo.pro. Money is
integer cents everywhere; the error body is always nested
({ "error": { "code", "message" } }).
Get set up
Create your storeProvision a tenant, take it from draft to live.Get your API keysMint an fdk_ merchant key with least privilege; the storefront token is operator-provisioned.
Catalog
Add productsCreate a product active, or as a draft to keep it hidden.Variants and optionsSKUs, labels, and per-variant pricing.Organize with collectionsGroup products and surface them in discovery.Product imagesAttach a media asset and serve a resolved image_url.Import a catalogScript a create-loop over products and variants from a source list.
Selling
Search and discoveryFaceted search over the public catalog.Integrate checkoutPlace an order server-side with idempotency.Discounts and couponsPreview and apply coupon pricing.SubscriptionsSubscribe-and-save plans and their lifecycle.Gift cardsIssue, list, and void gift cards.Store creditGrant and read a shopper’s store-credit balance.
Storefronts
Hosted storefrontPublish a site manifest and take it live.Custom frontendBuild a headless store with the SDK.Custom domainsAttach and verify your own hostname.
Orders
Order lifecycleThe states an order moves through.Returns and refundsRefund a charge and run an RMA.Fulfillment and inventoryPick, pack, ship, and track stock.
Growth
Marketing campaignsDrip and broadcast to your audience.AffiliatesReferral attribution and commissions.
Trust
Fraud controlsThe checkout fraud floor and your ban list.Compliance gatesThe RUO claims scan on published copy.Provenance verificationProve a product’s chain of custody.