Verify

POST

/verify

Verify an x402 payment payload.

Billing (after upstream 2xx):

paymentPayload.payload.type = voucher → 0.0008 UPTICK

Other → 0.00002 UPTICK

请求参数

Authorization

Body 参数application/json必填

示例

{
    "x402Version": 2,
    "paymentPayload": {
        "x402Version": 2,
        "accepted": {
            "scheme": "batch-settlement",
            "network": "eip155:1170"
        },
        "payload": {
            "type": "voucher",
            "channelConfig": {
                "payer": "0x20fa255492c0c5fe5b6e9513ad4dc565d72ed885",
                "receiver": "0x5a08f46b5c6c5c25a58cd12f51ebe3ffadb67f56",
                "token": "0x5b7cdc0de74e158eac21d1d054bc25d0ad56b773"
            },
            "voucher": {
                "channelId": "0x28e7764ab6408119c3e086e98a7a6582564d151d4334962c9b51c5b15695dd0b",
                "maxClaimableAmount": "1100",
                "signature": "0x4ce01ae20e04dcb525e333b28211a22e38f92e345223fa22a9d5887f786f6dee13d0e819d9b8887281304e5254de5494ebdbbea26da6fdc89c01b9c79583db491b"
            }
        }
    },
    "paymentRequirements": {
        "scheme": "batch-settlement",
        "network": "eip155:1170",
        "asset": "0x5b7cdc0de74e158eac21d1d054bc25d0ad56b773",
        "amount": "10",
        "payTo": "0x5a08f46b5c6c5c25a58cd12f51ebe3ffadb67f56"
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/verify' \
--header 'Content-Type: application/json' \
--data '{
    "x402Version": 2,
    "paymentPayload": {
        "x402Version": 2,
        "accepted": {
            "scheme": "batch-settlement",
            "network": "eip155:1170"
        },
        "payload": {
            "type": "voucher",
            "channelConfig": {
                "payer": "0x20fa255492c0c5fe5b6e9513ad4dc565d72ed885",
                "receiver": "0x5a08f46b5c6c5c25a58cd12f51ebe3ffadb67f56",
                "token": "0x5b7cdc0de74e158eac21d1d054bc25d0ad56b773"
            },
            "voucher": {
                "channelId": "0x28e7764ab6408119c3e086e98a7a6582564d151d4334962c9b51c5b15695dd0b",
                "maxClaimableAmount": "1100",
                "signature": "0x4ce01ae20e04dcb525e333b28211a22e38f92e345223fa22a9d5887f786f6dee13d0e819d9b8887281304e5254de5494ebdbbea26da6fdc89c01b9c79583db491b"
            }
        }
    },
    "paymentRequirements": {
        "scheme": "batch-settlement",
        "network": "eip155:1170",
        "asset": "0x5b7cdc0de74e158eac21d1d054bc25d0ad56b773",
        "amount": "10",
        "payTo": "0x5a08f46b5c6c5c25a58cd12f51ebe3ffadb67f56"
    }
}'

返回响应

🟢200

Verification success (Facilitator response, billed)

该响应没有 Body

🟠400

🟠401Unauthorized

🟠402InsufficientBalance

🟠429RateLimited

修改于 2026-06-26 08:42:47

Supported

Settle