SellApp
ResourcesWallet

Top-up bonus tiers

List, create, revise, archive, and restore wallet top-up bonus tiers.

The highest matching minimum wins. Priority breaks ties between tiers with the same minimum. Updating a tier creates an immutable replacement and archives the prior record. Use PATCH to change only supplied fields; PUT requires the complete tier payload.

GET
/v2/wallet-bonus-tiers

Authorization

bearerAuth storeAuth
AuthorizationBearer <token>

Provide your SellApp API key as a bearer token.

In: header

X-STORE<token>

Select the SellApp store for this API request.

In: header

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://sell.app/api/v2/wallet-bonus-tiers"
{
  "data": [
    {
      "id": 0,
      "minimum_top_up_cents": 1,
      "bonus_kind": "fixed",
      "fixed_bonus_cents": 1,
      "percent_basis": 1,
      "maximum_bonus_cents": 1,
      "priority": 0,
      "is_active": true,
      "created_at": "2019-08-24T14:15:22Z",
      "updated_at": "2019-08-24T14:15:22Z",
      "deleted_at": "2019-08-24T14:15:22Z"
    }
  ]
}
{
  "message": "Unauthenticated."
}
{
  "message": "This action is unauthorized."
}
{
  "message": "The given data was invalid.",
  "errors": {
    "data": [
      "The data field is required."
    ]
  }
}
POST
/v2/wallet-bonus-tiers

Authorization

bearerAuth storeAuth
AuthorizationBearer <token>

Provide your SellApp API key as a bearer token.

In: header

X-STORE<token>

Select the SellApp store for this API request.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://sell.app/api/v2/wallet-bonus-tiers" \  -H "Content-Type: application/json" \  -d '{    "minimum_top_up_cents": 1,    "bonus_kind": "fixed",    "fixed_bonus_cents": 1,    "percent_basis": 1,    "maximum_bonus_cents": 1,    "priority": 0,    "is_active": true  }'
{
  "data": {
    "id": 0,
    "minimum_top_up_cents": 1,
    "bonus_kind": "fixed",
    "fixed_bonus_cents": 1,
    "percent_basis": 1,
    "maximum_bonus_cents": 1,
    "priority": 0,
    "is_active": true,
    "created_at": "2019-08-24T14:15:22Z",
    "updated_at": "2019-08-24T14:15:22Z",
    "deleted_at": "2019-08-24T14:15:22Z"
  }
}
{
  "message": "Unauthenticated."
}
{
  "message": "This action is unauthorized."
}
{
  "message": "The given data was invalid.",
  "errors": {
    "data": [
      "The data field is required."
    ]
  }
}
PUT
/v2/wallet-bonus-tiers/{bonusTier}

Authorization

bearerAuth storeAuth
AuthorizationBearer <token>

Provide your SellApp API key as a bearer token.

In: header

X-STORE<token>

Select the SellApp store for this API request.

In: header

Path Parameters

bonusTier*integer

The bonusTier path parameter.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X PUT "https://sell.app/api/v2/wallet-bonus-tiers/0" \  -H "Content-Type: application/json" \  -d '{    "minimum_top_up_cents": 1,    "bonus_kind": "fixed",    "fixed_bonus_cents": 1,    "percent_basis": 1,    "maximum_bonus_cents": 1,    "priority": 0,    "is_active": true  }'
{
  "data": {
    "id": 0,
    "minimum_top_up_cents": 1,
    "bonus_kind": "fixed",
    "fixed_bonus_cents": 1,
    "percent_basis": 1,
    "maximum_bonus_cents": 1,
    "priority": 0,
    "is_active": true,
    "created_at": "2019-08-24T14:15:22Z",
    "updated_at": "2019-08-24T14:15:22Z",
    "deleted_at": "2019-08-24T14:15:22Z"
  }
}
{
  "data": {
    "id": 0,
    "minimum_top_up_cents": 1,
    "bonus_kind": "fixed",
    "fixed_bonus_cents": 1,
    "percent_basis": 1,
    "maximum_bonus_cents": 1,
    "priority": 0,
    "is_active": true,
    "created_at": "2019-08-24T14:15:22Z",
    "updated_at": "2019-08-24T14:15:22Z",
    "deleted_at": "2019-08-24T14:15:22Z"
  }
}
{
  "message": "Unauthenticated."
}
{
  "message": "This action is unauthorized."
}
{
  "message": "Rule not found."
}
{
  "message": "The given data was invalid.",
  "errors": {
    "data": [
      "The data field is required."
    ]
  }
}
PATCH
/v2/wallet-bonus-tiers/{bonusTier}

