Introduction

Returns a paginated list of your Live products, sorted by creation date descending.

{
  "products": [
    {
      "id": "clxabc123",
      "productId": "rec_abc123",
      "name": "Pro License",
      "description": "One-year software license",
      "image": "https://cdn.selley.io/img.jpg",
      "type": "Serial",
      "price": 29.99,
      "currency": "USD",
      "stock": 50,
      "status": "Live",
      "sortOrder": 0,
      "unlisted": false,
      "createdAt": "2024-06-01T10:00:00.000Z",
      "updatedAt": "2024-06-01T10:00:00.000Z"
    }
  ],
  "nextCursor": "clxdef456"
}

curl "https://selley.io/api/v1/products?limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

Retrieve a single product by its internal ID or the shorter productId (e.g. rec_abc123).

curl "https://selley.io/api/v1/products/rec_abc123" \
  -H "Authorization: Bearer YOUR_API_KEY"

Create a new product. The product is created in Draft status by default. Set status to Live to make it visible on your storefront.

curl -X POST "https://selley.io/api/v1/products" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Pro License",
    "price": 29.99,
    "type": "Serial",
    "currency": "USD",
    "status": "Live"
  }'

Update any fields of an existing product. Only the fields you include will be changed.

curl -X PUT "https://selley.io/api/v1/products/rec_abc123" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"price": 39.99, "status": "Live"}'

Permanently delete a product. This cannot be undone. Returns success: true on success.

{ "success": true }

curl -X DELETE "https://selley.io/api/v1/products/rec_abc123" \
  -H "Authorization: Bearer YOUR_API_KEY"

Returns orders for your shop(s), most recent first. Includes order items. Scoped by shop (use X-Selley-Shop for multi-shop).

{
  "orders": [
    {
      "id": "clxabc123",
      "orderNumber": "ORD-12345",
      "status": "completed",
      "paymentStatus": "paid",
      "total": 29.99,
      "currency": "USD",
      "customerEmail": "[email protected]",
      "customerName": "Jane Smith",
      "paymentMethod": "Stripe",
      "createdAt": "2024-06-01T10:00:00.000Z",
      "paidAt": "2024-06-01T10:01:30.000Z",
      "items": [
        {
          "id": "item_123",
          "productId": "clx_prod",
          "productName": "Pro License",
          "quantity": 1,
          "price": 29.99,
          "total": 29.99
        }
      ]
    }
  ]
}

curl "https://selley.io/api/v1/orders?limit=20" \
  -H "Authorization: Bearer YOUR_API_KEY"

Retrieve a single order by its internal ID or the display orderNumber (e.g. ORD-12345). Includes full item list.

curl "https://selley.io/api/v1/orders/ORD-12345" \
  -H "Authorization: Bearer YOUR_API_KEY"

Update the status of an order. Useful for manually marking orders as completed or cancelled.

curl -X PUT "https://selley.io/api/v1/orders/ORD-12345" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"status": "completed"}'

Returns all discount coupons for your account. Filter to only active coupons with active=true.

{
  "coupons": [
    {
      "id": "clxabc123",
      "code": "SAVE20",
      "type": "percentage",
      "value": 20,
      "usageLimit": 100,
      "usedCount": 3,
      "minAmount": 10,
      "expiresAt": "2025-12-31T23:59:59.000Z",
      "active": true,
      "createdAt": "2024-06-01T10:00:00.000Z",
      "updatedAt": "2024-06-01T10:00:00.000Z"
    }
  ]
}

curl "https://selley.io/api/v1/coupons?active=true" \
  -H "Authorization: Bearer YOUR_API_KEY"

Retrieve a single coupon by its ID.

curl "https://selley.io/api/v1/coupons/clxabc123" \
  -H "Authorization: Bearer YOUR_API_KEY"

Create a new coupon code. Supports percentage or fixed discounts, usage limits, and optional expiry dates.

