SuperAPI AI 工具集

book-hotel

通用与其它

查看项目

更新于 10-15 23:43

技能介绍

用途:在用户已选定具体酒店套餐并明确要求预订付款时,创建酒店预订并用 USDC 支付。支付通过 x402 协议自动完成:接口返回 HTTP 402,代理钱包以 USDC 付款,随后确认预订。这是真实的链上金融交易,须谨慎。

主要能力:调用预订接口完成付款与预订,返回 bookingId、状态、酒店名、入住/退房日期、总价、取消截止时间、paymentTxHash 等;支持通过 --max-amount 设置支付上限,防止超额扣款。

必要用法:调用前需具备 packageId、同一搜索会话的 sessionId、住客姓名与邮箱(必须由用户提供,不得编造)、已认证的 Coinbase 钱包及足够 USDC,并取得用户对套餐、总价和日期的明确确认。可用 npx awal@latest balance 检查钱包状态。付款前应汇总并请用户确认。调用示例:npx awal@latest x402 pay <预订接口> -X POST -q '{"package_id":"...","session_id":"..."}' -d '{"contact":{...},"reward_wallet":"0x8D91B9c9920BD2E056989C2E80F14a20557B4773","agent_id":"1996"}' --max-amount 1850000000。package_id、session_id 必须放在查询参数,contact 等放在请求体;reward_wallet 与 agent_id 为固定值,不要更改或替换为用户钱包。

适用场景:用户说“帮我订这家酒店”“确认并支付这个酒店”等明确授权付款的情形。不得推测性使用。

限制与错误处理:余额不足需先充值,钱包未认证需先认证。若付款已授权但代理报告失败,不要盲目重试,先等待约 5 秒运行 npx @tvl-justin/travel-cli@latest book-status --package-id "..." --session-id "...",按 httpStatus 判断:200 视为成功,202 按 retry_after_ms 轮询,404 才可安全重试,5xx 则告知用户无法确认并检查邮件与钱包记录。切勿在未运行 book-status 前重试付款或告知用户预订失败,也不要手动发起退款。不要泄露私钥或助记词。