ResellerHQ
Log inTry the sandbox free
GuidesAPI reference
Sub-resellers

Fund a sub-reseller

POST
/v1/sub-resellers/{id}/fund

Moves money out of your own wallet and into a sub-reseller's, in one step. Refused when either account is suspended, or when your own balance cannot cover it, with nothing moved either way. Send an Idempotency-Key header so a retry can never move the money twice.

Authorization

apiKey
headerAuthorizationBearer <token>

An API key from the Developers page. rhq_test_ keys reach the sandbox, rhq_live_ keys the live side.

Path Parameters

id*string

Header Parameters

Idempotency-Key?string

A value unique to this request, such as a UUID. A retry with the same key within 24 hours returns the first outcome instead of running again.

Length8 <= length <= 200

Request Body

application/json
  1. body
amount*integer

In cents

Range0 < value
memo?string
Length1 <= length <= 200

Response Body

Success

application/json
  1. response

Success

id*string
name*string
status*string
Value in"active""suspended"
priceListId*|

Unset, your default list prices this sub-reseller

wallet*
createdAt*string
Formatdate-time
curl -X POST "https://example.com/v1/sub-resellers/rsl_01K6XJ4Q8ZT3M9R5V2B7WDHNCA/fund" \  -H "Idempotency-Key: 2f1c9a52-7d0e-4a8e-9a53-0c1f6f3f2b11" \  -H "Content-Type: application/json" \  -d '{    "amount": 5000  }'
{  "id": "rsl_01K6XJ4Q8ZT3M9R5V2B7WDHNCA",  "name": "Sub Reseller Co",  "status": "active",  "priceListId": "prl_01K6XJ4Q8ZT3M9R5V2B7WDHNCA",  "wallet": {    "available": 8800,    "held": 0  },  "createdAt": "2026-10-07T11:04:31.000Z"}

List a sub-reseller's sales GET

Every purchase and renewal the sub-reseller made, newest first - the same shape as your own `GET /sales`, minus `customerId`: a sub-reseller's own customers are not this account's to join.

Withdraw unspent funds from a sub-reseller POST

Moves money out of a sub-reseller's wallet and back into your own, the mirror of fund. Moves only what is available: a sub-reseller's held funds belong to orders in flight and are never disturbed, so an over-withdrawal is refused with nothing moved. Allowed even when the sub-reseller is suspended, since suspension only stops it spending - the money withdrawn is yours to recover. Send an Idempotency-Key header so a retry can never move the money twice.