B402 支付

端点https://web3.binance.com/build

下载Schema

获取 B402 V2 支持配置

返回当前 Developer Portal Project 可用的 x402 V2 支付配置。商户使用响应构造 HTTP 402 Payment Requirements，完整复制所选 Kind 的 extra，并定期刷新缓存。

POST

/api/v2/b402/supported

https://web3.binance.com/build

获取 B402 V2 支持配置 › 授权

这是一个签名端点，必须在请求头中包含签名。了解如何生成有效签名，请参考认证。

获取 B402 V2 支持配置 › 请求头

X-OC-APIKEY

string · 必须

Binance Web3 API 颁发的用于鉴权的 API Key。

示例： your-api-key-here

X-OC-TIMESTAMP

string · 必须

当前 UTC 时间，ISO 8601 格式，精确到毫秒，例如 2026-05-11T10:08:57.715Z。

示例： 2026-05-11T10:08:57.715Z

X-OC-SIGN

string · 必须

请求签名（Base64 编码）。

示例： Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

允许的时间偏差（毫秒），默认值 5000，最大值 60000。

示例： 5000

X-OC-NONCE

string

唯一请求标识符，用于防重放攻击；省略时使用 X-OC-SIGN 代替。

示例： unique-nonce-string

获取 B402 V2 支持配置 › 请求体

body

object · 必须

获取 B402 V2 支持配置 › 响应

成功返回支持配置，或返回 B402 业务错误 Envelope。

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object
	type = object

Properties for Variant 1:

status

string

示例： OK

type

string

示例： GENERAL

code

string

示例： 000000000

errorData

string | null

示例： null

object

subData

object | null

示例： null

params

object | null

示例： null

POST/api/v2/b402/supported

curl --request POST \
  --url https://web3.binance.com/build/api/v2/b402/supported \
  --header 'Content-Type: application/json' \
  --header 'X-OC-APIKEY: <string>' \
  --header 'X-OC-SIGN: <string>' \
  --header 'X-OC-TIMESTAMP: <string>' \
  --data '{
  "body": {}
}'

示例请求体

{
  "body": {}
}

json

示例响应

{
  "status": "OK",
  "type": "GENERAL",
  "code": "000000000",
  "errorData": null,
  "data": {
    "kinds": [
      {
        "x402Version": 2,
        "scheme": "exact",
        "network": "eip155:56",
        "extra": {
          "name": "Token Name",
          "version": "1",
          "assetTransferMethod": "eip3009",
          "signerAddress": "0x3333333333333333333333333333333333333333",
          "spenderAddress": "0x4444444444444444444444444444444444444444"
        }
      }
    ],
    "extensions": [],
    "signers": {
      "eip155:*": [
        "0x3333333333333333333333333333333333333333"
      ]
    }
  },
  "subData": null,
  "params": null
}

json

application/json

验证 B402 V2 支付

在不花费资金或广播交易的情况下，链下验证 x402 V2 支付授权。Portal 商户身份由已鉴权 API Key 的 Project 解析，请勿传入 merchantId。验证失败仍返回 HTTP 200，并通过 data.isValid=false 表示。

POST

/api/v2/b402/verify

https://web3.binance.com/build

验证 B402 V2 支付 › 授权

这是一个签名端点，必须在请求头中包含签名。了解如何生成有效签名，请参考认证。

验证 B402 V2 支付 › 请求头

X-OC-APIKEY

string · 必须

Binance Web3 API 颁发的用于鉴权的 API Key。

示例： your-api-key-here

X-OC-TIMESTAMP

string · 必须

当前 UTC 时间，ISO 8601 格式，精确到毫秒，例如 2026-05-11T10:08:57.715Z。

示例： 2026-05-11T10:08:57.715Z

X-OC-SIGN

string · 必须

请求签名（Base64 编码）。

示例： Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

允许的时间偏差（毫秒），默认值 5000，最大值 60000。

示例： 5000

X-OC-NONCE

string

唯一请求标识符，用于防重放攻击；省略时使用 X-OC-SIGN 代替。