curl -X POST "https://selley.io/api/v1/coupons" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "code": "SAVE20",
    "type": "percentage",
    "value": 20,
    "usageLimit": 100,
    "minAmount": 10,
    "expiresAt": "2025-12-31T23:59:59.000Z"
  }'

Update an existing coupon. Only the fields you provide will be modified.

curl -X PUT "https://selley.io/api/v1/coupons/clxabc123" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"active": false}'

Permanently delete a coupon. Returns success: true.

{ "success": true }

curl -X DELETE "https://selley.io/api/v1/coupons/clxabc123" \
  -H "Authorization: Bearer YOUR_API_KEY"

List all blacklist entries (IP, country, email) for your shop. Blocked visitors are prevented from viewing your storefront.

{
  "blacklists": [
    {
      "id": "clxabc123",
      "type": "IP",
      "value": "192.168.1.1",
      "reason": "Fraud attempt",
      "createdAt": "2024-06-01T10:00:00.000Z"
    },
    {
      "id": "clxdef456",
      "type": "COUNTRY",
      "value": "RU",
      "reason": null,
      "createdAt": "2024-06-02T09:00:00.000Z"
    }
  ]
}

curl "https://selley.io/api/v1/blacklists" \
  -H "Authorization: Bearer YOUR_API_KEY"

Retrieve a single blacklist entry by ID.

curl "https://selley.io/api/v1/blacklists/clxabc123" \
  -H "Authorization: Bearer YOUR_API_KEY"

Add a new entry to your shop's blacklist. type must be one of IP, COUNTRY, or EMAIL.

curl -X POST "https://selley.io/api/v1/blacklists" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "IP",
    "value": "1.2.3.4",
    "reason": "Chargeback fraud"
  }'

Update an existing blacklist entry's type, value, or reason.

curl -X PUT "https://selley.io/api/v1/blacklists/clxabc123" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"reason": "Updated reason"}'

Remove an entry from your blacklist. The visitor will no longer be blocked.

{ "success": true }

curl -X DELETE "https://selley.io/api/v1/blacklists/clxabc123" \
  -H "Authorization: Bearer YOUR_API_KEY"

List all categories for your account, sorted by sortOrder then creation date. Includes bound products and groups.

{
  "categories": [
    {
      "id": "clxabc123",
      "name": "Software",
      "sortOrder": 1,
      "unlisted": false,
      "products": [
        { "id": "...", "name": "Pro License", "productId": "rec_123" }
      ],
      "groups": [
        { "id": "...", "name": "Starter Bundle" }
      ],
      "createdAt": "2024-06-01T10:00:00.000Z"
    }
  ]
}

curl "https://selley.io/api/v1/categories" \
  -H "Authorization: Bearer YOUR_API_KEY"

Retrieve a single category with its bound products and groups.

curl "https://selley.io/api/v1/categories/clxabc123" \
  -H "Authorization: Bearer YOUR_API_KEY"

Create a new category and optionally bind products and/or groups to it.

curl -X POST "https://selley.io/api/v1/categories" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Software",
    "sortOrder": 1,
    "productIds": ["clxprod1", "clxprod2"]
  }'

Update category fields. Passing productIds or groupIds replaces the full bound list.

curl -X PUT "https://selley.io/api/v1/categories/clxabc123" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Digital Goods", "sortOrder": 0}'

Delete a category. Products and groups in the category are not deleted.

{ "success": true }

curl -X DELETE "https://selley.io/api/v1/categories/clxabc123" \
  -H "Authorization: Bearer YOUR_API_KEY"

List all product groups (bundles) for your account, including the products inside each group.

{
  "groups": [
    {
      "id": "clxabc123",
      "name": "Starter Bundle",
      "description": "Best value pack",
      "discountPercent": 15,
      "sortOrder": 0,
      "unlisted": false,
      "products": [
        { "id": "...", "name": "...", "productId": "rec_1", "price": 9.99 }
      ],
      "createdAt": "2024-06-01T10:00:00.000Z",
      "updatedAt": "2024-06-01T10:00:00.000Z"
    }
  ]
}

