Error code

Error codes are returned in the code field of the response envelope. "000000" indicates success; any other value indicates an error.

Error code format

7-digit 116CCSS — 116 = project prefix (B402), CC = category, SS = sequence.

Error codes

Code	Type	Message
000000	SUCCESS	Success
1160101	SYS_ERROR	System error
1160102	SYS_BUSY	System busy, try again later
1160103	ILLEGAL_PARAMETERS	Request parameter is illegal: {0}
1160201	DATA_NOT_FOUND	Data not found
1160202	DUPLICATE_DATA	Duplicate data
1160301	INVALID_STATUS	Invalid status
1160401	MERCHANT_NOT_FOUND	Merchant not found
1160402	MERCHANT_DISABLED	Merchant account is disabled
1160403	AMOUNT_EXCEEDS_SINGLE_LIMIT	Amount exceeds single transaction limit
1160404	AMOUNT_EXCEEDS_DAILY_MERCHANT_LIMIT	Amount exceeds merchant daily limit
1160405	AMOUNT_EXCEEDS_DAILY_PAYER_LIMIT	Amount exceeds payer daily limit
1160406	PAYER_BLACKLISTED	Payer address is blacklisted
1160407	SANCTIONED_ADDRESS	Address matches sanctions list
1160408	RATE_LIMIT_EXCEEDED	API rate limit exceeded

Verification and settlement failures are not returned as error codes. They are returned with code: "000000" (HTTP 200) and the failure details in the data fields — see invalidReason in Verify Payment and errorReason in Settle Payment.

Example

Error response:

{
    "code": "1160103",
    "message": "Request parameter is illegal: x402Version",
    "data": null
}