示例： unique-nonce-string

验证 B402 V2 支付 › 请求体

object · 必须

x402Version

integer · enum · 必须

枚举值:

object · 必须

x402Version

integer · enum · 必须

枚举值:

object · 必须

url

string · uri · 必须

示例： https://merchant.example.com/weather

description

string

示例： Premium weather report

mimeType

string

示例： application/json

object · 必须

scheme

string · enum · 必须

枚举值:

exact

upto

network

string · 必须

示例： eip155:56

amount

string · pattern: ^[0-9]+$ · 必须

示例： 1000000

asset

string · 必须

示例： 0x1111111111111111111111111111111111111111

payTo

string · 必须

示例： 0x2222222222222222222222222222222222222222

maxTimeoutSeconds

integer · 必须

示例： 300

object · 必须

name

string · 必须

示例： Token Name

version

string · 必须

示例： 1

assetTransferMethod

string · enum · 必须

枚举值:

eip3009

permit2-exact

permit2-upto

signerAddress

string · 必须

示例： 0x3333333333333333333333333333333333333333

spenderAddress

string | null

示例： 0x4444444444444444444444444444444444444444

object · 必须

signature

string · 必须

示例： 0xabcdef...

object

from

string · 必须

示例： 0x5555555555555555555555555555555555555555

to

string · 必须

示例： 0x2222222222222222222222222222222222222222

value

string · 必须

示例： 1000000

validAfter

string · 必须

示例： 0

validBefore

string · 必须

示例： 1780000000

nonce

string · 必须

示例： 0x0000000000000000000000000000000000000000000000000000000000000001

object

object · 必须

token

string · 必须

示例： 0x1111111111111111111111111111111111111111

amount

string · 必须

示例： 1000000

from

string · 必须

示例： 0x5555555555555555555555555555555555555555

spender

string · 必须

示例： 0x4444444444444444444444444444444444444444

nonce

string · 必须

示例： 123456789

deadline

string · 必须

示例： 1780000000

object · 必须

to

string · 必须

示例： 0x2222222222222222222222222222222222222222

validAfter

string · 必须

示例： 0

facilitator

string | null

示例： 0x3333333333333333333333333333333333333333

object

object · 必须

示例： {"input":{"type":"http","method":"GET"}}

object · 必须

示例： {"$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"]}

routeTemplate

string

示例： /v1/weather/:city

description

string

示例： Hourly weather forecast by city

object · 必须

scheme

string · enum · 必须

枚举值:

exact

upto

network

string · 必须

示例： eip155:56

amount

string · pattern: ^[0-9]+$ · 必须

示例： 1000000

asset

string · 必须

示例： 0x1111111111111111111111111111111111111111

payTo

string · 必须

示例： 0x2222222222222222222222222222222222222222

maxTimeoutSeconds

integer · 必须

示例： 300

object · 必须

name

string · 必须

示例： Token Name

version

string · 必须

示例： 1

assetTransferMethod

string · enum · 必须

枚举值:

eip3009

permit2-exact

permit2-upto

signerAddress

string · 必须

示例： 0x3333333333333333333333333333333333333333

spenderAddress

string | null

示例： 0x4444444444444444444444444444444444444444

验证 B402 V2 支付 › 响应

Verify 结果，或 B402 业务错误 Envelope。

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object
	type = object

Properties for Variant 1:

status

string

示例： OK

type

string

示例： GENERAL

code

string

示例： 000000000

errorData

string | null

示例： null

object

subData

object | null

示例： null

params

object | null

示例： null

POST/api/v2/b402/verify