curl "https://selley.io/api/v1/groups" \
  -H "Authorization: Bearer YOUR_API_KEY"

Retrieve a single group by ID, including its products.

curl "https://selley.io/api/v1/groups/clxabc123" \
  -H "Authorization: Bearer YOUR_API_KEY"

Create a new product group with an optional bundle discount. Bind products by passing productIds.

curl -X POST "https://selley.io/api/v1/groups" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Starter Bundle",
    "discountPercent": 15,
    "productIds": ["clxprod1", "clxprod2"]
  }'

Update group fields. Passing productIds replaces the group's product list.

curl -X PUT "https://selley.io/api/v1/groups/clxabc123" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"discountPercent": 20}'

Delete a group. Products in the group are not deleted.

{ "success": true }

curl -X DELETE "https://selley.io/api/v1/groups/clxabc123" \
  -H "Authorization: Bearer YOUR_API_KEY"

List all customers who have placed orders in your shop. Sorted by creation date descending.

{
  "customers": [
    {
      "id": "clxabc123",
      "email": "[email protected]",
      "name": "Jane Smith",
      "phone": "+1234567890",
      "country": "US",
      "city": "New York",
      "totalOrders": 5,
      "totalSpent": 149.95,
      "lastOrderAt": "2024-06-10T15:00:00.000Z",
      "createdAt": "2024-01-05T08:00:00.000Z",
      "updatedAt": "2024-06-10T15:00:00.000Z"
    }
  ]
}

curl "https://selley.io/api/v1/customers?limit=50" \
  -H "Authorization: Bearer YOUR_API_KEY"

Retrieve a single customer by their ID including order stats and notes.

curl "https://selley.io/api/v1/customers/clxabc123" \
  -H "Authorization: Bearer YOUR_API_KEY"

List all recurring subscriptions for your shop. Includes product and customer details.

{
  "subscriptions": [
    {
      "id": "clxabc123",
      "productId": "clx_prod",
      "productName": "Pro Plan",
      "productProductId": "rec_pro",
      "customerId": "clx_cust",
      "customerEmail": "[email protected]",
      "status": "ACTIVE",
      "stripeSubscriptionId": "sub_xxxxxxxxxx",
      "stripeCustomerId": "cus_xxxxxxxxxx",
      "currentPeriodEnd": "2024-07-01T00:00:00.000Z",
      "createdAt": "2024-06-01T10:00:00.000Z",
      "canceledAt": null
    }
  ]
}

curl "https://selley.io/api/v1/subscriptions" \
  -H "Authorization: Bearer YOUR_API_KEY"

Retrieve a single subscription by ID including Stripe IDs and period end date.

curl "https://selley.io/api/v1/subscriptions/clxabc123" \
  -H "Authorization: Bearer YOUR_API_KEY"

Overview

Webhooks send a POST request to a URL you provide whenever certain events occur (e.g. order paid, product updated, subscription renewed). Configure webhooks in the dashboard under Developers → Webhooks: add your endpoint URL and select which events to subscribe to. At least one event must be selected per webhook.

Each request includes a JSON body with event, data (detailed payload), timestamp, and source. Your endpoint should respond with 2xx to acknowledge receipt. Non-2xx responses are logged and may be retried.

Event types

Events are grouped by category. Select the events you need when creating a webhook. The data object structure depends on the event category (see Payload structure below).

Request format

Every webhook is sent as POST to your URL with the following headers and body.

Headers

Top-level body fields

Your endpoint should respond with HTTP 200–299 to acknowledge receipt. Timeout is 15 seconds. Failed or non-2xx deliveries are logged in Developers → Webhook Logs where you can retry or view the payload.

Payload structure

The data object in each webhook is detailed and depends on the event category. Below are the full structures for Order, Subscription, Product, Query, and Feedback. All monetary values use the order/product currency; timestamps are Unix seconds unless noted.

