@agenzo/token-cli 0.3.3 → 0.4.0

package/dist/index.js

@@ -560,6 +560,29 @@ var STATUS_ICONS = {
   warning: "\u26A0",
   loading: "\u280B"
 };
+var SPINNER_FRAMES = ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807", "\u280F"];
+function createSpinner(message, intervalMs = 60) {
+  let frameIdx = 0;
+  let currentMessage = message;
+  const render2 = () => {
+    process.stdout.write(`\r\x1B[K${SPINNER_FRAMES[frameIdx]} ${currentMessage}`);
+    frameIdx = (frameIdx + 1) % SPINNER_FRAMES.length;
+  };
+  render2();
+  const timer = setInterval(render2, intervalMs);
+  return {
+    update(msg) {
+      currentMessage = msg;
+    },
+    stop(type, finalMessage) {
+      clearInterval(timer);
+      process.stdout.write("\r\x1B[K");
+      if (type && finalMessage) {
+        console.log(Formatter.status(type, finalMessage));
+      }
+    }
+  };
+}
 var Formatter = class _Formatter {
   /** Get display width of a string (CJK characters count as 2) */
   static displayWidth(str) {
@@ -697,10 +720,6 @@ var PromptEngine = class {
     if (flagValue !== void 0) {
       return flagValue;
     }
-    const envKey = process.env.AGENZO_API_KEY;
-    if (envKey) {
-      return envKey;
-    }
     if (config.type === "password") {
       return password({ message: config.message, mask: "*" });
     }
@@ -747,6 +766,167 @@ async function collectPaymentMethodParams(type, flags) {
   return params;
 }
 
+// src/verb-schema.ts
+var CLI_NAME = "agenzo-token-cli";
+function wantsJsonSchema(argv = process.argv) {
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (a === "--format=json") return true;
+    if (a === "--format" && argv[i + 1] === "json") return true;
+  }
+  return false;
+}
+function emitSchema(schema) {
+  console.log(JSON.stringify(schema, null, 2));
+}
+function attachSchemaHelp(cmd, schema) {
+  const baseHelp = cmd.helpInformation.bind(cmd);
+  cmd.helpInformation = (context) => {
+    if (!wantsJsonSchema()) return baseHelp(context);
+    emitSchema(schema);
+    return "";
+  };
+  return cmd;
+}
+var pmAddSchema = {
+  cli: CLI_NAME,
+  noun: "payment-methods",
+  verb: "add",
+  description: "Add a payment method. --payment-brand evo (default): card binding + 3DS via Drop-in session. --payment-brand unionpay: UPI Agent Pay enrollment (requires --member); returns enroll_url, result arrives asynchronously via webhook.",
+  flags: {
+    "payment-brand": {
+      type: "string",
+      required: false,
+      default: "evo",
+      description: 'Payment brand: "evo" (default; 3DS/Drop-in binding) or "unionpay" (UPI Agent Pay enrollment)',
+      constraints: "evo | unionpay"
+    },
+    member: {
+      type: "string",
+      required: "conditional",
+      description: "End-user member id (required when --payment-brand unionpay; identifies which user this card belongs to). Ignored for evo payment brand.",
+      source: "from_previous_step",
+      from: "user.member_id or auth context"
+    },
+    mode: {
+      type: "string",
+      required: false,
+      default: "dropin",
+      description: 'Add mode (evo payment brand only): "manual" (CLI collects card details) or "dropin" (mint a Drop-in session)',
+      constraints: "manual | dropin"
+    },
+    email: {
+      type: "string",
+      required: false,
+      description: "Email for 3DS verification (evo/manual) or Drop-in session reference (evo/dropin)"
+    },
+    "no-poll": {
+      type: "bool",
+      required: false,
+      default: false,
+      description: "Dropin mode: mint session and exit immediately without polling verification status"
+    }
+  },
+  response: {
+    id: { type: "string", description: "Payment method id" },
+    status: {
+      type: "string",
+      description: "PENDING (awaiting enrollment/3DS) / ACTIVE / FAILED / DISABLED"
+    },
+    "payment-brand": { type: "string", description: "evo or unionpay" },
+    session_id: {
+      type: "string|absent",
+      description: "Drop-in session id (evo/dropin mode only)"
+    },
+    enroll_url: {
+      type: "string|absent",
+      description: "UnionPay enrollment URL (unionpay payment brand only) \u2014 user opens this to bind card"
+    },
+    correlation_id: {
+      type: "string|absent",
+      description: "src_correlation_id for tracking enrollment result (unionpay payment brand only)"
+    }
+  },
+  example: {
+    command: "agenzo-token-cli payment-methods add --payment-brand unionpay --member usr_abc123 --format json",
+    output_summary: "Returns enroll_url. User opens the URL in a browser to complete card binding. Result arrives async via webhook; poll with `payment-methods list` or `payment-methods get`."
+  },
+  error_recovery: {
+    PARAM_INVALID: "Fix the offending flag (--payment-brand must be evo|unionpay; --member required for unionpay).",
+    UPSTREAM_ERROR: "UPI enrollment initiation failed. Retry after a short delay (may be transient network).",
+    MEMBER_REQUIRED: "UnionPay payment brand requires --member <id>. Supply the end-user member identifier."
+  }
+};
+var pmListSchema = {
+  cli: CLI_NAME,
+  noun: "payment-methods",
+  verb: "list",
+  description: "List all payment methods for the authenticated developer",
+  flags: {},
+  response: {
+    payment_methods: {
+      type: "array",
+      description: "List of payment methods",
+      items: {
+        id: { type: "string", description: "Payment method id" },
+        status: { type: "string", description: "PENDING / ACTIVE / FAILED / DISABLED" },
+        payment_brand: { type: "string", description: "evo or unionpay" },
+        brand: { type: "string|null", description: "Card brand (Visa, Mastercard, UnionPay, etc.)" },
+        last4: { type: "string|null", description: "Last 4 digits of card" },
+        exp_month: { type: "int|null", description: "Expiry month" },
+        exp_year: { type: "int|null", description: "Expiry year" }
+      }
+    }
+  },
+  example: {
+    command: "agenzo-token-cli payment-methods list --format json",
+    output_summary: "Returns array of payment methods with status and card info."
+  }
+};
+var pmGetSchema = {
+  cli: CLI_NAME,
+  noun: "payment-methods",
+  verb: "get",
+  description: "Get a payment method by ID",
+  flags: {
+    id: { type: "string", required: true, description: "Payment method id", source: "from_previous_step", from: "payment_methods[].id" }
+  },
+  response: {
+    id: { type: "string", description: "Payment method id" },
+    status: { type: "string", description: "PENDING / ACTIVE / FAILED / DISABLED" },
+    payment_brand: { type: "string", description: "evo or unionpay" },
+    brand: { type: "string|null", description: "Card brand" },
+    last4: { type: "string|null", description: "Last 4 digits" },
+    exp_month: { type: "int|null", description: "Expiry month" },
+    exp_year: { type: "int|null", description: "Expiry year" }
+  },
+  example: {
+    command: "agenzo-token-cli payment-methods get --id pm_abc123 --format json",
+    output_summary: "Returns full payment method details including card info and status."
+  }
+};
+var pmDisableSchema = {
+  cli: CLI_NAME,
+  noun: "payment-methods",
+  verb: "disable",
+  description: "Disable a payment method (cascades revoke on active tokens)",
+  flags: {
+    id: { type: "string", required: true, description: "Payment method id to disable", source: "from_previous_step", from: "payment_methods[].id" }
+  },
+  response: {
+    id: { type: "string", description: "Payment method id" },
+    status: { type: "string", description: "DISABLED" }
+  },
+  example: {
+    command: "agenzo-token-cli payment-methods disable --id pm_abc123 --format json",
+    output_summary: "Disables the payment method and revokes any active tokens."
+  },
+  error_recovery: {
+    NOT_FOUND: "Payment method id does not exist. Check the id with `payment-methods list`.",
+    ALREADY_DISABLED: "Card is already disabled. No action needed."
+  }
+};
+
 // src/payment-methods/add.ts
 var MANUAL_POLL_INTERVAL_MS = 3e3;
 var MANUAL_POLL_TIMEOUT_MS = 15 * 60 * 1e3;
@@ -755,6 +935,13 @@ var DROPIN_POLL_TIMEOUT_MS = 30 * 60 * 1e3;
 var TERMINAL_STATUSES = /* @__PURE__ */ new Set(["ACTIVE", "FAILED", "EXPIRED"]);
 function registerAddCommand(parent, deps) {
   const cmd = parent.command("add").description("Add a payment method (manual 3DS or Drop-in session)").option("--api-key <key>", "API Key for authentication").option("--type <type>", "Payment method type (default: card)", "card").option(
+    "--payment-brand <brand>",
+    'Payment brand: "evo" (default; existing 3DS/Drop-in binding) or "unionpay" (UPI Agent Pay enrollment)',
+    "evo"
+  ).option(
+    "--member <id>",
+    "End-user member id (required when --payment-brand unionpay; identifies which end-user this card belongs to)"
+  ).option(
     "--mode <mode>",
     'Add mode: "manual" (default; CLI collects card details and polls 3DS) or "dropin" (mint a Drop-in session and poll until the user finishes adding the payment method in the browser)',
     "manual"
@@ -764,11 +951,26 @@ function registerAddCommand(parent, deps) {
   ).option("--card-number <number>", "Card number (manual mode only)").option("--expiry <mmyy>", "Expiry date (MMYY format) (manual mode only)").option("--cvv <cvv>", "Card CVV (manual mode only)").option(
     "--idempotency-key <key>",
     "Idempotency key forwarded verbatim as the Idempotency-Key header (manual mode only)"
+  ).option(
+    "--no-poll",
+    "Dropin mode: mint the session, print it, and exit immediately without polling verification status (for server/SDK-driven flows where the front-end completes the binding)"
   );
+  attachSchemaHelp(cmd, pmAddSchema);
   cmd.action(async () => {
     const opts = cmd.optsWithGlobals();
     const format = resolveFormat(opts.format);
     const isYes = Boolean(opts.yes);
+    const paymentBrand = String(opts.paymentBrand ?? "evo").toLowerCase();
+    if (paymentBrand !== "evo" && paymentBrand !== "unionpay") {
+      throw new CliError(
+        "PARAM_INVALID",
+        `Unknown --payment-brand "${opts.paymentBrand}". Expected "evo" or "unionpay".`
+      );
+    }
+    if (paymentBrand === "unionpay") {
+      await handleUnionpayPaymentBrand(deps, opts, format);
+      return;
+    }
     const mode = String(opts.mode ?? "manual").toLowerCase();
     if (mode !== "manual" && mode !== "dropin") {
       throw new CliError(
@@ -892,6 +1094,96 @@ async function handleManualMode(deps, opts, format, isYes) {
     }
   }
 }
+async function handleUnionpayPaymentBrand(deps, opts, format) {
+  const isYes = Boolean(opts.yes);
+  let member;
+  if (opts.member) {
+    member = String(opts.member);
+  } else if (isYes) {
+    throw new CliError(
+      "PARAM_INVALID",
+      "Missing required --member <id> for --payment-brand unionpay (required in --yes mode)"
+    );
+  } else {
+    member = await PromptEngine.resolveInput(void 0, {
+      message: "Member ID (end-user identity this card belongs to):",
+      validate: (v) => v.trim().length > 0 || "Member ID is required for --payment-brand unionpay"
+    });
+  }
+  const apiKey = await PromptEngine.resolveInput(opts.apiKey, {
+    message: "API Key:",
+    type: "password"
+  });
+  const email = await PromptEngine.resolveInput(opts.email, {
+    message: "Email:"
+  });
+  const result = await deps.apiClient.post(
+    "/payment-methods/create",
+    { type: "api-key", key: apiKey },
+    { type: "card", payment_brand: "unionpay", member_id: member, email }
+  );
+  if (!result.success) {
+    throw CliError.fromApi(result, { auth: "api-key" });
+  }
+  const pm = result.data;
+  notify(format, "success", "Card binding initiated");
+  const createdResult = {
+    data: pm,
+    text: () => Formatter.keyValue([
+      ["ID", pm.id],
+      ["Status", pm.status],
+      ["Enroll URL", pm.enroll_url ?? "-"],
+      ["Correlation ID", pm.correlation_id ?? "-"]
+    ])
+  };
+  const configManager = new ConfigManager();
+  await renderWithContext(createdResult, { format }, configManager);
+  notify(
+    format,
+    "info",
+    "Open the Enroll URL in a browser to complete card binding. Waiting for result..."
+  );
+  const UNIONPAY_POLL_INTERVAL_MS = 5e3;
+  const UNIONPAY_POLL_TIMEOUT_MS = 6e4;
+  const startTime = Date.now();
+  const spinner = format !== "json" ? createSpinner("Waiting for card binding result...") : null;
+  while (Date.now() - startTime < UNIONPAY_POLL_TIMEOUT_MS) {
+    await sleep(UNIONPAY_POLL_INTERVAL_MS);
+    const pollResult = await deps.apiClient.get(
+      `/payment-methods/${pm.id}`,
+      { type: "api-key", key: apiKey }
+    );
+    if (pollResult.success) {
+      const status = pollResult.data.status;
+      if (status === "ACTIVE") {
+        spinner?.stop();
+        notify(format, "success", "Payment method activated");
+        const activatedPm = pollResult.data;
+        const activatedResult = {
+          data: activatedPm,
+          text: () => {
+            const lines = [
+              ["ID", activatedPm.id],
+              ["Type", activatedPm.type ?? "card"],
+              ["Status", activatedPm.status]
+            ];
+            if (activatedPm.brand) lines.push(["Brand", activatedPm.brand]);
+            if (activatedPm.first6) lines.push(["First 6", activatedPm.first6]);
+            if (activatedPm.last4) lines.push(["Last 4", activatedPm.last4]);
+            return Formatter.keyValue(lines);
+          }
+        };
+        await renderWithContext(activatedResult, { format }, configManager);
+        return;
+      }
+      if (status === "FAILED") {
+        spinner?.stop("error", "Card binding failed.");
+        return;
+      }
+    }
+  }
+  spinner?.stop("info", "Timed out waiting for card binding result. Check status later with: payment-methods get " + pm.id);
+}
 async function handleDropinMode(deps, opts, format) {
   const apiKey = await PromptEngine.resolveInput(opts.apiKey, {
     message: "API Key:",
@@ -922,6 +1214,9 @@ async function handleDropinMode(deps, opts, format) {
     "info",
     "Use the Session ID to add the payment method in the browser via the Drop-in SDK"
   );
+  if (opts.poll === false) {
+    return;
+  }
   const finalPm = await pollVerificationStatus(deps.apiClient, apiKey, pmId, {
     intervalMs: DROPIN_POLL_INTERVAL_MS,
     timeoutMs: DROPIN_POLL_TIMEOUT_MS
@@ -1012,6 +1307,7 @@ function sleep(ms) {
 // src/payment-methods/list.ts
 function registerListCommand(parent, deps) {
   const cmd = parent.command("list").description("List payment methods").option("--api-key <key>", "API Key for authentication").option("--member <member_id>", "Filter by member ID");
+  attachSchemaHelp(cmd, pmListSchema);
   cmd.action(async () => {
     const opts = cmd.optsWithGlobals();
     const format = resolveFormat(opts.format);
@@ -1058,6 +1354,7 @@ function registerListCommand(parent, deps) {
 // src/payment-methods/get.ts
 function registerGetCommand(parent, deps) {
   const cmd = parent.command("get <pm_id>").description("Get a payment method by ID").option("--api-key <key>", "API key for authentication");
+  attachSchemaHelp(cmd, pmGetSchema);
   cmd.action(async (pmId) => {
     const opts = cmd.optsWithGlobals();
     const format = resolveFormat(opts.format);
@@ -1103,6 +1400,7 @@ function registerDisableCommand(parent, deps) {
     "--idempotency-key <key>",
     "Idempotency key forwarded verbatim as the Idempotency-Key header"
   );
+  attachSchemaHelp(cmd, pmDisableSchema);
   cmd.action(async (pmId) => {
     const opts = cmd.optsWithGlobals();
     const format = resolveFormat(opts.format);
@@ -1190,10 +1488,17 @@ function registerDropinCreateCommand(parent, deps) {
 
 // src/payment-methods/dropin-status.ts
 function registerDropinStatusCommand(parent, deps) {
-  const cmd = parent.command("dropin-status <pm_id>").description("Query the current Drop-in binding status for a payment method (single check)").option("--api-key <key>", "API Key for authentication");
-  cmd.action(async (pmId) => {
+  const cmd = parent.command("dropin-status [pm_id]").description("Query the current Drop-in binding status for a payment method (single check)").option("--api-key <key>", "API Key for authentication").option(
+    "--payment-method-id <id>",
+    "Payment method id to query (alternative to the positional <pm_id>, for programmatic callers that pass flags only)"
+  );
+  cmd.action(async (pmIdArg) => {
     const opts = cmd.optsWithGlobals();
     const format = resolveFormat(opts.format);
+    const pmId = await PromptEngine.resolveInput(
+      pmIdArg ?? opts.paymentMethodId,
+      { message: "Payment method id:" }
+    );
     const apiKey = await PromptEngine.resolveInput(opts.apiKey, {
       message: "API Key:",
       type: "password"
@@ -1225,6 +1530,7 @@ function registerDropinStatusCommand(parent, deps) {
 import { confirm, select as select2 } from "@inquirer/prompts";
 var DEFAULT_NT_FEE_CENTS = 500;
 var USDC_UNIT = 1e6;
+var DECIMAL_AMOUNT_RE = /^\d+(\.\d+)?$/;
 function mapTokenType(cliType) {
   if (cliType === "network-token") return "network_token";
   return cliType;
@@ -1302,14 +1608,23 @@ function formatPaymentToken(data) {
     lines.push(["Currency", String(vcn.currency || "USD")]);
     lines.push(["Status", String(vcn.status || data.status || "")]);
   } else if (type === "network_token") {
-    const nt = data.network_token ?? data;
-    lines.push(["Payment Token ID", String(data.id || nt.id || "")]);
-    lines.push(["Type", "Network Token"]);
-    lines.push(["Brand", String(nt.payment_brand || nt.brand || "")]);
-    lines.push(["ECI", String(nt.eci || "")]);
-    lines.push(["Cryptogram", String(nt.token_cryptogram || nt.cryptogram || "")]);
-    lines.push(["Expiry", String(nt.expiry_date || nt.expiry || "")]);
-    lines.push(["Value", String(nt.value || "")]);
+    if (data.status === "PENDING" && data.checkout_url) {
+      lines.push(["Payment Token ID", String(data.id || "")]);
+      lines.push(["Type", "Network Token"]);
+      lines.push(["Status", "PENDING"]);
+      lines.push(["Checkout URL", String(data.checkout_url || "")]);
+      lines.push(["Correlation ID", String(data.correlation_id || "")]);
+    } else {
+      const nt = data.network_token ?? data;
+      lines.push(["Payment Token ID", String(data.id || nt.id || "")]);
+      lines.push(["Type", "Network Token"]);
+      lines.push(["Brand", String(nt.payment_brand || nt.brand || "")]);
+      const eci = nt.eci || "";
+      if (eci) lines.push(["ECI", String(eci)]);
+      lines.push(["Cryptogram", String(nt.token_cryptogram || nt.cryptogram || "")]);
+      lines.push(["Expiry", String(nt.expiry_date || nt.expiry || "")]);
+      lines.push(["Token Number", String(nt.value || "")]);
+    }
   } else if (type === "x402") {
     const x402 = data.x402 ?? data;
     lines.push(["Payment Token ID", String(data.id || x402.id || "")]);
@@ -1329,8 +1644,13 @@ function formatCentsToUsd(cents) {
   const remainder = cents % 100;
   return `${dollars}.${String(remainder).padStart(2, "0")}`;
 }
+function isValidUnionpayAmount(amountStr) {
+  const trimmed = amountStr.trim();
+  if (!DECIMAL_AMOUNT_RE.test(trimmed)) return false;
+  return parseFloat(trimmed) > 0;
+}
 function registerCreateCommand(parent, deps) {
-  const cmd = parent.command("create").description("Create a payment token (VCN / Network Token / X402)").option("--api-key <key>", "API Key for authentication").option("--type <type>", "Token type: vcn | network-token | x402").option("--payment-method-id <id>", "Payment method ID to use").option("--card <last4>", "Match payment method by last 4 digits").option("--member <member_id>", "Member ID").option("--amount <amount>", "Amount in USD (VCN / X402)").option("--currency <currency>", "Currency (default: USD)").option("--pay-to <address>", "Pay-to address (X402)").option("--nonce <nonce>", "Nonce (X402)").option("--network <network>", "Network (X402)").option("--deadline <deadline>", "Deadline (X402)").option("--external-tx-id <id>", "External transaction ID").option(
+  const cmd = parent.command("create").description("Create a payment token (VCN / Network Token / X402)").option("--api-key <key>", "API Key for authentication").option("--type <type>", "Token type: vcn | network-token | x402").option("--payment-method-id <id>", "Payment method ID to use").option("--card <last4>", "Match payment method by last 4 digits").option("--member <member_id>", "Member ID").option("--amount <amount>", "Amount in USD (VCN / X402)").option("--currency <currency>", "Currency (default: USD)").option("--pay-to <address>", "Pay-to address (X402)").option("--nonce <nonce>", "Nonce (X402)").option("--network <network>", "Network (X402)").option("--deadline <deadline>", "Deadline (X402)").option("--external-tx-id <id>", "External transaction ID").option("--recipient-first-name <name>", "UnionPay network token: recipient first name (order delivery details)").option("--recipient-last-name <name>", "UnionPay network token: recipient last name (order delivery details)").option("--recipient-email <email>", "UnionPay network token: recipient email (recipient-email or recipient-phone required)").option("--recipient-phone <phone>", "UnionPay network token: recipient phone (recipient-email or recipient-phone required)").option("--unionpay-amount <amount>", 'UnionPay network token: intent amount as a decimal string, e.g. "174.58"').option(
     "--idempotency-key <key>",
     "Idempotency key forwarded verbatim as the Idempotency-Key header"
   );
@@ -1357,6 +1677,24 @@ function registerCreateCommand(parent, deps) {
       card: opts.card,
       yes: isYes
     });
+    let selectedPmPaymentBrand;
+    if (serverType === "network_token") {
+      const pmResult = await deps.apiClient.get(
+        `/payment-methods/${paymentMethodId}`,
+        { type: "api-key", key: apiKey }
+      );
+      if (!pmResult.success) {
+        throw CliError.fromApi(pmResult, { auth: "api-key" });
+      }
+      selectedPmPaymentBrand = pmResult.data.payment_brand;
+      if (selectedPmPaymentBrand === "unionpay" && opts.card && !opts.paymentMethodId) {
+        throw new CliError(
+          "PARAM_INVALID",
+          "UnionPay cards must be selected via --payment-method-id; --card (last4 matching) is not supported for unionpay payment brand."
+        );
+      }
+    }
+    const isUnionpayNetworkToken = serverType === "network_token" && selectedPmPaymentBrand === "unionpay";
     let member = opts.member;
     if (!member && !isYes) {
       const memberInput = await PromptEngine.resolveInput(void 0, {
@@ -1405,10 +1743,66 @@ function registerCreateCommand(parent, deps) {
         typeBody.currency = opts.currency;
       }
     } else if (serverType === "network_token") {
-      feeCents = await fetchNetworkTokenFee(deps.apiClient, apiKey);
-      freezeAmountCents = feeCents;
-      feeDisplay = `$${formatCentsToUsd(feeCents)}`;
-      freezeDisplay = feeDisplay;
+      if (isUnionpayNetworkToken) {
+        const unionpayAmountStr = await PromptEngine.resolveInput(
+          opts.unionpayAmount,
+          {
+            message: "UnionPay intent amount (USD, e.g. 174.58):",
+            validate: (v) => isValidUnionpayAmount(v) || 'Amount must be a positive decimal, e.g. "174.58"'
+          }
+        );
+        if (!isValidUnionpayAmount(unionpayAmountStr)) {
+          throw new CliError(
+            "PARAM_INVALID",
+            `Invalid --unionpay-amount "${unionpayAmountStr}". Expected a positive decimal string, e.g. "174.58".`
+          );
+        }
+        typeBody.unionpay_amount = unionpayAmountStr.trim();
+        typeBody.recipient_first_name = await PromptEngine.resolveInput(
+          opts.recipientFirstName,
+          {
+            message: "Recipient first name:",
+            validate: (v) => v.trim().length > 0 || "Recipient first name is required"
+          }
+        );
+        typeBody.recipient_last_name = await PromptEngine.resolveInput(
+          opts.recipientLastName,
+          {
+            message: "Recipient last name:",
+            validate: (v) => v.trim().length > 0 || "Recipient last name is required"
+          }
+        );
+        let recipientEmail = opts.recipientEmail;
+        let recipientPhone = opts.recipientPhone;
+        if (!recipientEmail && !recipientPhone) {
+          if (isYes) {
+            throw new CliError(
+              "PARAM_INVALID",
+              "--recipient-email or --recipient-phone is required for unionpay network tokens."
+            );
+          }
+          const emailInput = await PromptEngine.resolveInput(void 0, {
+            message: "Recipient email (optional, press Enter to skip and enter phone instead):",
+            validate: () => true
+          });
+          if (emailInput.trim()) {
+            recipientEmail = emailInput.trim();
+          } else {
+            const phoneInput = await PromptEngine.resolveInput(void 0, {
+              message: "Recipient phone (required, since no email was given):",
+              validate: (v) => v.trim().length > 0 || "Recipient email or phone is required"
+            });
+            recipientPhone = phoneInput.trim();
+          }
+        }
+        if (recipientEmail) typeBody.recipient_email = recipientEmail;
+        if (recipientPhone) typeBody.recipient_phone = recipientPhone;
+      } else {
+        feeCents = await fetchNetworkTokenFee(deps.apiClient, apiKey);
+        freezeAmountCents = feeCents;
+        feeDisplay = `$${formatCentsToUsd(feeCents)}`;
+        freezeDisplay = feeDisplay;
+      }
     } else if (serverType === "x402") {
       const amountStr = await PromptEngine.resolveInput(opts.amount, {
         message: "Amount (USDC):",
@@ -1450,10 +1844,15 @@ function registerCreateCommand(parent, deps) {
       typeBody.deadline = deadlineNum;
     }
     if (!isYes) {
-      const warningLines = [`Freeze: ${freezeDisplay}`, `Fee: ${feeDisplay}`];
-      notify(format, "warning", warningLines.join(" | "));
+      if (freezeDisplay !== void 0 && feeDisplay !== void 0) {
+        const warningLines = [`Freeze: ${freezeDisplay}`, `Fee: ${feeDisplay}`];
+        notify(format, "warning", warningLines.join(" | "));
+      } else if (isUnionpayNetworkToken) {
+        notify(format, "info", "UnionPay: no fee (clearing network not yet enabled)");
+      }
+      const confirmMessage = isUnionpayNetworkToken ? "Proceed with UnionPay network token request?" : "Proceed with token creation?";
       const confirmed = await confirm({
-        message: "Proceed with token creation?",
+        message: confirmMessage,
         default: true
       });
       if (!confirmed) {
@@ -1510,6 +1909,42 @@ function registerCreateCommand(parent, deps) {
       }
     };
     await renderWithContext(commandResult, { format }, configManager);
+    if (isUnionpayNetworkToken) {
+      notify(
+        format,
+        "info",
+        "Open the Checkout URL to complete the UnionPay payment verification. Waiting for result..."
+      );
+      const UNIONPAY_TOKEN_POLL_INTERVAL_MS = 5e3;
+      const UNIONPAY_TOKEN_POLL_TIMEOUT_MS = 6e4;
+      const pollStart = Date.now();
+      const tokenId = tokenData.id;
+      while (Date.now() - pollStart < UNIONPAY_TOKEN_POLL_TIMEOUT_MS) {
+        await new Promise((resolve) => setTimeout(resolve, UNIONPAY_TOKEN_POLL_INTERVAL_MS));
+        const pollResult = await deps.apiClient.get(
+          `/payment-tokens/${tokenId}`,
+          { type: "api-key", key: apiKey }
+        );
+        if (pollResult.success) {
+          const status = pollResult.data.status;
+          if (status === "ACTIVE") {
+            notify(format, "success", "UnionPay network token activated!");
+            if (!pollResult.data.type) pollResult.data.type = serverType;
+            const activatedResult = {
+              data: pollResult.data,
+              text: () => formatPaymentToken(pollResult.data)
+            };
+            await renderWithContext(activatedResult, { format }, configManager);
+            return;
+          }
+          if (status === "FAILED") {
+            notify(format, "error", "UnionPay network token failed.");
+            return;
+          }
+        }
+      }
+      notify(format, "info", `Timed out waiting for token activation. Check status later with: payment-tokens get ${tokenId}`);
+    }
   });
 }
 async function checkVcnFeatureEnabled(apiClient, apiKey) {