curl --request POST \
  --url https://web3.binance.com/build/api/v2/b402/verify \
  --header 'Content-Type: application/json' \
  --header 'X-OC-APIKEY: <string>' \
  --header 'X-OC-SIGN: <string>' \
  --header 'X-OC-TIMESTAMP: <string>' \
  --data '
{
  "body": {
    "x402Version": 2,
    "paymentPayload": {
      "x402Version": 2,
      "resource": {
        "url": "https://merchant.example.com/weather"
      },
      "accepted": {
        "scheme": "exact",
        "network": "eip155:56",
        "amount": "1000000",
        "asset": "0x1111111111111111111111111111111111111111",
        "payTo": "0x2222222222222222222222222222222222222222",
        "maxTimeoutSeconds": 300,
        "extra": {
          "name": "Token Name",
          "version": "1",
          "assetTransferMethod": "eip3009",
          "signerAddress": "0x3333333333333333333333333333333333333333"
        }
      },
      "payload": {
        "signature": "0xabcdef..."
      }
    },
    "paymentRequirements": {
      "scheme": "exact",
      "network": "eip155:56",
      "amount": "1000000",
      "asset": "0x1111111111111111111111111111111111111111",
      "payTo": "0x2222222222222222222222222222222222222222",
      "maxTimeoutSeconds": 300,
      "extra": {
        "name": "Token Name",
        "version": "1",
        "assetTransferMethod": "eip3009",
        "signerAddress": "0x3333333333333333333333333333333333333333"
      }
    }
  }
}
'

示例请求体

{
  "body": {
    "x402Version": 2,
    "paymentPayload": {
      "x402Version": 2,
      "resource": {
        "url": "https://merchant.example.com/weather"
      },
      "accepted": {
        "scheme": "exact",
        "network": "eip155:56",
        "amount": "1000000",
        "asset": "0x1111111111111111111111111111111111111111",
        "payTo": "0x2222222222222222222222222222222222222222",
        "maxTimeoutSeconds": 300,
        "extra": {
          "name": "Token Name",
          "version": "1",
          "assetTransferMethod": "eip3009",
          "signerAddress": "0x3333333333333333333333333333333333333333"
        }
      },
      "payload": {
        "signature": "0xabcdef..."
      }
    },
    "paymentRequirements": {
      "scheme": "exact",
      "network": "eip155:56",
      "amount": "1000000",
      "asset": "0x1111111111111111111111111111111111111111",
      "payTo": "0x2222222222222222222222222222222222222222",
      "maxTimeoutSeconds": 300,
      "extra": {
        "name": "Token Name",
        "version": "1",
        "assetTransferMethod": "eip3009",
        "signerAddress": "0x3333333333333333333333333333333333333333"
      }
    }
  }
}

json

示例响应

{
  "status": "OK",
  "type": "GENERAL",
  "code": "000000000",
  "errorData": null,
  "data": {
    "isValid": true,
    "payer": "0x5555555555555555555555555555555555555555",
    "invalidReason": "invalid_payload",
    "invalidMessage": null
  },
  "subData": null,
  "params": null
}

json

application/json

结算 B402 V2 支付

将已验证的 x402 V2 授权提交到链上。该操作可能转移真实资金且不可逆。 permit2-upto 需要传入最小单位的 settleAmount。业务失败仍返回 HTTP 200，并通过 data.success=false 表示；重试前必须先对账非空 Transaction Hash。

POST

/api/v2/b402/settle

https://web3.binance.com/build

结算 B402 V2 支付 › 授权

这是一个签名端点，必须在请求头中包含签名。了解如何生成有效签名，请参考认证。

结算 B402 V2 支付 › 请求头

X-OC-APIKEY

string · 必须

Binance Web3 API 颁发的用于鉴权的 API Key。

示例： your-api-key-here

X-OC-TIMESTAMP

string · 必须

当前 UTC 时间，ISO 8601 格式，精确到毫秒，例如 2026-05-11T10:08:57.715Z。

示例： 2026-05-11T10:08:57.715Z

X-OC-SIGN

string · 必须

请求签名（Base64 编码）。

示例： Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

允许的时间偏差（毫秒），默认值 5000，最大值 60000。

示例： 5000

X-OC-NONCE

string

唯一请求标识符，用于防重放攻击；省略时使用 X-OC-SIGN 代替。

示例： unique-nonce-string

结算 B402 V2 支付 › 请求体

object · 必须

x402Version

integer · enum · 必须

枚举值:

object · 必须

x402Version

integer · enum · 必须

