Reseller Tiers

List Tiers

Returns the shop's reseller tiers with their overrides and member counts.

Authorization

AuthorizationRequiredBearer <token>

You can retrieve your API key by visiting your dashboard and clicking Account > API.

In: header

Path Parameters

shopIdRequiredinteger

The shop ID.

curl -X GET "https://api.sellauth.com/v1/shops/{shopId}/reseller-tiers" \
  -H "Authorization: Bearer <token>"

{
  "message": "Unauthenticated."
}

Create Tier

Authorization

AuthorizationRequiredBearer <token>

You can retrieve your API key by visiting your dashboard and clicking Account > API.

In: header

Request Body

application/jsonRequired

nameRequiredstring

The tier name.

discount_percentageRequirednumber

Discount resellers on this tier get on reseller orders.

is_publicRequiredboolean

Public tiers are shown on the storefront reseller page.

sort_orderinteger

Must be at least 0. Must not be greater than 1000.

min_spent_usdnumber

Auto-advancement threshold: lifetime reseller spend in USD. Null disables this threshold.

min_sales_countinteger

Auto-advancement threshold: lifetime completed reseller orders. Null disables this threshold.

image_idinteger

Optional image shown alongside the tier on the storefront.

Path Parameters

shopIdRequiredinteger

The shop ID.

curl -X POST "https://api.sellauth.com/v1/shops/{shopId}/reseller-tiers" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Gold",
    "discount_percentage": 10,
    "is_public": null,
    "sort_order": 24,
    "min_spent_usd": 500,
    "min_sales_count": 50,
    "image_id": 1
  }'

Delete Tier

Deletes a tier. Its members fall back to the default tier. The default tier cannot be deleted.

Authorization

AuthorizationRequiredBearer <token>

You can retrieve your API key by visiting your dashboard and clicking Account > API.

In: header

Path Parameters

shopIdRequiredinteger

The shop ID.

tierIdRequiredinteger

The tier ID.

curl -X DELETE "https://api.sellauth.com/v1/shops/{shopId}/reseller-tiers/{tierId}" \
  -H "Authorization: Bearer <token>"

Update Tier

Authorization

AuthorizationRequiredBearer <token>

You can retrieve your API key by visiting your dashboard and clicking Account > API.

In: header

Request Body

application/jsonRequired

nameRequiredstring

Must not be greater than 100 characters.

discount_percentageRequirednumber

Must be at least 0. Must not be greater than 100.

is_publicRequiredboolean

sort_orderinteger

Must be at least 0. Must not be greater than 1000.

min_spent_usdnumber

Must be at least 0. Must not be greater than 99999999.

min_sales_countinteger

Must be at least 0. Must not be greater than 100000000.

image_idstring

Path Parameters

shopIdRequiredinteger

The shop ID.

tierIdRequiredinteger

The tier ID.

curl -X PUT "https://api.sellauth.com/v1/shops/{shopId}/reseller-tiers/{tierId}" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "pasyzwszwtxpeqq",
    "discount_percentage": 9,
    "is_public": true,
    "sort_order": 24,
    "min_spent_usd": 12,
    "min_sales_count": 22,
    "image_id": null
  }'

Set Tier Overrides

Replaces the tier's per-product/per-variant discount overrides. A variant-level override wins over the product-level one. An override of 0 disables the discount.

Authorization

AuthorizationRequiredBearer <token>

You can retrieve your API key by visiting your dashboard and clicking Account > API.

In: header

Request Body

application/jsonRequired

overridesRequiredarray<object>

The overrides. Omit variant_id (or pass null) for a product-level override.

Path Parameters

shopIdRequiredinteger

The shop ID.

tierIdRequiredinteger

The tier ID.

curl -X PUT "https://api.sellauth.com/v1/shops/{shopId}/reseller-tiers/{tierId}/overrides" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "overrides": [
      {
        "product_id": 123,
        "variant_id": null,
        "discount_percentage": 15
      }
    ]
  }'

Reseller Tiers

Response

TypeScript