{
  "event": "order:paid",
  "data": { /* see Order data below */ },
  "timestamp": "2024-06-15T14:32:00.000Z",
  "source": "selley"
}

Order data

For all order:* events, data includes order details, customer, product, gateway, fees, IP/location, status history, delivery info, and nested product block.

{
  "id": 238987,
  "uniqid": "593fe6-bd6c461fa4-f713f6",
  "type": "PRODUCT",
  "origin": "EMBED",
  "total": 45.77,
  "total_display": "33.99",
  "currency": "USD",
  "shop_id": 5436,
  "customer_email": "[email protected]",
  "customer_id": "cst_xxx",
  "product_id": "6894accbf05b6",
  "product_title": "Semi-Annual Alpha Package",
  "product_type": "SERVICE",
  "quantity": 1,
  "subscription_id": null,
  "gateway": "STRIPE",
  "status": "COMPLETED",
  "discount": 0,
  "fee_percentage": 4,
  "country": "GB",
  "ip": "2a00:23c7:...",
  "ip_info": { "country_code": "GB", "city": "London", "ISP": "...", "vpn": 0, "proxy": 0 },
  "created_at": 1772131826,
  "updated_at": 1772131943,
  "status_history": [...],
  "gateway_data": { "type": "STRIPE", "label": "Stripe", "payment_reference": "pi_xxx" },
  "product": { "uniqid": "...", "title": "...", "price_display": "...", "currency": "...", ... },
  "products": [{ "uniqid": "...", "title": "...", "quantity": 1, ... }],
  "delivery_info": { "downloads": [], "license_keys": [], "external_urls": [...], "tracking_codes": [] },
  "total_conversions": { "USD": 45.77, "EUR": "39.38", "crypto": { "BTC": "...", "ETH": "..." } }
}

Subscription data

For subscription:* events, data includes which product, amount, billing interval, subscription and Stripe IDs, period dates, trial info, and customer.

Product data

For product:created, product:edited, product:stock, product:dynamic, data includes product details, pricing, stock, gateways, and metadata.

Query & Feedback data

Query (query:created, query:replied): data includes id, ticket_id, shop_id, customer_email, customer_id, subject, message, status, reply_count, created_at, updated_at.

Feedback (feedback:received): data includes id, shop_id, product_id, product_title, order_id, customer_email, rating, comment, created_at.

Logs & Simulator

In the dashboard, Developers → Webhook Logs shows every delivery attempt: URL, event, response status, retry count, and created time. You can Send again to retry a failed delivery or open Payload to view the exact JSON that was sent.

Use the Simulator to send a test webhook to a configured URL: choose a webhook and an event, then trigger a delivery. The payload will match the structure documented above (with sample data). This helps verify your endpoint and payload handling without creating real orders or subscriptions.

Overview

The Embed lets you place a product or bundle (group) checkout on any external website. Customers see your product, choose quantity, and complete payment without leaving the host site. The flow is a modal that opens from your embed script; checkout and payment happen inside the modal.

Generate your embed code in the dashboard under Developers → Embed: select a product or group, optionally set button text and styles, then copy the script and HTML snippet. Add them to your site where you want the button to appear.

Usage

Include the Selley embed script on your page, then add a button or link with data-selley-store, and for a single product data-selley-product (product ID from your store), or for a bundle data-selley-group (group ID). When the user clicks, a modal opens with the product/group details and a gateway selection that leads to full checkout. No redirect to Selley is required; the flow stays in the modal.

Example: single product

<script src="https://your-domain.com/embed.js" async></script>
<button data-selley-store="your-store" data-selley-product="rec_abc123">
  Buy now
</button>

Example: bundle (group)

<button data-selley-store="your-store" data-selley-group="group_xyz">
  Buy bundle
</button>

Your store subdomain (e.g. your-store.myselley.com) or custom domain is used as the base. The embed script and CSS URL are shown in the dashboard Embed page.