Skip to main content
PUT
Configure programme

Authorizations

Authorization
string
header
required

Your API key goes here

Path Parameters

storeId
string<uuid>
required

Body

application/json

Settings for a store's reseller programme.

isEnabled
boolean
required

Whether the store supplies resellers at all. Turning this off stops new draws immediately; it does not revoke anyone or touch their balance.

enrollmentMode
string
required

How new resellers get approved: Open, Application or InviteOnly.

Minimum string length: 1
Pattern: ^(?:Open|Application|InviteOnly)$
discountPercent
number<double>
required

The discount off list price that resellers pay, as a percentage.

Required range: 0 <= x <= 100
applicationDepositEnabled
boolean
required

Whether the application form invites a deposit at all. Only meaningful in Application mode.

requireApplicationDeposit
boolean
required

Whether MinimumApplicationDeposit is enforced — an application under it cannot be approved — or merely shown to the merchant when they decide.

maxOutstandingBalance
number<double> | null

The most unspent reseller balance the store is willing to be holding at once. Null means no cap.

Required range: 0 <= x <= 1000000
minimumTopUp
number<double> | null

The smallest top-up the store will accept from a reseller. Null means no minimum.

Required range: 0 <= x <= 100000
minimumApplicationDeposit
number<double> | null

The deposit the store asks an applicant for. Separate from MinimumTopUp, which governs every top-up for the rest of a reseller's life — this one only concerns getting in.

Required range: 0 <= x <= 1000000
autoApproveDepositAmount
number<double> | null

Deposit at or above which an application is approved with no merchant action. Null disables automatic approval however much is deposited.

Required range: 0 <= x <= 1000000
allowExternalBulkPurchase
boolean | null

Whether resellers who sell outside Komerza may buy stock in bulk up front. Null leaves the setting as it is.

Response

The object was successfully updated.

Represents a default generic response for API endpoints.

success
boolean
required

Indicates whether the operation or response was successful.

message
string | null

A descriptive message providing additional context or information about the response.

code
string | null

The error code (if there was an error) to use when referencing the error

data
any | null

Represents the data associated with a response.

Last modified on August 22, 2026