跳转到内容
本站为社区维护的非官方中文翻译,与 Cloudflare, Inc. 无关联。本站不提供账户登录,请勿在任何非官方站点输入您的 Cloudflare 账户信息。官方文档:developers.cloudflare.com

付款验证

最后更新 查看 MarkdownAgent 设置

源站会在 PAYMENT-CONTEXT 标头中收到付款授权。在提供付费内容之前,请验证此上下文。

验证上下文

该标头包含一个 JSON Web Token (JWT)。请使用推荐的 JWT 库进行验证。

仅使用固定的 JSON Web Key Set (JWKS) ↗。要求 Ed25519 签名,并根据端点的 Cache-Control 标头缓存密钥。

不要在未验证签名的情况下解析令牌。JWT 验证失败时,应拒绝请求。

推荐的库包括:

语言 库
JavaScript、TypeScript 和 Cloudflare Workers jose
Python PyJWT with cryptography
Java Nimbus JOSE + JWT
Go github.com/golang-jwt/jwt/v5
Rust jsonwebtoken

读取固定声明

固定定价使用 x402 exact scheme。以下解码示例授权 25,000 原子单位对应一个 audience:

{
	"iat": 1770000000,
	"nbf": 1770000000,
	"exp": 1770000120,
	"aud": "https://api.example.com/premium-data",
	"scheme": "exact",
	"amount": "25000"
}

不要为固定定价设置 PAYMENT-SETTLEMENT。Monetization Gateway 会结算已签署的金额。

读取可变声明

可变定价使用 x402 upto scheme。amount 声明包含已授权的最大值。

以下解码示例授权最高 100,000 原子单位:

{
	"iat": 1770000000,
	"nbf": 1770000000,
	"exp": 1770000120,
	"aud": "https://api.example.com/generate",
	"scheme": "upto",
	"amount": "100000"
}

计算实际金额,满足 0 <= actual <= authorized maximum。金额以原子单位表示。

如果实际金额超过已授权最大值,Monetization Gateway 会改为结算已授权最大值。如果指定金额为零,则不会结算任何内容。

报告可变结算

仅在成功的 upto 响应中设置 PAYMENT-SETTLEMENT。请在发送响应标头之前设置它。

使用包含实际金额字符串的 JSON 值。以下独立示例报告 1,000,000 原子单位:

{ "amount": "1000000" }

当响应状态为 400 或更高时,不要设置 PAYMENT-SETTLEMENT。不要创建 PAYMENT-RESPONSE 标头。

Monetization Gateway 会在结算后创建付款收据。它会从发送给买方的响应中移除 PAYMENT-SETTLEMENT。

这篇文档对您有帮助吗?