# Reseller

https://dev.wisecp.com/es/reseller-endpoints

The five endpoints that manage a client's reseller status and the programme's installation-wide settings.

## Overview

A reseller partnership is a client buying from you at a discount and selling on to their own customers. These endpoints run two separate layers that should not be confused.

The first three look at **one client**: their reseller status, credit threshold and discount tiers. The last two run **the programme itself**: how applications are approved, whether verification is required, whether resellers get API access. Whether the path carries a client id tells you which layer you are on.

## Reference

### Reading the Reseller Status

get/api/v1/admin/clients/{id}/reseller

`Clients/GetClientReseller` admin two shapes

Returns the client's reseller status and the settings that belong to them.

Response fields data — 7

is_resellerboolWhether the partnership is live. With no reseller record at all, this is the only field in the response.

statusstring`active` or `inactive`.

activation_timedatetime | nullWhen it first went live.

min_creditobject 2 fieldsThe credit needed to buy.

amountfloatThe amount.

currency_idintCurrency id.

min_discountobject 2 fieldsThe balance needed for the discount to apply.

amountfloatThe amount.

currency_idintCurrency id.

only_credit_paymentboolWhether paying by credit is the only option.

discountsobject 3 fieldsA map from product group id to discount tiers.

fromintLower bound of the tier.

tointUpper bound of the tier.

ratefloatThe discount rate for the tier.

Errors 2

not_found404No such client.

insufficient_scope403The key lacks the required scope.

Request cURL JavaScript PHP (HTTP) PHP (Internal)

```bash
curl 'https://panel.example.com/api/v1/admin/clients/42/reseller' \
  -H "Authorization: Bearer $API_KEY"
```

```javascript
const res  = await fetch('https://panel.example.com/api/v1/admin/clients/42/reseller', {
  headers: { Authorization: `Bearer ${apiKey}` },
});
const body = await res.json();

// With no reseller record the response holds a single field.
if (!body.data.is_reseller) return;
```

```php
$ch = curl_init('https://panel.example.com/api/v1/admin/clients/42/reseller');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . $apiKey],
]);

$body = json_decode(curl_exec($ch), true);
curl_close($ch);
```

```php
$response = Api::Clients()->GetClientReseller(['id' => 42]);

// The other fields only arrive when a record exists - read them null-safe.
$minCredit = $response['data']['min_credit']['amount'] ?? 0;
```

Response 200 200

```json
{
  "data": {
    "is_reseller": true,
    "status": "active",
    "activation_time": "2026-02-01 12:00:00",
    "min_credit": { "amount": 100.00, "currency_id": 840 },
    "min_discount": { "amount": 50.00, "currency_id": 840 },
    "only_credit_payment": false,
    "discounts": {
      "5": [{ "from": 1, "to": 10, "rate": 15.0 }]
    }
  }
}
```

```json
{
  "data": {
    "is_reseller": false
  }
}
```

### Saving the Reseller Settings

patch/api/v1/admin/clients/{id}/reseller

`Clients/UpdateClientReseller` admin notifies on first activation

Saves the reseller settings that belong to the client and switches the partnership on or off.

Body 5

activeboolSwitches the partnership on or off.

min_creditobject 2 fieldsThe minimum credit requirement. Only meaningful while the partnership is on.

amountfloatThe amount.

currency_idintCurrency id.

min_discountobject 2 fieldsThe minimum balance for the discount. Only meaningful while the partnership is on.

amountfloatThe amount.

currency_idintCurrency id.

only_credit_paymentboolLimits payment to credit.

discountsobject 3 fieldsA map from product group id to discount tiers.

fromintLower bound of the tier.

tointUpper bound of the tier.

ratefloatThe discount rate for the tier.

Response fields data

dataobjectThe reseller record after the save. Same shape as the read endpoint.

Errors 2

not_found404No such client.

insufficient_scope403The key lacks the required scope.

Request cURL JavaScript PHP (HTTP) PHP (Internal)

