@itpay/cli 2.0.1 → 2.0.3

package/README.md

@@ -8,7 +8,7 @@ itpay readyz
 itpay docs show quickstart
 ```
 
-This test release defaults to `https://test.itpay.ai`. Set
+The CLI defaults to the production app at `https://app.itpay.ai`. Set
 `ITPAY_BACKEND_URL` only when intentionally using another backend.
 
 ## Commands
@@ -36,7 +36,7 @@ This test release defaults to `https://test.itpay.ai`. Set
 - `itpay pay --checkout <id> --method alipay|wechatpay` — CLI escape hatch for operator/manual testing only; normal buyer flow opens the ItPay checkout page first
 - `itpay order <order_id>` — read one V3 order
 - `itpay orders [--limit 20] [--status <status>]` — list account-scoped orders (requires `ITPAY_BEARER_TOKEN`)
-- `itpay refund --order <id> --payment-intent <id> --amount-minor <n> --currency <code>` — request a refund
+- `itpay refund --order <id> [--reason <reason>]` — request a refund with an account-scoped `ITPAY_BEARER_TOKEN`; payment and amount are derived by the backend
 
 ## Hosts
 
@@ -54,7 +54,7 @@ Aliases: `tg` and `openclaw-telegram` map to `telegram`; `feishu_im` and `fs` ma
 
 ## Environment
 
-- `ITPAY_BACKEND_URL` — optional backend override (test-release default `https://test.itpay.ai`)
+- `ITPAY_BACKEND_URL` — optional backend override (default `https://app.itpay.ai`)
 - `ITPAY_BEARER_TOKEN` — account-scoped session token (only needed for `orders`)
 - `ITPAY_AGENT_DEVICE_ID` — agent device id, used for cart/service execution quota identity and `client_context`
 - `ITPAY_CURRENCY` — checkout currency (default `CNY`)

package/dist/src/client/backend.js

@@ -62,8 +62,8 @@ export class BackendClient {
         return this.http.get(`/v1/me/orders?${qs}`, bearer ? { bearer } : {});
     }
     // --- Refund ---