枚举值:

object · 必须

url

string · uri · 必须

示例： https://merchant.example.com/weather

description

string

示例： Premium weather report

mimeType

string

示例： application/json

object · 必须

scheme

string · enum · 必须

枚举值:

exact

upto

network

string · 必须

示例： eip155:56

amount

string · pattern: ^[0-9]+$ · 必须

示例： 1000000

asset

string · 必须

示例： 0x1111111111111111111111111111111111111111

payTo

string · 必须

示例： 0x2222222222222222222222222222222222222222

maxTimeoutSeconds

integer · 必须

示例： 300

object · 必须

name

string · 必须

示例： Token Name

version

string · 必须

示例： 1

assetTransferMethod

string · enum · 必须

枚举值:

eip3009

permit2-exact

permit2-upto

signerAddress

string · 必须

示例： 0x3333333333333333333333333333333333333333

spenderAddress

string | null

示例： 0x4444444444444444444444444444444444444444

object · 必须

signature

string · 必须

示例： 0xabcdef...

object

from

string · 必须

示例： 0x5555555555555555555555555555555555555555

to

string · 必须

示例： 0x2222222222222222222222222222222222222222

value

string · 必须

示例： 1000000

validAfter

string · 必须

示例： 0

validBefore

string · 必须

示例： 1780000000

nonce

string · 必须

示例： 0x0000000000000000000000000000000000000000000000000000000000000001

object

object · 必须

token

string · 必须

示例： 0x1111111111111111111111111111111111111111

amount

string · 必须

示例： 1000000

from

string · 必须

示例： 0x5555555555555555555555555555555555555555

spender

string · 必须

示例： 0x4444444444444444444444444444444444444444

nonce

string · 必须

示例： 123456789

deadline

string · 必须

示例： 1780000000

object · 必须

to

string · 必须

示例： 0x2222222222222222222222222222222222222222

validAfter

string · 必须

示例： 0

facilitator

string | null

示例： 0x3333333333333333333333333333333333333333

object

object · 必须

示例： {"input":{"type":"http","method":"GET"}}

object · 必须

routeTemplate

string

示例： /v1/weather/:city

description

string

示例： Hourly weather forecast by city

object · 必须

scheme

string · enum · 必须

枚举值:

exact

upto

network

string · 必须

示例： eip155:56

amount

string · pattern: ^[0-9]+$ · 必须

示例： 1000000

asset

string · 必须

示例： 0x1111111111111111111111111111111111111111

payTo

string · 必须

示例： 0x2222222222222222222222222222222222222222

maxTimeoutSeconds

integer · 必须

示例： 300

object · 必须

name

string · 必须

示例： Token Name

version

string · 必须

示例： 1

assetTransferMethod

string · enum · 必须

枚举值:

eip3009

permit2-exact

permit2-upto

signerAddress

string · 必须

示例： 0x3333333333333333333333333333333333333333

spenderAddress

string | null

示例： 0x4444444444444444444444444444444444444444

settleAmount

string · pattern: ^[0-9]+$

示例： 750000

结算 B402 V2 支付 › 响应

Settle 结果，或 B402 业务错误 Envelope。

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object
	type = object

Properties for Variant 1:

status

string

示例： OK

type

string

示例： GENERAL

code

string

示例： 000000000

errorData

string | null

示例： null

object

subData

object | null

示例： null

params

object | null

示例： null

POST/api/v2/b402/settle