```bash
curl -X PATCH 'https://panel.example.com/api/v1/admin/clients/42/reseller' \
  -H "Authorization: Bearer $API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"active":true,"min_credit":{"amount":100,"currency_id":840},"only_credit_payment":true}'
```

```javascript
const res = await fetch('https://panel.example.com/api/v1/admin/clients/42/reseller', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${apiKey}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    active: true,
    min_credit: { amount: 100, currency_id: 840 },
    only_credit_payment: true,
    discounts: {
      5: [{ from: 1, to: 10, rate: 15 }],
    },
  }),
});

const body = await res.json();
```

```php
$ch = curl_init('https://panel.example.com/api/v1/admin/clients/42/reseller');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST  => 'PATCH',
    CURLOPT_HTTPHEADER     => [
        'Authorization: Bearer ' . $apiKey,
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'active'              => true,
        'min_credit'         => ['amount' => 100, 'currency_id' => 840],
        'only_credit_payment' => true,
    ]),
]);

$body = json_decode(curl_exec($ch), true);
curl_close($ch);
```

```php
// While the partnership is on, a setting you omit REMOVES that limit - read the current state first.
$current = Api::Clients()->GetClientReseller(['id' => 42])['data'];

$response = Api::Clients()->UpdateClientReseller([
    'id'                  => 42,
    'active'              => true,
    'min_credit'          => $current['min_credit'],
    'min_discount'        => $current['min_discount'],
    'only_credit_payment' => true,
    'discounts'           => $current['discounts'],
]);
```

### Changing the Reseller Status

put/api/v1/admin/clients/{id}/reseller/status

`Clients/SetClientResellerStatus` admin leaves settings alone

Switches an existing reseller record on or off. The settings stay as they are.

Body 1

actionstringrequired`activate` or `terminate`.

Response fields data — 2

statusstringThe status afterwards.

is_resellerboolWhether the partnership is live.

Errors 3

not_found404No such client.

action_invalid422`action` is neither of the two values.

not_reseller422The client has no reseller record. Create one with the settings endpoint first.

Request cURL JavaScript PHP (HTTP) PHP (Internal)

```bash
curl -X PUT 'https://panel.example.com/api/v1/admin/clients/42/reseller/status' \
  -H "Authorization: Bearer $API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"action":"activate"}'
```

```javascript
const res = await fetch('https://panel.example.com/api/v1/admin/clients/42/reseller/status', {
  method: 'PUT',
  headers: {
    Authorization: `Bearer ${apiKey}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ action: 'activate' }),
});

const body = await res.json();
```

```php
$ch = curl_init('https://panel.example.com/api/v1/admin/clients/42/reseller/status');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST  => 'PUT',
    CURLOPT_HTTPHEADER     => [
        'Authorization: Bearer ' . $apiKey,
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode(['action' => 'activate']),
]);

$body = json_decode(curl_exec($ch), true);
curl_close($ch);
```

```php
$response = Api::Clients()->SetClientResellerStatus([
    'id'     => 42,
    'action' => 'activate',
]);
```

### Reading the Programme Settings

get/api/v1/admin/clients/reseller/config

`Clients/GetResellerConfig` admin installation-wide

Returns the installation-wide settings of the reseller programme. It looks at no single client.

Response fields data — 10

enabledboolWhether the programme is on.

activationstringHow applications are approved. The stored value is `manuel` or `auto`.

allow_non_membersboolWhether non-members can see the reseller storefront.

api_accessboolWhether resellers get API access.

payment_restrictionboolWhether payment is limited to credit.

verificationboolWhether applications must be verified.

verification_methodsstring[]The verification methods required.

min_creditobject 2 fieldsThe minimum credit amount.

amountfloatThe amount.

currency_idintCurrency id.

credit_thresholdobject 2 fieldsThe credit threshold.

amountfloatThe amount.

currency_idintCurrency id.

discount_ratesobject 3 fieldsA map from product group id to discount tiers.

fromintLower bound of the tier.

tointUpper bound of the tier.

ratefloatThe discount rate for the tier.

Errors 1

insufficient_scope403The key lacks the required scope.

Request cURL JavaScript PHP (HTTP) PHP (Internal)

```bash
curl 'https://panel.example.com/api/v1/admin/clients/reseller/config' \
  -H "Authorization: Bearer $API_KEY"
