Codex · III

Managing products

A product is the thing a buyer pays for — an ebook, a plan, a t-shirt, a tip jar. You define it once in your dashboard and reference it from the buy button by its id. This is the whole product form, field by field.

The Products tab

Open your project and switch to Products. Your existing products are listed down the left, each with its price; + New product starts a fresh one. Selecting a product opens it in the editor on the right, where every field below lives. Changes are saved per product, so you can edit one without touching the others.

The Products tab. The list on the left; the editor on the right.

Details: name and reference

The Display name is for you — it labels the product in your dashboard and is the default heading on the buyer’s emails. The Product reference is the id you put on the buy button as product-id. Use letters, numbers, and hyphens (for example t-shirt-medium); keep it stable, because changing it means updating every page that references it.

The product reference is what the buy button’s product-id points at.

Pricing: fixed, buyer-priced, and currency

Choose Fixed to set the price yourself, or Buyer-priced to let the buyer enter an amount (for tips and donations). On a fixed product the worker reads the price from your catalog and ignores any amount the buy button might carry, so a buyer can’t edit the page to pay less. See fixed vs buyer-priced for the full picture.

Fixed or buyer-priced, plus the currency buyers are charged in.

Currency

The Currency is the 3-to-6 letter code buyers pay in — USD, EUR, BTC, ETH, or GBK. It has to be one your connected provider can actually charge: a card processor settles in fiat, a crypto rail in crypto. If a method can’t handle the currency, don’t offer that method on this product (or give it its own price — see below).

Pricing in Goldbacks (GBK)

GBK prices the product in Goldbacks — physical notes with a small amount of gold in them. Because they’re physical, GBK pairs with pay by mail: the buyer mails Goldbacks instead of paying online. Set the price to a whole number of Goldbacks (for example 5 GBK) and the buyer’s instructions tell them how many to send.

You don’t have to price the whole product in Goldbacks. The common pattern is one product priced two ways: a normal fiat price for cards and crypto, and a Goldback price just for the mail option. You set that per-method price in Payment methods below — for example $20 by card and 5 GBK by mail, on the same product.

On a Goldback order we quote a whole number of Goldbacks at that day’s rate (sourced from the Aquarian Metals price feed) and record the count and rate on the transaction, so the buyer and your records agree on what was owed even as the rate drifts. If the rate feed is briefly unavailable we simply omit the conversion line rather than block the order — Goldback amounts are whole and physical, so a small rounding either way is expected.

Digital file: automatic delivery

Attach a file and we email the buyer a private download link the moment their payment settles — no fulfilment step on your side. It’s one file per product; selling a bundle means zipping the files together and attaching the zip. Each link is unique to the transaction and can be revoked. Your storage use against your plan’s cap is shown under the uploader.

Drop a file here and the buyer gets a download link by email on payment.

When a file is attached, the email we send is the buyer-facing download email — you control its sender name, reply-to, and wording on the Buyer email tab.

Billing: one-time or recurring

Leave a product One-time for a single charge, or set it to Monthly or Annual to bill it as a subscription. Recurring billing runs on the rails that support it (Stripe, PayPal, and Dodo); the provider hosts the renewals and the cancellation page. See Subscriptions for how the recurring flow and its events work.

One-time, or a recurring subscription on a rail that supports it.

Environment: live vs testing

Live takes real payments. Testing runs the product on each connected provider’s test credentials, so you can place a full order end to end without moving money. Providers that have no test credentials configured fall back to live, so check the badge before you run a test order.

Testing places real orders on providers’ test credentials — no money moves.

Payment methods: show, rename, reorder, re-price

Every method you’ve connected shows up here. Untick one to hide it on this product, drag the handle to reorder how they appear in the buyer’s popup, and type a label to override what the button says (buyers see a payment category like “Credit card,” not the gateway’s brand). The field’s placeholder is the default label, so leaving it blank keeps the sensible default.

Show, hide, reorder, rename — and give a method its own price.

Custom price per method

Tick Custom price on a method to charge a different amount through it — this is how you put a Goldback price on the mail option while cards stay in dollars. Leave it off and the method uses the product’s main price. A couple of rails need a little more here: Dodo charges against a pre-built product, so its row asks for that product’s id.

Preview

The left rail previews the buy button for the product you’re editing, so you can see the buyer’s entry point without leaving the dashboard or pasting anything onto your site yet. When it looks right, copy the product-id into a buy button on your page.

A live preview of the button buyers will click.

Ready to wire it up?

Free tier covers most sites and never asks for a card.