B402 Payments

Endpointhttps://web3.binance.com/build

Get B402 Supported Configurations V2

Return the live x402 V2 payment kinds available to the authenticated Developer Portal project. Use the result to construct HTTP 402 payment requirements. Copy the selected extra object verbatim and refresh cached configuration periodically.

POST

/api/v2/b402/supported

https://web3.binance.com/build

Get B402 Supported Configurations V2 › Authorization

This is a signed endpoint and a signature must be included in the request headers.Learn more about how to generate a valid signature in the Authentication.

Get B402 Supported Configurations V2 › Headers

X-OC-APIKEY

string · required

API Key issued by Binance Web3 API for authentication.

Example: your-api-key-here

X-OC-TIMESTAMP

string · required

Current UTC time in ISO 8601 format with milliseconds, e.g. 2026-05-11T10:08:57.715Z.

Example: 2026-05-11T10:08:57.715Z

X-OC-SIGN

string · required

Request signature (Base64-encoded).

Example: Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

Allowed time deviation in milliseconds (default: 5000, max: 60000).

Example: 5000

X-OC-NONCE

string

Unique request identifier for anti-replay; falls back to X-OC-SIGN if omitted.

Example: unique-nonce-string

Get B402 Supported Configurations V2 › Request Body

body

object · required

Get B402 Supported Configurations V2 › Responses

Supported configurations returned, or a B402 business error envelope.

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object
	type = object

Properties for Variant 1:

status

string

Example: OK

type

string

Example: GENERAL

code

string

Example: 000000000

errorData

string | null

Example: null

object

subData

object | null

Example: null

params

object | null

Example: 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": {}
}'

Example Request Body

{
  "body": {}
}

json

Example Responses

{
  "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

Verify B402 Payment V2

Validate an x402 V2 payment authorization off-chain without spending funds or broadcasting a transaction. Portal identity is resolved from the authenticated API Key project; omit merchantId. A validation failure is returned as HTTP 200 with data.isValid=false.

POST

/api/v2/b402/verify

https://web3.binance.com/build

Verify B402 Payment V2 › Authorization

This is a signed endpoint and a signature must be included in the request headers.Learn more about how to generate a valid signature in the Authentication.

Verify B402 Payment V2 › Headers

X-OC-APIKEY

string · required

API Key issued by Binance Web3 API for authentication.

Example: your-api-key-here

X-OC-TIMESTAMP

string · required

Current UTC time in ISO 8601 format with milliseconds, e.g. 2026-05-11T10:08:57.715Z.

Example: 2026-05-11T10:08:57.715Z

X-OC-SIGN

string · required

Request signature (Base64-encoded).

Example: Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

Allowed time deviation in milliseconds (default: 5000, max: 60000).

Example: 5000

X-OC-NONCE

string

Unique request identifier for anti-replay; falls back to X-OC-SIGN if omitted.

Example: unique-nonce-string

Verify B402 Payment V2 › Request Body

object · required

Verify B402 Payment V2 › Responses

Verification result, or a B402 business error envelope.

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object
	type = object

Properties for Variant 1:

status

string

Example: OK

type

string

Example: GENERAL

code

string

Example: 000000000

errorData

string | null

Example: null

object

subData

object | null

Example: null

params

object | null

Example: 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"
      }
    }
  }
}
'

Example Request Body

{
  "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

Example Responses

{
  "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

Settle B402 Payment V2

Submit a verified x402 V2 authorization on-chain. This operation can move real funds and is irreversible. For permit2-upto, provide settleAmount in atomic units. Business failure is returned as HTTP 200 with data.success=false; reconcile any non-empty transaction hash before retrying.

POST

/api/v2/b402/settle

https://web3.binance.com/build

Settle B402 Payment V2 › Authorization

This is a signed endpoint and a signature must be included in the request headers.Learn more about how to generate a valid signature in the Authentication.

Settle B402 Payment V2 › Headers

X-OC-APIKEY

string · required

API Key issued by Binance Web3 API for authentication.

Example: your-api-key-here

X-OC-TIMESTAMP

string · required

Current UTC time in ISO 8601 format with milliseconds, e.g. 2026-05-11T10:08:57.715Z.

Example: 2026-05-11T10:08:57.715Z

X-OC-SIGN

string · required

Request signature (Base64-encoded).

Example: Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

Allowed time deviation in milliseconds (default: 5000, max: 60000).

Example: 5000

X-OC-NONCE

string

Unique request identifier for anti-replay; falls back to X-OC-SIGN if omitted.

Example: unique-nonce-string

Settle B402 Payment V2 › Request Body

object · required

Settle B402 Payment V2 › Responses

Settlement result, or a B402 business error envelope.

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object
	type = object

Properties for Variant 1:

status

string

Example: OK

type

string

Example: GENERAL

code

string

Example: 000000000

errorData

string | null

Example: null

object

subData

object | null

Example: null

params

object | null

Example: 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"
      }
    }
  }
}
'