curl --request POST \
  --url https://web3.binance.com/build/api/v2/b402/settle \
  --header 'Content-Type: application/json' \
  --header 'X-OC-APIKEY: <string>' \
  --header 'X-OC-SIGN: <string>' \
  --header 'X-OC-TIMESTAMP: <string>' \
  --data '
{
  "body": {
    "x402Version": 2,
    "paymentPayload": {
      "x402Version": 2,
      "resource": {
        "url": "https://merchant.example.com/weather"
      },
      "accepted": {
        "scheme": "exact",
        "network": "eip155:56",
        "amount": "1000000",
        "asset": "0x1111111111111111111111111111111111111111",
        "payTo": "0x2222222222222222222222222222222222222222",
        "maxTimeoutSeconds": 300,
        "extra": {
          "name": "Token Name",
          "version": "1",
          "assetTransferMethod": "eip3009",
          "signerAddress": "0x3333333333333333333333333333333333333333"
        }
      },
      "payload": {
        "signature": "0xabcdef..."
      }
    },
    "paymentRequirements": {
      "scheme": "exact",
      "network": "eip155:56",
      "amount": "1000000",
      "asset": "0x1111111111111111111111111111111111111111",
      "payTo": "0x2222222222222222222222222222222222222222",
      "maxTimeoutSeconds": 300,
      "extra": {
        "name": "Token Name",
        "version": "1",
        "assetTransferMethod": "eip3009",
        "signerAddress": "0x3333333333333333333333333333333333333333"
      }
    }
  }
}
'

示例请求体

{
  "body": {
    "x402Version": 2,
    "paymentPayload": {
      "x402Version": 2,
      "resource": {
        "url": "https://merchant.example.com/weather"
      },
      "accepted": {
        "scheme": "exact",
        "network": "eip155:56",
        "amount": "1000000",
        "asset": "0x1111111111111111111111111111111111111111",
        "payTo": "0x2222222222222222222222222222222222222222",
        "maxTimeoutSeconds": 300,
        "extra": {
          "name": "Token Name",
          "version": "1",
          "assetTransferMethod": "eip3009",
          "signerAddress": "0x3333333333333333333333333333333333333333"
        }
      },
      "payload": {
        "signature": "0xabcdef..."
      }
    },
    "paymentRequirements": {
      "scheme": "exact",
      "network": "eip155:56",
      "amount": "1000000",
      "asset": "0x1111111111111111111111111111111111111111",
      "payTo": "0x2222222222222222222222222222222222222222",
      "maxTimeoutSeconds": 300,
      "extra": {
        "name": "Token Name",
        "version": "1",
        "assetTransferMethod": "eip3009",
        "signerAddress": "0x3333333333333333333333333333333333333333"
      }
    }
  }
}

json

示例响应

{
  "status": "OK",
  "type": "GENERAL",
  "code": "000000000",
  "errorData": null,
  "data": {
    "success": true,
    "transaction": "0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
    "payer": "0x5555555555555555555555555555555555555555",
    "network": "eip155:56",
    "amount": "1000000",
    "errorReason": null,
    "errorMessage": null,
    "extensions": {}
  },
  "subData": null,
  "params": null
}

json

application/json

获取 B402 V1 支持配置

V1 兼容接口，新接入应使用 V2。V1 返回 x402Version=1、不同支付方式对应的 facilitatorAddress，以及 V1 Signer Map 结构。

POST

/api/v1/b402/supported

https://web3.binance.com/build

获取 B402 V1 支持配置 › 授权

这是一个签名端点，必须在请求头中包含签名。了解如何生成有效签名，请参考认证。

获取 B402 V1 支持配置 › 请求头

X-OC-APIKEY

string · 必须

Binance Web3 API 颁发的用于鉴权的 API Key。

示例： your-api-key-here

X-OC-TIMESTAMP

string · 必须

当前 UTC 时间，ISO 8601 格式，精确到毫秒，例如 2026-05-11T10:08:57.715Z。

示例： 2026-05-11T10:08:57.715Z

X-OC-SIGN

string · 必须

请求签名（Base64 编码）。

示例： Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

允许的时间偏差（毫秒），默认值 5000，最大值 60000。

示例： 5000

X-OC-NONCE

string

唯一请求标识符，用于防重放攻击；省略时使用 X-OC-SIGN 代替。

示例： unique-nonce-string

获取 B402 V1 支持配置 › 请求体

body

object · 必须

获取 B402 V1 支持配置 › 响应

V1 支持配置，或 B402 业务错误 Envelope。

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object
	type = object

Properties for Variant 1:

status

string

示例： OK

type

string

示例： GENERAL

code

string

示例： 000000000

errorData

