Developer Reference & API

REST API & Integrations

Integrate KAS Play diamond fulfillment, catalog pricing, and player verification directly into your bots, websites, and automated services.

Swagger API Docs Postman Collection Chat with Specialist on Telegram Partner Hub

Base URLhttps://reseller-api.kasplay.kascambodia.com/api/v1

AuthenticationX-API-Key: ••••••••••••••••••••••••

Fulfillment SpeedReal-time (~2-5 seconds)

DEVELOPER PARTNERSHIP ONBOARDING

Activate Developer REST API License ($39.99)

Generate secret production API keys, configure IP whitelisting, and integrate automated ~2-5s diamond fulfillment directly into your Telegram bots, Discord bots, or custom applications. Includes 1 Month Free Growth Plan ($5.00 value).

~2-5s Auto-Delivery Player ID Nickname Validation Pre-funded Wallet Auto-Debit

View All Partner Models

1.Auth 2.Profile 3.Catalog 4.Verify 5.Order 6.Idempotency

1. Authentication & Security

Every request to the Reseller REST API must include your secret API Key passed via the X-API-Key HTTP header. Authenticate your requests using either X-API-Key: kp_live_... or standard RFC 6750 Authorization: Bearer kp_live_....

Interactive OpenAPI 3.0

Swagger UI Live Sandbox

Test API endpoints directly in your browser. Features real-time parameter validation, schema specifications, and persistent x-api-key session memory.

Open Swagger UI

Postman v2.1

Standalone Postman Collection

Import ready-to-use requests into Postman Desktop or CLI. Includes environment variables, automated pre-request auth scripts, and sample payloads for all 13 reseller endpoints.

Download Collection JSON

Authentication cURL Header ExamplesBASH

# Option 1: Using X-API-Key header (Recommended)
curl -s "https://reseller-api.kasplay.kascambodia.com/api/v1/reseller/v1/profile" \
  -H "X-API-Key: kp_live_your_api_key_here"

# Option 2: Using Authorization Bearer token
curl -s "https://reseller-api.kasplay.kascambodia.com/api/v1/reseller/v1/profile" \
  -H "Authorization: Bearer kp_live_your_api_key_here"

2. Account Profile & Balance

Fetches your reseller profile, assigned tier name, wholesale markup %, and current USD wallet balance available for instant fulfillment.

cURL RequestBASH

curl -s "https://reseller-api.kasplay.kascambodia.com/api/v1/reseller/v1/profile" \
  -H "X-API-Key: kp_live_your_api_key_here"

Success Response200 OK

{
  "statusCode": 200,
  "message": "Success",
  "data": {
    "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "name": "Vong Gaming Store",
    "email": "partner@vongstore.com",
    "balanceUsd": 250,
    "tier": {
      "name": "Starter",
      "discountLabel": "Basic Wholesale Discounts on Every Sale"
    },
    "apiKey": {
      "name": "Production Server 1",
      "keyPrefix": "kp_live_7a91...",
      "rateLimitPerMin": 60
    }
  }
}

3. Wholesale Catalog & Prices

Returns all live games, active packages, required input fields, and your customized wholesale prices in USD.

cURL Request — List Games (Lightweight Listing)BASH

curl -s "https://reseller-api.kasplay.kascambodia.com/api/v1/reseller/v1/games?page=1&limit=50" \
  -H "X-API-Key: kp_live_your_api_key_here"

Success Response — List Games200 OK

{
  "statusCode": 200,
  "message": "Success",
  "data": {
    "total": 218,
    "page": 1,
    "limit": 50,
    "totalPages": 5,
    "hasMore": true,
    "items": [
      {
        "id": "f6c5c6f0-42ab-40ee-8a30-80e8bb88af79",
        "name": "Mobile Legends (Cambodia)",
        "slug": "mobile-legends-cambodia",
        "imageUrl": "https://kasplay-bucket.s3.ap-southeast-1.amazonaws.com/prod/admin/catalog-games/2026-09-02/mobile-legends-cambodia.webp",
        "canValidate": true,
        "packageCount": 49
      },
      {
        "id": "73e74dbf-6aea-4029-aa11-a010f96436af",
        "name": "Telegram Premium",
        "slug": "telegram-premium",
        "imageUrl": "https://kasplay-bucket.s3.ap-southeast-1.amazonaws.com/prod/admin/catalog-games/2026-09-02/telegram-premium.webp",
        "canValidate": false,
        "packageCount": 3
      }
    ]
  }
}