-    createRefund(orderID, input, idempotencyKey) {
-        const options = idempotencyKey ? { idempotencyKey } : {};
+    createRefund(orderID, input, bearer, idempotencyKey) {
+        const options = { bearer, ...(idempotencyKey ? { idempotencyKey } : {}) };
         return this.http.post(`/v1/orders/${encodeURIComponent(orderID)}/refunds`, input, options);
     }
     // --- Service Execution ---

package/dist/src/commands/refund.js

@@ -7,14 +7,11 @@ import { hintFor } from "../render/status.js";
 import { resolveOutput } from "../render/sink.js";
 export async function runRefund(backend, config, options) {
     const out = resolveOutput(options.output);
-    const request = {
-        payment_intent_id: options.paymentIntentID,
-        amount_minor: options.amountMinor,
-        currency: options.currency,
-        ...(options.reason ? { reason: options.reason } : {}),
-        ...(options.createdBy ? { created_by: options.createdBy } : {}),
-    };
-    const refund = await backend.createRefund(options.orderID, request, await operationID(config, `refund.create:${options.orderID}:${options.paymentIntentID}:${options.amountMinor}:${options.currency}`));
+    if (!config.bearerToken) {
+        throw new Error("ITPAY_BEARER_TOKEN is required to refund an account order");
+    }
+    const reason = options.reason?.trim() || "buyer_requested";
+    const refund = await backend.createRefund(options.orderID, { reason }, config.bearerToken, await operationID(config, `refund.create:${options.orderID}:${reason}`));
     out(renderRefund(refund) + "\n");
     out(`hint: ${hintFor("refund", refund.status)}\n`);
 }

package/dist/src/main.js

@@ -24,7 +24,7 @@ program
     .name("itpay")
     .description("V3 ItPay CLI — checkout, payment, order, and refund commands")
     .option("--agent-type <type>", "agent runtime type used for device enrollment and client-specific guidance")
-    .version("2.0.1");
+    .version("2.0.3");
 function withHost(value) {
     const host = normalizeHost(value);
     if (!host) {
@@ -428,21 +428,13 @@ program
     .command("refund")
     .description("Create a V3 refund request for an order")
     .requiredOption("--order <order_id>")
-    .requiredOption("--payment-intent <payment_intent_id>")
-    .requiredOption("--amount-minor <n>", "amount in minor units", (value) => Number.parseInt(value, 10))
-    .requiredOption("--currency <currency>")
     .option("--reason <reason>")
-    .option("--created-by <created_by>")
     .action(async (options) => {
     const config = loadConfig();
     const backend = newBackendClient(config);
     const refundOptions = {
         orderID: options.order,
-        paymentIntentID: options.paymentIntent,
-        amountMinor: options.amountMinor,
-        currency: options.currency,
         ...(options.reason ? { reason: options.reason } : {}),
-        ...(options.createdBy ? { createdBy: options.createdBy } : {}),
     };
     await runRefund(backend, config, refundOptions);
 });

package/dist/src/state/config.js

@@ -8,9 +8,9 @@ import { HttpClient } from "../client/http.js";
 import { BackendClient } from "../client/backend.js";
 import { DeviceAuthority } from "./device_authority.js";
 import { OperationJournal } from "./operation_journal.js";
-export const DEFAULT_BASE_URL = "https://test.itpay.ai";
-export const CLI_VERSION = "2.0.1";
-export const API_CONTRACT_REVISION = "sha256:2c2829f4618c47bc505efc0ded853cf639d775585ba13aa23012197e39efa31f";
+export const DEFAULT_BASE_URL = "https://app.itpay.ai";
+export const CLI_VERSION = "2.0.3";
+export const API_CONTRACT_REVISION = "sha256:d2870f3ee6fa4ee8a0a3ee75ae272a1a476935aae824123cf46607d62168f1f2";
 const CART_SESSION_DEFAULT_DIR = ".itpay-v3";
 const CART_SESSION_FILENAME = "cart.json";
 const OPERATION_JOURNAL_FILENAME = "operations.json";

package/docs/agent/buyer/install-and-setup.json

@@ -29,7 +29,7 @@
   "env_vars": {
     "ITPAY_BACKEND_URL": {
       "required": false,
-      "description": "Optional V3 backend override. This test release defaults to https://test.itpay.ai.",
+      "description": "Optional V3 backend override. The CLI defaults to https://app.itpay.ai.",
       "examples": ["http://localhost:18080", "https://test.itpay.ai"]
     },
     "ITPAY_BEARER_TOKEN": {
@@ -63,7 +63,7 @@
     "lark": "Use --host lark --target <open_id>. Same as feishu format."
   },
   "agent_rules": [
-    "Use the built-in https://test.itpay.ai test-release default; override ITPAY_BACKEND_URL only for another deliberate environment.",
+    "Use the built-in https://app.itpay.ai production default; override ITPAY_BACKEND_URL only for another deliberate environment.",
     "Install globally with npm install -g @itpay/cli for all hosts.",
     "Identify the real runtime with --agent-type or ITPAY_AGENT_TYPE; do not invent a new type to obtain quota.",
     "Run `itpay install` without arguments to see all supported targets.",

package/docs/agent/buyer/orders-refunds.json

@@ -13,10 +13,10 @@
   "required_state": {
     "needs": [
       "order_id for order or refund flows",
-      "payment_intent_id for refund flows"
+      "ITPAY_BEARER_TOKEN for refund flows"
     ],
     "optional": [
-      "ITPAY_BEARER_TOKEN for account order listing"
+      "refund reason; defaults to buyer_requested"
     ]
   },
   "commands": [
@@ -37,7 +37,7 @@
     },
     {
       "intent": "request a refund for an order",
-      "command": "itpay refund --order <order_id> --payment-intent <payment_intent_id> --amount-minor <n> --currency CNY --reason buyer_requested",
+      "command": "ITPAY_BEARER_TOKEN=<account_scoped_token> itpay refund --order <order_id> --reason buyer_requested",
       "success_signal": "refund request id and refund status are printed"
     }
   ],
@@ -45,7 +45,7 @@
     "Use itpay order when you already know the exact order id.",
     "Use itpay orders only with an account-scoped bearer token. Missing or wrong scope should be surfaced as an error, not guessed away.",
     "Treat itpay pay as an operator escape hatch. The checkout handoff remains the preferred path.",
-    "Refund amounts are minor units. For CNY, 100 means CNY 1.00.",
+    "Never ask the user or client to supply refund payment ids, amount, currency, buyer id, or actor; the backend derives them from the owned order.",
     "The refund response is the current source of truth; do not assume success locally."
   ],
   "forbidden": [

package/docs/agent/buyer/quickstart.json

@@ -12,7 +12,7 @@
   "required_state": {
     "needs": [
       "itpay CLI installed",
-      "test-release API at https://test.itpay.ai, or an intentional ITPAY_BACKEND_URL override",
+      "production app at https://app.itpay.ai, or an intentional ITPAY_BACKEND_URL override",
       "catalog item id, variant id, and offer id from `itpay catalog list`",
       "real agent runtime type supplied through --agent-type or ITPAY_AGENT_TYPE"
     ],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@itpay/cli",
-  "version": "2.0.1",
+  "version": "2.0.3",
   "description": "ItPay CLI for V3 checkout, payment, order, refund, and agent-facing render flows.",
   "type": "module",
   "bin": {

package/skills/itpay-buyer/SKILL.md

@@ -20,7 +20,7 @@ itpay readyz
 itpay docs show quickstart
 ```
 
-This test release defaults to `https://test.itpay.ai`. Set `ITPAY_BACKEND_URL`
+The CLI defaults to `https://app.itpay.ai`. Set `ITPAY_BACKEND_URL`
 only for an intentional override.
 
 Every commerce flow must identify the real runtime. Pass the global option