用途:通过 Crossmint Agent Checkouts API,从商品 URL 购买商品,使用一次性存储的服务器端 API Key 授权(无需用户 JWT)。运行于生产环境,成功结账会下达真实付费订单。
主要能力:检查并存储 API Key;创建、查询、更新、删除买家资料;创建结账并驱动至完成;轮询状态;回答待处理的用户操作;取消结账。所有调用经 scripts/checkout.mjs(Node.js 18+,无依赖),从技能目录运行,每条命令输出 JSON。Key 读取自 $CROSSMINT_API_KEY,否则读 ~/.crossmint/agent-checkouts.json(0600),主机按 Key 前缀自动选择。
用法:先 node scripts/checkout.mjs key-status 检查;未配置则用 set-key sk_production_... 存储(仅用户提供时)。创建买家资料:profile-create,传入姓名、邮箱、地址(administrativeAreaCode 为 ISO 3166-2,如 US-CA;countryCode 为 ISO 3166-1 alpha-2),记下返回的 buyerProfileId。创建结账:checkout-create --url ... --request "..." --buyer-profile <id> --max-cost ... --currency ...。--url 必填;--request 描述变体、数量、运输方式、支付方式与账单偏好;--max-cost 为硬上限,超支会以 max_cost_exceeded 失败,务必设置。随后循环 checkout-get <id>,处理 queued/running(等待约 1.5 秒再轮询)、awaiting_user_action(按 responseSchema 填值后用 checkout-respond <checkoutId> <actionId> --values '{...}' 提交)、succeeded(读取收据 total、merchantOrderId、confirmationUrl)、failed、cancelled。可用 checkout-cancel 取消。
限制与注意:真实资金,无确认动作也无可撤销。提交完成购买的操作会立即扣款并下单;须在调用前向用户展示总额并获明确批准。responseSchema 每次不同,不可硬编码字段名,须在 expiresAt 前提交。不创建支付方式;若要求卡片信息,只提供 agent card 或一次性/虚拟卡号,禁止可复用 PAN。切勿回显完整 Key。