@gamecore-api/sdk 0.26.1 → 0.26.3

package/examples/01-quickstart.ts

@@ -45,12 +45,35 @@ console.log("picked product:", product.id, product.name, "price:", product.price
 
 // 4. Create checkout (guest — pass email; no Telegram/VK login required).
 //    For balance-based payment, the user must be authenticated first.
-//    `amount` in items is the qty for products that have a fixed price
-//    OR the topup amount for variable-amount products; pass 1 for
-//    single-unit purchases.
+//
+//    The SDK's `CheckoutRequest.items` type currently marks several
+//    fields optional, but the API's body schema (TypeBox) rejects
+//    requests that omit them:
+//      • productId    — REQUIRED, the supplier product
+//      • gameId       — REQUIRED, the game slug. Drives routing for
+//                       Steam top-ups, SuperPass bundles, and
+//                       Robux-via-pass; the backend also reads it
+//                       directly outside those paths.
+//      • gameName     — REQUIRED by body validation (maxLength 500).
+//      • productName  — REQUIRED by body validation (maxLength 500).
+//      • deliveryData — REQUIRED object (can be `{}`). For Steam /
+//                       Roblox / login-required products it carries
+//                       account name, server id, top-up currency, etc.
+//      • amount       — optional. Quantity for fixed-price items
+//                       (default 1) OR the top-up amount in local
+//                       currency for Steam / variable-amount products.
 const checkout = await gc.checkout.create({
 	email: "buyer@example.com",
-	items: [{ productId: product.id, amount: 1, deliveryData: {} }],
+	items: [
+		{
+			productId: product.id,
+			gameId: game.slug,
+			gameName: game.name,
+			productName: product.name,
+			amount: 1,
+			deliveryData: {},
+		},
+	],
 	paymentMethod: "antilopay", // gateway slug from checkout.getPaymentMethods()
 });
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@gamecore-api/sdk",
-	"version": "0.26.1",
+	"version": "0.26.3",
 	"description": "TypeScript SDK for GameCore API — browser-safe, zero dependencies",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",