Create product and initial variant

Creates a new product with one default variant. The SKU must be unique within the tenant. Requires pos.catalog.write or equivalent.

A SALE CAN BE SET AT CREATE TIME. compare_at_price_cents, sale_starts_at and sale_ends_at (migration 0205) are accepted here and written in the same transaction as the variant. Until DF-MARKETPLACE-CREATE-PRODUCT-DROPS-0205-FIELDS they were silently discarded: a seller could not create a product that was on sale, they had to create it and then PATCH it, and the 201 said nothing about it. Refusals are the PATCH route's, before the write — 400 invalid_compare_at_price for a struck-through price below the price charged, 400 invalid_sale_window for a window that does not start strictly before it ends.

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

store_id*string

Formatuuid

name*string

product_type?string

physical (the default) needs a delivery method and address at marketplace checkout; digital and service do not. A cart with a physical line on a store with shipping on and no active method is refused 409 shipping_not_configured. Any other value is 400 invalid_product_type.

Default"physical"

Value in"physical" | "digital" | "service"

sku*string

price_cents*integer

Formatint64

currency*string

tax_category?string

initial_stock?integer

compare_at_price_cents?integer

The struck-through "was" price, in WHOLE RUPIAH despite the _cents suffix — the same unit as price_cents beside it (ADR-2026-09-22). Must be greater than or equal to price_cents: a struck-through price below the price actually charged is a misleading price claim, not a display choice. Equal is allowed, which is how a seller ends a sale without clearing the field.

Formatint64

sale_starts_at?string

When the sale begins, RFC3339 WITH AN OFFSET. An offset-less timestamp is refused rather than read in the server's zone — a sale that starts seven hours early is indistinguishable from one that started on time.

Formatdate-time

sale_ends_at?string

When the sale ends, RFC3339 with an offset. Must be strictly after sale_starts_at; a window that ends before it starts is a sale that never runs, which looks like success to the seller who saved it.

Formatdate-time

description?string

Long-form description, at most 4000 CHARACTERS (not bytes) — the same cap the marketplace CSV import applies. Longer is 400 description_too_long.

Lengthlength <= 4000

weight_grams?integer

Parcel weight in GRAMS. 0 means not set (a courier quote treats a store whose products all weigh 0 as weight_missing, never as Rp 0). Out of range is 400 invalid_shipping_attributes.

Range0 <= value <= 1000000

length_mm?integer

Parcel length in MILLIMETRES; 0 means not set. Out of range is 400 invalid_shipping_attributes.

Range0 <= value <= 10000

width_mm?integer

Parcel width in MILLIMETRES; 0 means not set. Out of range is 400 invalid_shipping_attributes.

Range0 <= value <= 10000

height_mm?integer

Parcel height in MILLIMETRES; 0 means not set. Out of range is 400 invalid_shipping_attributes.

Range0 <= value <= 10000

halal_cert_no?string

Halal certificate number, AS DECLARED BY THE SELLER — a free-text transcription nothing verifies; every surface rendering it labels it so. "" means not set. Surrounding whitespace is trimmed; longer than 60 characters is 400 invalid_compliance_field.

Lengthlength <= 60

bpom_reg_no?string

BPOM registration number, AS DECLARED BY THE SELLER — a free-text transcription nothing verifies; every surface rendering it labels it so. "" means not set. Surrounding whitespace is trimmed; longer than 60 characters is 400 invalid_compliance_field.

Lengthlength <= 60

shelf_life_note?string

Shelf-life note, AS DECLARED BY THE SELLER — a free-text transcription nothing verifies; every surface rendering it labels it so. "" means not set. Surrounding whitespace is trimmed; longer than 160 characters is 400 invalid_compliance_field.

Lengthlength <= 160

Response Body

`application/json`

curl -X POST https://sandbox.505pay.link/api/pos/v1/catalog/products \  -H "Authorization: Bearer $TOKEN" \  -H "Content-Type: application/json" \  -d '{}'

{
  "product_id": "018f4d9f-7b8a-7c2d-9a2d-1f8b92f6d400",
  "variant_id": "018f4d9f-7b8a-7c2d-9a2d-1f8b92f6d401",
  "sku": "ESP-001",
  "name": "Espresso"
}

Empty

{
  "error": "body_too_large",
  "message": "request body exceeds the 1048576-byte limit",
  "request_id": "018f4d9f-7b8a-7c2d-9a2d-1f8b92f6ffff"
}

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests to /v1/check",
  "request_id": "018f4d9f-7b8a-7c2d-9a2d-1f8b92f6ffff"
}

Was this page helpful?

Create product and initial variant

Authorization

Request Body

Response Body

201application/json

400

401

403

413application/json

429application/json

`application/json`

`application/json`

`application/json`