Node.js

import Shoply from "@shoplygg/node";

const shoply = new Shoply({ apiKey: process.env.SHOPLY_API_KEY });

const page = await shoply.resellerTopUps.list();

// Or every row of every page:
for await (const row of shoply.resellerTopUps.list()) {
  console.log(row);
}

<?php

require 'vendor/autoload.php';

$shoply = new Shoply\Client(['apiKey' => getenv('SHOPLY_API_KEY')]);

$page = $shoply->resellerTopUps->list();

// Or every row of every page:
foreach ($shoply->resellerTopUps->list() as $row) {
    print_r($row);
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.shoply.gg/v1/stores/{storeId}/resellers/top-ups"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.shoply.gg/v1/stores/{storeId}/resellers/top-ups")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "message": null,
  "code": null,
  "data": [
    {
      "id": "0d9f5h0p1yf-b0f7183f27c-1036611",
      "resellerId": "5802fdf5-5c97-40bb-b505-29a900c278e4",
      "reseller": "keydepot.example.com",
      "resellerRemoved": false,
      "paidBy": "team@keydepot.example.com",
      "amount": 100,
      "currency": "USD",
      "state": "checking",
      "method": "Bank Transfer (EU)",
      "createdAt": "2026-11-09 11:32:36",
      "paidAt": null
    },
    {
      "id": "9e015h0p1y6-bd68d96dc00-1036610",
      "resellerId": "5802fdf5-5c97-40bb-b505-29a900c278e4",
      "reseller": "keydepot.example.com",
      "resellerRemoved": false,
      "paidBy": "team@keydepot.example.com",
      "amount": 30,
      "currency": "USD",
      "state": "waiting",
      "method": "",
      "createdAt": "2026-11-09 11:32:36",
      "paidAt": null
    }
  ],
  "pages": 1,
  "total": 2,
  "meta": {
    "counts": {
      "all": 2,
      "checking": 1,
      "paid": 0,
      "waiting": 1,
      "expired": 0,
      "taken_back": 0
    },
    "figures": {
      "paid30": 0,
      "paidCount30": 0,
      "payers30": 0,
      "waiting": 130,
      "waitingCount": 2,
      "balanceHeld": 37
    },
    "currency": "USD"
  }
}

{
  "success": false,
  "message": "<string>",
  "code": "<string>",
  "data": null,
  "errors": {}
}

{
  "success": false,
  "message": "<string>",
  "code": "<string>",
  "data": null,
  "errors": {}
}

{
  "success": false,
  "message": "<string>",
  "code": "<string>",
  "data": null,
  "errors": {}
}

{
  "success": false,
  "message": "<string>",
  "code": "<string>",
  "data": null,
  "errors": {}
}

Resellers

List top-ups

Money resellers put on their balance, paid on the store’s checkout with its own payment methods, newest first, 25 a page. state is paid, waiting (for the reseller to pay), checking (paid with one of the store’s custom methods, and waiting for the store), expired (not paid in the store’s unpaid order time) or taken_back (its payment was taken back by the bank, and came off the balance). A top-up’s id is the order it is paid with. meta.counts is how many in each state, and meta.figures the last 30 days’.

Needs the resellers.read permission (Read Resellers).

GET

stores

{storeId}

resellers

top-ups

Node.js

import Shoply from "@shoplygg/node";

const shoply = new Shoply({ apiKey: process.env.SHOPLY_API_KEY });

const page = await shoply.resellerTopUps.list();

// Or every row of every page:
for await (const row of shoply.resellerTopUps.list()) {
  console.log(row);
}

<?php

require 'vendor/autoload.php';

$shoply = new Shoply\Client(['apiKey' => getenv('SHOPLY_API_KEY')]);

$page = $shoply->resellerTopUps->list();

// Or every row of every page:
foreach ($shoply->resellerTopUps->list() as $row) {
    print_r($row);
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.shoply.gg/v1/stores/{storeId}/resellers/top-ups"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.shoply.gg/v1/stores/{storeId}/resellers/top-ups")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "message": null,
  "code": null,
  "data": [
    {
      "id": "0d9f5h0p1yf-b0f7183f27c-1036611",
      "resellerId": "5802fdf5-5c97-40bb-b505-29a900c278e4",
      "reseller": "keydepot.example.com",
      "resellerRemoved": false,
      "paidBy": "team@keydepot.example.com",
      "amount": 100,
      "currency": "USD",
      "state": "checking",
      "method": "Bank Transfer (EU)",
      "createdAt": "2026-11-09 11:32:36",
      "paidAt": null
    },
    {
      "id": "9e015h0p1y6-bd68d96dc00-1036610",
      "resellerId": "5802fdf5-5c97-40bb-b505-29a900c278e4",
      "reseller": "keydepot.example.com",
      "resellerRemoved": false,
      "paidBy": "team@keydepot.example.com",
      "amount": 30,
      "currency": "USD",
      "state": "waiting",
      "method": "",
      "createdAt": "2026-11-09 11:32:36",
      "paidAt": null
    }
  ],
  "pages": 1,
  "total": 2,
  "meta": {
    "counts": {
      "all": 2,
      "checking": 1,
      "paid": 0,
      "waiting": 1,
      "expired": 0,
      "taken_back": 0
    },
    "figures": {
      "paid30": 0,
      "paidCount30": 0,
      "payers30": 0,
      "waiting": 130,
      "waitingCount": 2,
      "balanceHeld": 37
    },
    "currency": "USD"
  }
}

{
  "success": false,
  "message": "<string>",
  "code": "<string>",
  "data": null,
  "errors": {}
}

{
  "success": false,
  "message": "<string>",
  "code": "<string>",
  "data": null,
  "errors": {}
}

{
  "success": false,
  "message": "<string>",
  "code": "<string>",
  "data": null,
  "errors": {}
}

{
  "success": false,
  "message": "<string>",
  "code": "<string>",
  "data": null,
  "errors": {}
}

Authorizations

Authorization

string

header

required

A secret API key, made under Developers in the dashboard: Authorization: Bearer shoply_sk_...

Path Parameters

storeId

string

required

The store's ID. A key reaches the store it was made in: GET /key answers which.

Query Parameters

string

Only what matches this text: an order's ID, a reseller's website, or who bought or paid.

reseller

string

Only one reseller's, by their ID.

status

enum<string>

Only those in one state.

Available options:

paid,

waiting,

checking,

expired,

taken_back

page

integer

default:1

Which page of the list. The first is 1.

Response

It worked.

success

boolean

message

unknown

code

unknown

data

object[]

Show child attributes

pages

integer

total

integer