Example Request Body

{
  "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

Example Responses

{
  "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

Get B402 Supported Configurations V1

Legacy V1 compatibility endpoint. New integrations should use V2. V1 returns x402Version=1, method-specific facilitatorAddress, and V1 signer-map semantics.

POST

/api/v1/b402/supported

https://web3.binance.com/build

Get B402 Supported Configurations V1 › Authorization

This is a signed endpoint and a signature must be included in the request headers.Learn more about how to generate a valid signature in the Authentication.

Get B402 Supported Configurations V1 › Headers

X-OC-APIKEY

string · required

API Key issued by Binance Web3 API for authentication.

Example: your-api-key-here

X-OC-TIMESTAMP

string · required

Current UTC time in ISO 8601 format with milliseconds, e.g. 2026-05-11T10:08:57.715Z.

Example: 2026-05-11T10:08:57.715Z

X-OC-SIGN

string · required

Request signature (Base64-encoded).

Example: Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

Allowed time deviation in milliseconds (default: 5000, max: 60000).

Example: 5000

X-OC-NONCE

string

Unique request identifier for anti-replay; falls back to X-OC-SIGN if omitted.

Example: unique-nonce-string

Get B402 Supported Configurations V1 › Request Body

body

object · required

Get B402 Supported Configurations V1 › Responses

Legacy supported configurations or a B402 business error envelope.

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object
	type = object

Properties for Variant 1:

status

string

Example: OK

type

string

Example: GENERAL

code

string

Example: 000000000

errorData

string | null

Example: null

object

subData

object | null

Example: null

params

object | null

Example: 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": {}
}'

Example Request Body

{
  "body": {}
}

json

Example Responses

{
  "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

Verify B402 Payment V1

Legacy V1 off-chain verification endpoint. New integrations should use V2. Portal identity is resolved from the API Key project, so merchantId is omitted from the external request.

POST

/api/v1/b402/verify

https://web3.binance.com/build

Verify B402 Payment V1 › Authorization

This is a signed endpoint and a signature must be included in the request headers.Learn more about how to generate a valid signature in the Authentication.

Verify B402 Payment V1 › Headers

X-OC-APIKEY

string · required

API Key issued by Binance Web3 API for authentication.

Example: your-api-key-here

X-OC-TIMESTAMP

string · required

Current UTC time in ISO 8601 format with milliseconds, e.g. 2026-05-11T10:08:57.715Z.

Example: 2026-05-11T10:08:57.715Z

X-OC-SIGN

string · required

Request signature (Base64-encoded).

Example: Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

Allowed time deviation in milliseconds (default: 5000, max: 60000).

Example: 5000

X-OC-NONCE

string

Unique request identifier for anti-replay; falls back to X-OC-SIGN if omitted.

Example: unique-nonce-string

Verify B402 Payment V1 › Request Body

object · required

Verify B402 Payment V1 › Responses

Legacy verification result or a B402 business error envelope.

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object
	type = object

Properties for Variant 1:

status

string

Example: OK

type

string

Example: GENERAL

code

string

Example: 000000000

errorData

string | null

Example: null

object

subData

object | null

Example: null

params

object | null

Example: 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
    }
  }
}
'

Example Request Body

{
  "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

Example Responses

{
  "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

Settle B402 Payment V1

Legacy V1 on-chain settlement endpoint. New integrations should use V2. This operation can move real funds and is irreversible. V1 additionally returns confirmations in the settlement result.

POST

/api/v1/b402/settle

https://web3.binance.com/build

Settle B402 Payment V1 › Authorization

This is a signed endpoint and a signature must be included in the request headers.Learn more about how to generate a valid signature in the Authentication.

Settle B402 Payment V1 › Headers

X-OC-APIKEY

string · required

API Key issued by Binance Web3 API for authentication.

Example: your-api-key-here

X-OC-TIMESTAMP

string · required

Current UTC time in ISO 8601 format with milliseconds, e.g. 2026-05-11T10:08:57.715Z.

Example: 2026-05-11T10:08:57.715Z

X-OC-SIGN

string · required

Request signature (Base64-encoded).

Example: Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

Allowed time deviation in milliseconds (default: 5000, max: 60000).

Example: 5000

X-OC-NONCE

string

Unique request identifier for anti-replay; falls back to X-OC-SIGN if omitted.

Example: unique-nonce-string

Settle B402 Payment V1 › Request Body

object · required

Settle B402 Payment V1 › Responses

Legacy settlement result or a B402 business error envelope.

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object
	type = object

Properties for Variant 1:

status

string

Example: OK

type

string

Example: GENERAL

code

string

Example: 000000000

errorData

string | null

Example: null

object

subData

object | null

Example: null

params

object | null

Example: 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
    }
  }
}
'

