源站会在 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。