```

```javascript
const res  = await fetch('https://panel.example.com/api/v1/admin/clients/reseller/config', {
  headers: { Authorization: `Bearer ${apiKey}` },
});
const body = await res.json();
```

```php
$ch = curl_init('https://panel.example.com/api/v1/admin/clients/reseller/config');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer ' . $apiKey],
]);

$body = json_decode(curl_exec($ch), true);
curl_close($ch);
```

```php
$response = Api::Clients()->GetResellerConfig();
```

### Saving the Programme Settings

put/api/v1/admin/clients/reseller/config

`Clients/SaveResellerConfig` admin installation-wide

Saves the installation-wide settings of the reseller programme.

Body 10

enabledboolTurns the programme on or off.

activationstring`manual`, `automatic` or `auto`. An unrecognised value falls back to manual approval.

allow_non_membersboolOpens the storefront to non-members.

api_accessboolGives resellers API access.

payment_restrictionboolLimits payment to credit.

verificationboolMakes verification mandatory on application.

verification_methodsstring[]The verification methods to require.

min_creditobject 2 fieldsThe minimum credit amount.

amountfloatThe amount.

currency_idintCurrency id.

credit_thresholdobject 2 fieldsThe credit threshold.

amountfloatThe amount.

currency_idintCurrency id.

discount_ratesobject 3 fieldsA map from product group id to discount tiers.

fromintLower bound of the tier.

tointUpper bound of the tier.

ratefloatThe discount rate for the tier.

Response fields data

dataobjectThe programme settings after the save. Same shape as the read endpoint.

Errors 1

insufficient_scope403The key lacks the required scope.

Request cURL JavaScript PHP (HTTP) PHP (Internal)

```bash
curl -X PUT 'https://panel.example.com/api/v1/admin/clients/reseller/config' \
  -H "Authorization: Bearer $API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"enabled":true,"activation":"manual","api_access":true}'
```

```javascript
const res = await fetch('https://panel.example.com/api/v1/admin/clients/reseller/config', {
  method: 'PUT',
  headers: {
    Authorization: `Bearer ${apiKey}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    enabled: true,
    activation: 'manual',
    api_access: true,
  }),
});

const body = await res.json();
```

```php
$ch = curl_init('https://panel.example.com/api/v1/admin/clients/reseller/config');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST  => 'PUT',
    CURLOPT_HTTPHEADER     => [
        'Authorization: Bearer ' . $apiKey,
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'enabled'    => true,
        'activation' => 'manual',
        'api_access' => true,
    ]),
]);

$body = json_decode(curl_exec($ch), true);
curl_close($ch);
```

```php
$response = Api::Clients()->SaveResellerConfig([
    'enabled'    => true,
    'activation' => 'manual',
    'api_access' => true,
]);
```

## Pitfalls

> **A setting you omit removes the limit**
> 
> Saving settings while the partnership is on **drops** any limit you did not send; the old value is not kept. Forgetting the credit threshold while you only meant to change the payment restriction removes that threshold. Read the current settings, edit them, and send all of it back.

> **The response shape depends on the record**
> 
> With no reseller record the status endpoint returns only `is_reseller` and the other fields are **absent**. Read them null-safe rather than directly, or every non-reseller client will break your code.

> **The status endpoint cannot create a partnership**
> 
> The quick toggle only changes an existing record; on a client without one it returns `not_reseller`. Opening a new partnership is the settings endpoint's job.

## Related Articles

- [Client Endpoints](https://dev.wisecp.com/en/client-endpoints)
- [Affiliate](https://dev.wisecp.com/en/affiliate-endpoints)