Skip to Content
🏪 Merchant GuideProducts and publishing

Product configuration and publishing

Manage your products under Merchant Center → Products. The platform assigns ownership to the current merchant; submitting another user’s identifier cannot transfer ownership.

Prepare the product content

Provide a name, description, image, search keywords and purchase instructions. Explain what the buyer receives, how delivery works and what information is needed.

Distinguish these pricing settings:

SettingPurpose
Product currencyCurrency used to price the product
Actual priceNormal unit price
Reference priceCrossed-out display price
Wholesale pricesQuantity-based unit-price tiers

Prices must be positive. Enter normal display amounts such as 1.25 in the interface. For API integer values, see Amounts and data formats.

Stock and quantity limits

  • Ordinary count stock is maintained on the product, local unique codes are managed row by row in the Inventory Center, and an external API product is fulfilled by its supplier system.
  • Stock determines available quantity; unpaid orders can also reserve it. One local code is one unit, so a multi-unit purchase reserves and delivers the same number of rows.
  • The quantity limit applies to a single order. Zero means no limit; it is not a lifetime limit per user.
  • Sorting weight affects list order.
  • The publish switch determines whether the product is enabled. Check its saved state.

Do not calculate revenue from the sales counter alone. Reconcile orders with wallet transactions.

Additional order fields

For delivery information, configure a field identifier, display label and required flag. For example, use identifier service_account with label “Service account”.

Programs submit the identifier; buyers see the label. Keep identifiers stable so existing integrations continue to send the right fields. Collect only information needed for delivery, not buyers’ platform passwords.

Payment methods

Automatic matching uses compatible channels. An allowlist must include at least one valid platform order-payment channel. Disabled channels, incompatible currencies or missing exchange rates can prevent a buyer from obtaining a quote.

Merchant-owned Stripe configuration cannot currently bypass these restrictions. See Payment and settlement.

Sales scope and business callbacks

The interface offers marketplace, merchant store, both and private scopes. Current public product queries do not use this field as a complete access-control boundary. Do not treat Private as a confidentiality guarantee. Disable the product to stop public sales and check the public result.

Pre-order validation and legacy post-payment callback addresses connect your own service. Configure them only when you have a receiver and have checked the address, failure handling and duplicate notifications. Ordinary products do not need a placeholder callback URL. New products that require explicit third-party delivery confirmation should use the API fulfillment protocol; a legacy callback’s HTTP 200 is not delivery confirmation.

Before publishing

Save and reopen the product to check its price, stock, required fields, channels and published state. Then inspect its presentation and quote as a buyer. An accessible product page establishes browsing availability, not successful payment and delivery.

Last updated on