Example Request Body

{
  "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

Example Responses

{
  "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

B402 Payments

Endpointhttps://web3.binance.com/build

Download schema

Get B402 Supported Configurations V2

POST

/api/v2/b402/supported

https://web3.binance.com/build

Get B402 Supported Configurations V2 › Authorization

This is a signed endpoint and a signature must be included in the request headers.Learn more about how to generate a valid signature in the Authentication.

Get B402 Supported Configurations V2 › Headers

X-OC-APIKEY

string · required

API Key issued by Binance Web3 API for authentication.

Example: your-api-key-here

X-OC-TIMESTAMP

string · required

Current UTC time in ISO 8601 format with milliseconds, e.g. 2026-05-11T10:08:57.715Z.

Example: 2026-05-11T10:08:57.715Z

X-OC-SIGN

string · required

Request signature (Base64-encoded).

Example: Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

Allowed time deviation in milliseconds (default: 5000, max: 60000).

Example: 5000

X-OC-NONCE

string

Unique request identifier for anti-replay; falls back to X-OC-SIGN if omitted.

Example: unique-nonce-string

Get B402 Supported Configurations V2 › Request Body

body

object · required

Get B402 Supported Configurations V2 › Responses

Supported configurations returned, or a B402 business error envelope.

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object
	type = object

Properties for Variant 1:

status

string

Example: OK

type

string

Example: GENERAL

code

string

Example: 000000000

errorData

string | null

Example: null

object

subData

object | null

Example: null

params

object | null

Example: 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": {}
}'

Example Request Body

{
  "body": {}
}

json

Example Responses

{
  "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

Verify B402 Payment V2

POST

/api/v2/b402/verify

https://web3.binance.com/build

Verify B402 Payment V2 › Authorization

This is a signed endpoint and a signature must be included in the request headers.Learn more about how to generate a valid signature in the Authentication.

Verify B402 Payment V2 › Headers

X-OC-APIKEY

string · required

API Key issued by Binance Web3 API for authentication.

Example: your-api-key-here

X-OC-TIMESTAMP

string · required

Current UTC time in ISO 8601 format with milliseconds, e.g. 2026-05-11T10:08:57.715Z.

Example: 2026-05-11T10:08:57.715Z

X-OC-SIGN

string · required

Request signature (Base64-encoded).

Example: Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

Allowed time deviation in milliseconds (default: 5000, max: 60000).

Example: 5000

X-OC-NONCE

string

Unique request identifier for anti-replay; falls back to X-OC-SIGN if omitted.

Example: unique-nonce-string

Verify B402 Payment V2 › Request Body

object · required

Verify B402 Payment V2 › Responses

Verification result, or a B402 business error envelope.

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object
	type = object

Properties for Variant 1:

status

string

Example: OK

type

string

Example: GENERAL

code

string

Example: 000000000

errorData

string | null

Example: null

object

subData

object | null

Example: null

params

object | null

Example: 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"
      }
    }
  }
}
'

Example Request Body

{
  "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

Example Responses

{
  "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

Settle B402 Payment V2

POST

/api/v2/b402/settle

https://web3.binance.com/build

Settle B402 Payment V2 › Authorization

This is a signed endpoint and a signature must be included in the request headers.Learn more about how to generate a valid signature in the Authentication.

Settle B402 Payment V2 › Headers

X-OC-APIKEY

string · required

API Key issued by Binance Web3 API for authentication.

Example: your-api-key-here

X-OC-TIMESTAMP

string · required

Current UTC time in ISO 8601 format with milliseconds, e.g. 2026-05-11T10:08:57.715Z.

Example: 2026-05-11T10:08:57.715Z

X-OC-SIGN

string · required

Request signature (Base64-encoded).

Example: Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

Allowed time deviation in milliseconds (default: 5000, max: 60000).

Example: 5000

X-OC-NONCE

string

Unique request identifier for anti-replay; falls back to X-OC-SIGN if omitted.

Example: unique-nonce-string

Settle B402 Payment V2 › Request Body

object · required

Settle B402 Payment V2 › Responses

Settlement result, or a B402 business error envelope.

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object
	type = object

Properties for Variant 1:

status

string

Example: OK

type

string

Example: GENERAL

code

string

Example: 000000000

errorData

string | null

Example: null

object

subData

object | null

Example: null

params

object | null

Example: 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"
      }
    }
  }
}
'

Example Request Body

