Basics

Payment status

This page summarises the status fields returned by the V2 /verify and /settle endpoints. For the full field reference and example payloads, see Verify Payment (V2) and Settle Payment (V2).

Verify response

The /verify endpoint returns an off-chain validation result indicating whether the payment authorization is valid.

Field	Type	Mandatory	Description
isValid	boolean	Always	`true` if the EIP-712 signature and payment parameters are valid.
invalidReason	string	Only when `isValid=false`	x402 v2 standard error code indicating why validation failed. See the full code list on Verify Payment (V2).

Settlement response

The /settle endpoint submits the payment on-chain and returns the settlement result.

Field	Type	Mandatory	Description
success	boolean	Always	`true` if the on-chain settlement was executed successfully.
transaction	string	Always	On-chain transaction hash (0x-prefixed). Empty string `""` if no transaction was broadcast (per x402 v2 spec).
payer	string	Always	Payer wallet address.
network	string	Always	Settlement network in CAIP-2 format (e.g. `"eip155:56"`). Empty string `""` if unavailable on pre-broadcast failure.
amount	string	Only when `success=true`	Actual settled amount in atomic units.
errorReason	string	Only when `success=false`	x402 v2 standard error code. See Verify Payment (V2) — `invalidReason` / `errorReason` Values.

Status summary

Field combination	Meaning
`success=true`, `transaction=<hash>`	On-chain settlement confirmed. Final state.
`success=false`, `transaction=<hash>`	Transaction was broadcast but reverted on-chain. Final state; check `errorReason`.
`success=false`, `transaction=""`	Pre-broadcast failure (e.g. invalid signature). Nothing was submitted on-chain.

Note: On-chain failures are not returned as error codes. They are returned with HTTP 200 and code: "000000" in the response envelope. Always inspect the success field and errorReason in the data object.

Was this page helpful?

Last modified on July 8, 2026

How to apply partner developer account Typical integration flow

Payment status

This page summarises the status fields returned by the V2 /verify and /settle endpoints. For the full field reference and example payloads, see Verify Payment (V2) and Settle Payment (V2).

Verify response

The /verify endpoint returns an off-chain validation result indicating whether the payment authorization is valid.

Field

Type

Mandatory

Description

isValid

boolean

Always

true if the EIP-712 signature and payment parameters are valid.

invalidReason

string

Only when isValid=false

x402 v2 standard error code indicating why validation failed. See the full code list on Verify Payment (V2).

Settlement response

The /settle endpoint submits the payment on-chain and returns the settlement result.

Field

Type

Mandatory

Description

success

boolean

Always

true if the on-chain settlement was executed successfully.

transaction

string

Always

On-chain transaction hash (0x-prefixed). Empty string "" if no transaction was broadcast (per x402 v2 spec).

payer

string

Always

Payer wallet address.

network

string

Always

Settlement network in CAIP-2 format (e.g. "eip155:56"). Empty string "" if unavailable on pre-broadcast failure.

amount

string

Only when success=true

Actual settled amount in atomic units.

errorReason

string

Only when success=false

x402 v2 standard error code. See Verify Payment (V2) — invalidReason / errorReason Values.

Status summary

Field combination

Meaning

success=true, transaction=<hash>

On-chain settlement confirmed. Final state.

success=false, transaction=<hash>

Transaction was broadcast but reverted on-chain. Final state; check errorReason.

success=false, transaction=""

Pre-broadcast failure (e.g. invalid signature). Nothing was submitted on-chain.

Note: On-chain failures are not returned as error codes. They are returned with HTTP 200 and code: "000000" in the response envelope. Always inspect the success field and errorReason in the data object.

Was this page helpful?

Last modified on July 8, 2026