string | null

示例： null

object

subData

object | null

示例： null

params

object | null

示例： null

POST/api/v1/b402/supported

curl --request POST \
  --url https://web3.binance.com/build/api/v1/b402/supported \
  --header 'Content-Type: application/json' \
  --header 'X-OC-APIKEY: <string>' \
  --header 'X-OC-SIGN: <string>' \
  --header 'X-OC-TIMESTAMP: <string>' \
  --data '{
  "body": {}
}'

示例请求体

{
  "body": {}
}

json

示例响应

{
  "status": "OK",
  "type": "GENERAL",
  "code": "000000000",
  "errorData": null,
  "data": {
    "kinds": [
      {
        "x402Version": 1,
        "scheme": "exact",
        "network": "eip155:56",
        "extra": {
          "name": "Token Name",
          "version": "1",
          "assetTransferMethod": "eip3009",
          "facilitatorAddress": "0x3333333333333333333333333333333333333333"
        }
      }
    ],
    "extensions": [],
    "signers": {
      "eip155:56": [
        "0x3333333333333333333333333333333333333333"
      ]
    }
  },
  "subData": null,
  "params": null
}

json

application/json

验证 B402 V1 支付

V1 链下 Verify 兼容接口，新接入应使用 V2。Portal 商户身份由 API Key Project 解析，因此外部请求不传 merchantId。

POST

/api/v1/b402/verify

https://web3.binance.com/build

验证 B402 V1 支付 › 授权

这是一个签名端点，必须在请求头中包含签名。了解如何生成有效签名，请参考认证。

验证 B402 V1 支付 › 请求头

X-OC-APIKEY

string · 必须

Binance Web3 API 颁发的用于鉴权的 API Key。

示例： your-api-key-here

X-OC-TIMESTAMP

string · 必须

当前 UTC 时间，ISO 8601 格式，精确到毫秒，例如 2026-05-11T10:08:57.715Z。

示例： 2026-05-11T10:08:57.715Z

X-OC-SIGN

string · 必须

请求签名（Base64 编码）。

示例： Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

允许的时间偏差（毫秒），默认值 5000，最大值 60000。

示例： 5000

X-OC-NONCE

string

唯一请求标识符，用于防重放攻击；省略时使用 X-OC-SIGN 代替。

示例： unique-nonce-string

验证 B402 V1 支付 › 请求体

object · 必须

x402Version

integer · enum · 必须

枚举值:

object · 必须

x402Version

integer · enum · 必须

枚举值:

scheme

string · enum · 必须

枚举值:

exact

示例： exact

network

string · 必须

示例： eip155:56

object · 必须

signature

string · 必须

示例： 0xabcdef...

object

from

string · 必须

示例： 0x5555555555555555555555555555555555555555

to

string · 必须

示例： 0x2222222222222222222222222222222222222222

value

string · 必须

示例： 1000000

validAfter

string · 必须

示例： 0

validBefore

string · 必须

示例： 1780000000

nonce

string · 必须

示例： 0x0000000000000000000000000000000000000000000000000000000000000001

object

object · 必须

token

string · 必须

示例： 0x1111111111111111111111111111111111111111

amount

string · 必须

示例： 1000000

from

string · 必须

示例： 0x5555555555555555555555555555555555555555

spender

string · 必须

示例： 0x4444444444444444444444444444444444444444

nonce

string · 必须

示例： 123456789

deadline

string · 必须

示例： 1780000000

object · 必须

to

string · 必须

示例： 0x2222222222222222222222222222222222222222

validAfter

string · 必须

示例： 0

facilitator

string | null

示例： 0x3333333333333333333333333333333333333333

object · 必须

scheme

string · enum · 必须

枚举值:

exact

示例： exact

network

string · 必须

示例： eip155:56

amount

string · 必须

示例： 1000000

payTo

string · 必须

示例： 0x2222222222222222222222222222222222222222

asset

string · 必须

示例： 0x1111111111111111111111111111111111111111

maxTimeoutSeconds

integer · 必须

示例： 300

resource

string · uri