{
  "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

Example Responses

{
  "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

Get B402 Supported Configurations V1

Legacy V1 compatibility endpoint. New integrations should use V2. V1 returns x402Version=1, method-specific facilitatorAddress, and V1 signer-map semantics.

POST

/api/v1/b402/supported

https://web3.binance.com/build

Get B402 Supported Configurations V1 › Authorization

This is a signed endpoint and a signature must be included in the request headers.Learn more about how to generate a valid signature in the Authentication.

Get B402 Supported Configurations V1 › Headers

X-OC-APIKEY

string · required

API Key issued by Binance Web3 API for authentication.

Example: your-api-key-here

X-OC-TIMESTAMP

string · required

Current UTC time in ISO 8601 format with milliseconds, e.g. 2026-05-11T10:08:57.715Z.

Example: 2026-05-11T10:08:57.715Z

X-OC-SIGN

string · required

Request signature (Base64-encoded).

Example: Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

Allowed time deviation in milliseconds (default: 5000, max: 60000).

Example: 5000

X-OC-NONCE

string

Unique request identifier for anti-replay; falls back to X-OC-SIGN if omitted.

Example: unique-nonce-string

Get B402 Supported Configurations V1 › Request Body

body

object · required

Get B402 Supported Configurations V1 › Responses

Legacy supported configurations or a B402 business error envelope.

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object
	type = object

Properties for Variant 1:

status

string

Example: OK

type

string

Example: GENERAL

code

string

Example: 000000000

errorData

string | null

Example: null

object

subData

object | null

Example: null

params

object | null

Example: 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": {}
}'

Example Request Body

{
  "body": {}
}

json

Example Responses

{
  "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

Verify B402 Payment V1

Legacy V1 off-chain verification endpoint. New integrations should use V2. Portal identity is resolved from the API Key project, so merchantId is omitted from the external request.

POST

/api/v1/b402/verify

https://web3.binance.com/build

Verify B402 Payment V1 › Authorization

This is a signed endpoint and a signature must be included in the request headers.Learn more about how to generate a valid signature in the Authentication.

Verify B402 Payment V1 › Headers

X-OC-APIKEY

string · required

API Key issued by Binance Web3 API for authentication.

Example: your-api-key-here

X-OC-TIMESTAMP

string · required

Current UTC time in ISO 8601 format with milliseconds, e.g. 2026-05-11T10:08:57.715Z.

Example: 2026-05-11T10:08:57.715Z

X-OC-SIGN

string · required

Request signature (Base64-encoded).

Example: Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

Allowed time deviation in milliseconds (default: 5000, max: 60000).

Example: 5000

X-OC-NONCE

string

Unique request identifier for anti-replay; falls back to X-OC-SIGN if omitted.

Example: unique-nonce-string

Verify B402 Payment V1 › Request Body

object · required

Verify B402 Payment V1 › Responses

Legacy verification result or a B402 business error envelope.

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object
	type = object

Properties for Variant 1:

status

string

Example: OK

type

string

Example: GENERAL

code

string

Example: 000000000

errorData

string | null

Example: null

object

subData

object | null

Example: null

params

object | null

Example: 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
    }
  }
}
'

Example Request Body

{
  "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

Example Responses

{
  "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

Settle B402 Payment V1

Legacy V1 on-chain settlement endpoint. New integrations should use V2. This operation can move real funds and is irreversible. V1 additionally returns confirmations in the settlement result.

POST

/api/v1/b402/settle

https://web3.binance.com/build

Settle B402 Payment V1 › Authorization

This is a signed endpoint and a signature must be included in the request headers.Learn more about how to generate a valid signature in the Authentication.

Settle B402 Payment V1 › Headers

X-OC-APIKEY

string · required

API Key issued by Binance Web3 API for authentication.

Example: your-api-key-here

X-OC-TIMESTAMP

string · required

Current UTC time in ISO 8601 format with milliseconds, e.g. 2026-05-11T10:08:57.715Z.

Example: 2026-05-11T10:08:57.715Z

X-OC-SIGN

string · required

Request signature (Base64-encoded).

Example: Base64EncodedSignature==

X-OC-RECV-WINDOW

integer · int64

Allowed time deviation in milliseconds (default: 5000, max: 60000).

Example: 5000

X-OC-NONCE

string

Unique request identifier for anti-replay; falls back to X-OC-SIGN if omitted.

Example: unique-nonce-string

Settle B402 Payment V1 › Request Body

object · required

Settle B402 Payment V1 › Responses

Legacy settlement result or a B402 business error envelope.

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object
	type = object

Properties for Variant 1:

status

string

Example: OK

type

string

Example: GENERAL

code

string

Example: 000000000

errorData

string | null

Example: null

object

subData

object | null

Example: null

params

object | null

Example: 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
    }
  }
}
'

Example Request Body

{
  "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

Example Responses

{
  "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