用途:通过 HTTP 402 Payment Required 流程,用 Stripe Link(由合格银行卡支撑的代理钱包)或 Tempo 钱包的 USDC,为 Telnyx 账户添加美元余额。
主要能力:所有充值都使用端点 https://api.telnyx.com/v2/machine-payments/account-credit 。首次请求会返回 402,这是流程的正常环节;随后由 Link CLI 或 mppx 读取挑战、完成支付并携带支付凭证重试。成功的新充值返回 HTTP 201,响应含 Telnyx 交易 ID、account_id、金额、币种、receipt_reference、状态与创建时间;重复的已完成支付可能返回 200 且 created 为 false。
使用方式:需 Node.js、npm、curl 和 Telnyx API key。环境变量包括 TELNYX_API_KEY、MPP_AMOUNT_USD、MPP_ENDPOINT;Link 还需 LINK_PAYMENT_METHOD_ID、LINK_NETWORK_ID、LINK_SPEND_REQUEST_ID。Link 侧使用 npx --yes @stripe/link-cli@0.11.0,先 auth login 登录,列出支付方式,取新的 402 挑战并用 mpp decode 解码得到 networkId,再创建并批准 spend-request(金额以美分为单位),最后用 mpp pay 支付。Tempo 侧使用 mppx,先 account create 创建主网钱包并充值 USDC,再用 mppx --include --network mainnet --account 提交支付。
核验:查看支付响应是否 status: "settled"、created: true 及 Payment-Receipt 头;可用 GET /v2/payment/crypto_transactions 及单笔交易接口查询,用 GET /v2/balance 确认余额;Link 可 spend-request retrieve,Tempo 可在钱包或交易查看器查 receipt_reference 哈希。
限制与安全:支付涉及真实资金,需事先核对金额、方式与账户。请求体只发送 amount_usd,正数且不超过两位小数,不发送 account_id,账户由 API key 决定;单笔上限可能变化,账户须处于可用状态且支持机器支付。批准的金额与账户不可更改,Link spend request、Shared Payment Token、Tempo 凭证和已完成挑战都不可复用;Link 目前仅支持美国或加拿大发行的合格卡。切勿打印、提交或发送 API key、访问令牌、钱包私钥及 Authorization: Payment。未提供的信息暂未说明。