示例： https://merchant.example.com/weather

description

string

示例： Premium weather report

mimeType

string

示例： application/json

object

示例： {"type":"object"}

object

name

string

示例： Token Name

version

string

示例： 1

assetTransferMethod

string · enum

枚举值:

eip3009

permit2-exact

permit2-upto

facilitatorAddress

string

示例： 0x3333333333333333333333333333333333333333

验证 B402 V1 支付 › 响应

V1 Verify 结果，或 B402 业务错误 Envelope。

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object
	type = object

Properties for Variant 1:

status

string

示例： OK

type

string

示例： GENERAL

code

string

示例： 000000000

errorData

string | null

示例： null

object

subData

object | null

示例： null

params

object | null

示例： null

POST/api/v1/b402/verify

curl --request POST \
  --url https://web3.binance.com/build/api/v1/b402/verify \
  --header 'Content-Type: application/json' \
  --header 'X-OC-APIKEY: <string>' \
  --header 'X-OC-SIGN: <string>' \
  --header 'X-OC-TIMESTAMP: <string>' \
  --data '
{
  "body": {
    "x402Version": 1,
    "paymentPayload": {
      "x402Version": 1,
      "scheme": "exact",
      "network": "eip155:56",
      "payload": {
        "signature": "0xabcdef..."
      }
    },
    "paymentRequirements": {
      "scheme": "exact",
      "network": "eip155:56",
      "amount": "1000000",
      "payTo": "0x2222222222222222222222222222222222222222",
      "asset": "0x1111111111111111111111111111111111111111",
      "maxTimeoutSeconds": 300
    }
  }
}
'

示例请求体

{
  "body": {
    "x402Version": 1,
    "paymentPayload": {
      "x402Version": 1,
      "scheme": "exact",
      "network": "eip155:56",
      "payload": {
        "signature": "0xabcdef..."
      }
    },
    "paymentRequirements": {
      "scheme": "exact",
      "network": "eip155:56",
      "amount": "1000000",
      "payTo": "0x2222222222222222222222222222222222222222",
      "asset": "0x1111111111111111111111111111111111111111",
      "maxTimeoutSeconds": 300
    }
  }
}

json

示例响应

{
  "status": "OK",
  "type": "GENERAL",
  "code": "000000000",
  "errorData": null,
  "data": {
    "isValid": true,
    "payer": "0x5555555555555555555555555555555555555555",
    "invalidReason": "invalid_payload",
    "invalidMessage": null
  },
  "subData": null,
  "params": null
}

json

application/json

结算 B402 V1 支付

V1 链上 Settle 兼容接口，新接入应使用 V2。该操作可能转移真实资金且不可逆。 V1 Settle 结果会额外返回 confirmations。

POST

/api/v1/b402/settle

https://web3.binance.com/build

结算 B402 V1 支付 › 授权

这是一个签名端点，必须在请求头中包含签名。了解如何生成有效签名，请参考认证。

结算 B402 V1 支付 › 请求头

X-OC-APIKEY

string · 必须

Binance Web3 API 颁发的用于鉴权的 API Key。

示例： your-api-key-here

X-OC-TIMESTAMP

string · 必须

当前 UTC 时间，ISO 8601 格式，精确到毫秒，例如 2026-05-11T10:08:57.715Z。

示例： 2026-05-11T10:08:57.715Z

X-OC-SIGN

string · 必须

请求签名（Base64 编码）。

示例： Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

允许的时间偏差（毫秒），默认值 5000，最大值 60000。

示例： 5000

X-OC-NONCE

string

唯一请求标识符，用于防重放攻击；省略时使用 X-OC-SIGN 代替。

示例： unique-nonce-string

结算 B402 V1 支付 › 请求体

object · 必须

x402Version

integer · enum · 必须

枚举值:

object · 必须

x402Version

integer · enum · 必须

枚举值:

scheme

string · enum · 必须

枚举值:

exact

示例： exact

network

string · 必须

示例： eip155:56

object · 必须

signature

string · 必须

示例： 0xabcdef...

object

from