priceUsd(Wholesale Rate)

The discounted wholesale cost debited from your wallet upon order placement.

retailPriceUsd(Suggested Retail / MSRP)

KAS Play public store price. Use this to benchmark prices, calculate profit margins, or show gamer discounts.

⚡ Performance Tip: For high-speed catalog browsing, use GET /api/v1/reseller/v1/games (~15 KB) and load packages on-demand via GET /games/:slug/packages (~3 KB).

4. Player ID Verification

Verify in-game nicknames in real-time before charging customers or placing orders.

Pass the slug (or id) obtained from GET /api/v1/reseller/v1/games.

cURL RequestBASH

curl -s -X POST "https://reseller-api.kasplay.kascambodia.com/api/v1/reseller/v1/validate-player" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: kp_live_your_api_key_here" \
  -d '{
  "slug": "mobile-legends-cambodia",
  "fields": {
    "player_id": "370635223",
    "server_id": "3753"
  }
}'

Request BodyJSON

{
  "slug": "mobile-legends-cambodia",
  "fields": {
    "player_id": "370635223",
    "server_id": "3753"
  }
}

Success Response201 CREATED

{
  "statusCode": 201,
  "message": "Success",
  "data": {
    "valid": true,
    "playerName": "勁ɢʜᴏsᴛ",
    "playerId": "370635223",
    "region": "Cambodia"
  }
}

5. Place Order (Instant Auto-Debit)

Places a top-up order, auto-debits your wholesale price from your pre-funded wallet, and dispatches instant fulfillment in ~2-5 seconds.

cURL Request — Game Top-UpBASH

curl -s -X POST "https://reseller-api.kasplay.kascambodia.com/api/v1/reseller/v1/order" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: kp_live_your_api_key_here" \
  -d '{
  "packageId": "51fd36aa-5698-4333-8101-2d71cf4eeca4",
  "fields": {
    "player_id": "370635223",
    "server_id": "3753"
  },
  "idempotencyKey": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d"
}'

Request BodyJSON

{
  "packageId": "51fd36aa-5698-4333-8101-2d71cf4eeca4",
  "fields": {
    "player_id": "370635223",
    "server_id": "3753"
  },
  "idempotencyKey": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d"
}

Success Response200 OK

{
  "statusCode": 200,
  "message": "Order placed successfully",
  "data": {
    "orderId": "ord-8f9210c4-9a1b-4d7a",
    "status": "completed",
    "productName": "14 Diamonds",
    "priceUsd": 0.25,
    "remainingBalanceUsd": 248.75,
    "createdAt": "2026-09-18T10:15:00.000Z"
  }
}

6. Idempotency & Safety Protection

To prevent accidental double-billing in network retry events, send a unique string in the idempotencyKey parameter. Always provide an idempotencyKey in your JSON body or pass Idempotency-Key header to prevent duplicate orders or double debits on network timeouts.

HTTP Header ExampleHTTP

Idempotency-Key: 9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d

Standard Error Response Format400 BAD REQUEST

{
  "statusCode": 400,
  "error": "Bad Request",
  "message": "Insufficient wallet balance to place this order"
}

Status	Error Type	Meaning & Suggested Action
400	Bad Request	Missing fields, invalid game parameters, or invalid format.
401	Unauthorized	Invalid or disabled API key. Check headers.
402	Payment Required	Insufficient balance in your partner wallet. Top up to proceed.
404	Not Found	Game, package, or order ID not found.
429	Too Many Requests	Rate limit exceeded for this API key. Wait 60s before retrying.
500	Internal Error	Upstream provider error. Safe to retry with same idempotencyKey.