API 参考

公共数据结构#

PaymentPayload#

Buyer 签名后通过 X-PAYMENT header(base64 编码)传递给 Seller,Seller 原样透传给 Facilitator。

参数类型必传描述
x402VersionInteger协议版本,如 2
resourceObject受保护资源描述
resource.urlString受保护资源的 URL
resource.descriptionString资源描述
resource.mimeTypeString预期响应的 MIME 类型
acceptedObjectBuyer 选中的支付方式(从 accepts 数组中选取),结构同 PaymentRequirements
payloadObject签名数据
payload.signatureStringEIP-712 签名。exact: EOA 签名;aggr_deferred: session key 签名
payload.authorizationObjectEIP-3009 授权参数

Authorization#

参数类型必传描述
fromString付款方钱包地址
toString收款方钱包地址
valueString支付金额(原子单位,带精度)
validAfterString授权生效的 Unix 时间戳
validBeforeString授权过期的 Unix 时间戳
nonceString32 字节随机 nonce(0x hex 格式,防重放)

PaymentRequirements#

同时用作 402 响应 accepts 数组元素和 paymentPayload.accepted

参数类型必传描述
schemeString结算方案:exact / aggr_deferred
networkStringCAIP-2 链标识,如 eip155:196
amountString支付金额(原子单位字符串)
assetString代币合约地址
payToString收款钱包地址
maxTimeoutSecondsInteger支付完成的最大超时时间(秒)
extraObjectscheme 特有扩展。aggr_deferred 时 Buyer 在 accepted.extra.sessionCert 中携带 session key 证书