string · 必须

示例： 0x5555555555555555555555555555555555555555

to

string · 必须

示例： 0x2222222222222222222222222222222222222222

value

string · 必须

示例： 1000000

validAfter

string · 必须

示例： 0

validBefore

string · 必须

示例： 1780000000

nonce

string · 必须

示例： 0x0000000000000000000000000000000000000000000000000000000000000001

object

object · 必须

token

string · 必须

示例： 0x1111111111111111111111111111111111111111

amount

string · 必须

示例： 1000000

from

string · 必须

示例： 0x5555555555555555555555555555555555555555

spender

string · 必须

示例： 0x4444444444444444444444444444444444444444

nonce

string · 必须

示例： 123456789

deadline

string · 必须

示例： 1780000000

object · 必须

to

string · 必须

示例： 0x2222222222222222222222222222222222222222

validAfter

string · 必须

示例： 0

facilitator

string | null

示例： 0x3333333333333333333333333333333333333333

object · 必须

scheme

string · enum · 必须

枚举值:

exact

示例： exact

network

string · 必须

示例： eip155:56

amount

string · 必须

示例： 1000000

payTo

string · 必须

示例： 0x2222222222222222222222222222222222222222

asset

string · 必须

示例： 0x1111111111111111111111111111111111111111

maxTimeoutSeconds

integer · 必须

示例： 300

resource

string · uri

示例： https://merchant.example.com/weather

description

string

示例： Premium weather report

mimeType

string

示例： application/json

object

示例： {"type":"object"}

object

name

string

示例： Token Name

version

string

示例： 1

assetTransferMethod

string · enum

枚举值:

eip3009

permit2-exact

permit2-upto

facilitatorAddress

string

示例： 0x3333333333333333333333333333333333333333

settleAmount

string · pattern: ^[0-9]+$

示例： 750000

结算 B402 V1 支付 › 响应

V1 Settle 结果，或 B402 业务错误 Envelope。

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object
	type = object

Properties for Variant 1:

status

string

示例： OK

type

string

示例： GENERAL

code

string

示例： 000000000

errorData

string | null

示例： null

object

subData

object | null

示例： null

params

object | null

示例： null

POST/api/v1/b402/settle

curl --request POST \
  --url https://web3.binance.com/build/api/v1/b402/settle \
  --header 'Content-Type: application/json' \
  --header 'X-OC-APIKEY: <string>' \
  --header 'X-OC-SIGN: <string>' \
  --header 'X-OC-TIMESTAMP: <string>' \
  --data '
{
  "body": {
    "x402Version": 1,
    "paymentPayload": {
      "x402Version": 1,
      "scheme": "exact",
      "network": "eip155:56",
      "payload": {
        "signature": "0xabcdef..."
      }
    },
    "paymentRequirements": {
      "scheme": "exact",
      "network": "eip155:56",
      "amount": "1000000",
      "payTo": "0x2222222222222222222222222222222222222222",
      "asset": "0x1111111111111111111111111111111111111111",
      "maxTimeoutSeconds": 300
    }
  }
}
'

示例请求体

{
  "body": {
    "x402Version": 1,
    "paymentPayload": {
      "x402Version": 1,
      "scheme": "exact",
      "network": "eip155:56",
      "payload": {
        "signature": "0xabcdef..."
      }
    },
    "paymentRequirements": {
      "scheme": "exact",
      "network": "eip155:56",
      "amount": "1000000",
      "payTo": "0x2222222222222222222222222222222222222222",
      "asset": "0x1111111111111111111111111111111111111111",
      "maxTimeoutSeconds": 300
    }
  }
}

json

示例响应

{
  "status": "OK",
  "type": "GENERAL",
  "code": "000000000",
  "errorData": null,
  "data": {
    "success": true,
    "transaction": "0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
    "payer": "0x5555555555555555555555555555555555555555",
    "network": "eip155:56",
    "amount": "1000000",
    "confirmations": 1,
    "errorReason": null,
    "errorMessage": null
  },
  "subData": null,
  "params": null
}

json

application/json