B402 Bazaar 扩展

B402 Bazaar 是用于付费 API 和资源发现的可选扩展。商户可以在 x402 V2 Payment Payload 中附带机器可读 Metadata。结算成功后，B402 会保存 Metadata，供 B402 Bazaar 服务建立索引。

该扩展不会改变 Verify 或 Settle 逻辑。不传扩展时，支付流程仍然正常工作。

添加扩展

在 V2 Settle 请求的 paymentPayload.extensions.bazaar 中放置 Metadata。Verify 可以复用同一个 Payload，但只有成功的 Settle 才会保存 Metadata 供索引：

Code
{
  "body": {
    "x402Version": 2,
    "paymentPayload": {
      "x402Version": 2,
      "resource": {
        "url": "https://merchant.example.com/v1/weather/singapore",
        "description": "Paid weather forecast",
        "mimeType": "application/json"
      },
      "accepted": {},
      "payload": {},
      "extensions": {
        "bazaar": {
          "description": "Hourly weather forecast by city",
          "routeTemplate": "/v1/weather/:city",
          "info": {
            "input": {
              "type": "http",
              "method": "GET",
              "pathParams": {
                "city": "singapore"
              }
            }
          },
          "schema": {
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "type": "object",
            "properties": {
              "input": {
                "type": "object",
                "properties": {
                  "type": {
                    "const": "http"
                  },
                  "method": {
                    "enum": ["GET"]
                  }
                },
                "required": ["type", "method"]
              }
            },
            "required": ["input"]
          }
        }
      }
    },
    "paymentRequirements": {}
  }
}

字段

B402 会忽略未知扩展字段。Metadata 中不要包含 API Key、Secret、个人数据、签名或其他机密信息。

发布行为

• 仅在 V2 结算成功后记录 Metadata。
• Resource URL 来自 paymentPayload.resource.url。
• 同一商户和 Resource 的后续成功结算会更新对应 Listing。
• 缺少或传入无效的 info、schema 或 info.input.type 时，即使支付结算成功，Metadata 也不会被索引。
• 无效 Bazaar Metadata 不会使支付变为有效；Verify 和 Settle 仍执行全部 x402 校验。