Catalog

Return the products and services in the catalog with their current prices.

Returns catalog items, most recently changed first, each with its type, price, any active discount and the price after discount, and branchIds: the branches an item is restricted to ([] means it applies to every branch). Use it to look up what can be sold and at what price before creating a payment. Read-only. Paginated: follow meta.pagination.nextCursor until hasMore is false.

Add a product or service, optionally with a discount.

Adds an item to the catalog. Prices are whole Indonesian rupiah (IDR), no decimals. This is the price payments are created from, so a wrong value here becomes a wrong amount a customer is asked to pay. Optionally include a discount object to price it down from the start, and branchIds to offer it only in conversations of those branches (omit it for every branch). Writes the item only; no customer is contacted. Check catalog.list first so you do not create a duplicate.

Fetch a catalog item with its price and discount.

Returns one catalog item with its type, price, discount configuration, the price in effect right now and branchIds (the branches it is restricted to; [] means every branch). Use it to confirm the amount before creating a payment. Read-only.

Permanently remove an item from the catalog.

Deletes the item and its discount. It cannot be undone from this API, and the item can no longer be priced for a payment. Prefer catalog.update with isActive=false to hide an item reversibly. Requires catalog:delete and is limited to 5 calls per minute.

Change the name, description, price or active flag of an item.

Changes only the fields you send. Prices are whole Indonesian rupiah (IDR), no decimals. This is the price payments are created from, so a wrong value here becomes a wrong amount a customer is asked to pay. Setting isActive to false hides the item without deleting it, which is usually what you want instead of catalog.delete. A discount object replaces the item's discount; removing a discount is a separate call, catalog.discountDelete. branchIds restricts the item to those branches ([] makes it apply to every branch; omit it to leave the restriction as it is) and may be sent alone. Writes the item; no customer is contacted.

Give a catalog item a percentage or fixed-rupiah discount.

Creates the discount on an item. Prices are whole Indonesian rupiah (IDR), no decimals. This is the price payments are created from, so a wrong value here becomes a wrong amount a customer is asked to pay. The discounted price is what a payment for this item is created at while the discount is enabled and inside its dates. An item holds one discount: if it already has one, use catalog.discountUpdate instead. Writes only; no customer is contacted.

Delete the discount so the item returns to its list price.

Deletes the item's discount; the item itself stays. From then on payments for it are created at the full list price. Use catalog.discountUpdate with isEnabled=false to pause a discount reversibly. Requires catalog:delete and is limited to 5 calls per minute.

Edit, enable or disable an existing discount.

Changes only the discount fields you send. Prices are whole Indonesian rupiah (IDR), no decimals. This is the price payments are created from, so a wrong value here becomes a wrong amount a customer is asked to pay. Set isEnabled to false to switch a discount off without losing its configuration. Writes only; no customer is contacted.