Authorization

bearerAuth storeAuth
AuthorizationBearer <token>

Provide your SellApp API key as a bearer token.

In: header

X-STORE<token>

Select the SellApp store for this API request.

In: header

Path Parameters

bonusTier*integer

The bonusTier path parameter.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X PATCH "https://sell.app/api/v2/wallet-bonus-tiers/0" \  -H "Content-Type: application/json" \  -d '{}'
{
  "data": {
    "id": 0,
    "minimum_top_up_cents": 1,
    "bonus_kind": "fixed",
    "fixed_bonus_cents": 1,
    "percent_basis": 1,
    "maximum_bonus_cents": 1,
    "priority": 0,
    "is_active": true,
    "created_at": "2019-08-24T14:15:22Z",
    "updated_at": "2019-08-24T14:15:22Z",
    "deleted_at": "2019-08-24T14:15:22Z"
  }
}
{
  "data": {
    "id": 0,
    "minimum_top_up_cents": 1,
    "bonus_kind": "fixed",
    "fixed_bonus_cents": 1,
    "percent_basis": 1,
    "maximum_bonus_cents": 1,
    "priority": 0,
    "is_active": true,
    "created_at": "2019-08-24T14:15:22Z",
    "updated_at": "2019-08-24T14:15:22Z",
    "deleted_at": "2019-08-24T14:15:22Z"
  }
}
{
  "message": "Unauthenticated."
}
{
  "message": "This action is unauthorized."
}
{
  "message": "Rule not found."
}
{
  "message": "The given data was invalid.",
  "errors": {
    "data": [
      "The data field is required."
    ]
  }
}
DELETE
/v2/wallet-bonus-tiers/{bonusTier}

Authorization

bearerAuth storeAuth
AuthorizationBearer <token>

Provide your SellApp API key as a bearer token.

In: header

X-STORE<token>

Select the SellApp store for this API request.

In: header

Path Parameters

bonusTier*integer

The bonusTier path parameter.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X DELETE "https://sell.app/api/v2/wallet-bonus-tiers/0"
{
  "data": {
    "id": 0,
    "minimum_top_up_cents": 1,
    "bonus_kind": "fixed",
    "fixed_bonus_cents": 1,
    "percent_basis": 1,
    "maximum_bonus_cents": 1,
    "priority": 0,
    "is_active": true,
    "created_at": "2019-08-24T14:15:22Z",
    "updated_at": "2019-08-24T14:15:22Z",
    "deleted_at": "2019-08-24T14:15:22Z"
  }
}
{
  "message": "Unauthenticated."
}
{
  "message": "This action is unauthorized."
}
{
  "message": "Rule not found."
}
{
  "message": "The given data was invalid.",
  "errors": {
    "data": [
      "The data field is required."
    ]
  }
}
POST
/v2/wallet-bonus-tiers/{bonusTier}/restore

Authorization

bearerAuth storeAuth
AuthorizationBearer <token>

Provide your SellApp API key as a bearer token.

In: header

X-STORE<token>

Select the SellApp store for this API request.

In: header

Path Parameters

bonusTier*integer

The bonusTier path parameter.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://sell.app/api/v2/wallet-bonus-tiers/0/restore"
{
  "data": {
    "id": 0,
    "minimum_top_up_cents": 1,
    "bonus_kind": "fixed",
    "fixed_bonus_cents": 1,
    "percent_basis": 1,
    "maximum_bonus_cents": 1,
    "priority": 0,
    "is_active": true,
    "created_at": "2019-08-24T14:15:22Z",
    "updated_at": "2019-08-24T14:15:22Z",
    "deleted_at": "2019-08-24T14:15:22Z"
  }
}
{
  "message": "Unauthenticated."
}
{
  "message": "This action is unauthorized."
}
{
  "message": "Rule not found."
}
{
  "message": "The given data was invalid.",
  "errors": {
    "data": [
      "The data field is required."
    ]
  }
}

Cashback rules GET

List, create, update, archive, and restore cashback rules.