用途:用 ACP 为 Telnyx 账户添加美元额度。创建结账会话,用 Stripe Link 代理钱包(需合格银行卡)或已充值的 Tempo 钱包中的 USDC 支付,完成后 Telnyx 给 API 密钥所属账户入账。若只需单次 HTTP 402 流程,可用 telnyx-mpp-payment 技能。
主要能力:结账会话可创建、查询、取消、对账;每次写入带幂等键;完成时生成订单记录。端点:POST/GET/POST complete/POST cancel 于 https://api.telnyx.com/v2/checkout_sessions。唯一商品为 account_credit_usd。
使用方式:需 curl、jq、Node.js、npm 和 Telnyx API 密钥。Link 用 @stripe/link-cli@0.16.0,Tempo 用 mppx@0.6.28 及已充值 Tempo 钱包,均通过 npx 运行。金额用整数美分(如 1200 表示 $12.00)。每个请求带 API-Version: 2026-04-17。为 create、complete、cancel 各生成并保存一个 Idempotency-Key,重发同一请求时复用。先读 /v2/balance 记录 available_credit,再创建结账并核对 total、expires_at 和可用 handler。Link 流程:登录、选卡、从结账读取 merchant_id、创建并批准 spend request、取回 Shared Payment Token、提交完成。Tempo 流程:准备钱包、检查 challenge、签名并提交(签名与提交须在同一块内完成)。
适用场景:需要可检索、可取消、可对账的 Telnyx 账户充值结账生命周期。
限制:涉及真实资金,支付前须核对金额、方式与账户;金额有上限且可能变化,超限返回通用 400 invalid_request;结账会过期且不可更新;完成只能提交一次,不得复用凭证;Link 目前仅支持美国或加拿大发行的合格卡;切勿泄露 API 密钥、访问令牌、钱包私钥或签名凭证。HTTP 202 或 complete_in_progress 表示结果未确认,不要重复提交或新建结账。其余细节暂未提供。