错误
/verify 返回 invalidReason。/settle 返回 errorReason。付费资源通常把该字符串复制到下一次 402 的 error 字段。
客户端 / 载荷
unsupported_x402_version | 将 x402Version 设为 2。 |
|---|
unsupported_scheme | 仅实现了 exact。 |
|---|
wrong_network | 使用 cosmos:gonka-mainnet。 |
|---|
missing_signed_tx | payload.signedTx 为空。 |
|---|
invalid_signed_tx | 不是有效的 base64，或不是 protobuf TxRaw。 |
|---|
authorization_expired | timeoutAt 已过期。重新签名。 |
|---|
payer_mismatch | authorization.from 与交易签名者不匹配。 |
|---|
recipient_mismatch | 交易收款人不是 payTo。 |
|---|
asset_mismatch | denom 或 CW-20 合约不正确。 |
|---|
invalid_amount | 要求中的金额缺失，或不是正整数字符串。 |
|---|
insufficient_amount | 交易支付少于 accepted.amount。 |
|---|
invalid_signature | SignDoc 与签名 / 公钥 / chain id / 账户编号不匹配。 |
|---|
链状态
account_lookup_failed | LCD 无法加载付款账户。该地址可能从未被充值。 |
|---|
stale_sequence | 已签 sequence 不是当前值。重新查询并再签。不要复用载荷。 |
|---|
balance_lookup_failed | verify 期间银行或 CW-20 查询失败。 |
|---|
insufficient_funds | verify 时余额低于交易金额。 |
|---|
replayed_payment | 该 TxRaw 已经结算。新支付需要新的 sequence。 |
|---|
settlement_pending | 广播成功；超时前未见上块。再次付款前先在 gonka.gg 查看 transaction。 |
|---|
广播
若链拒绝交易，errorReason 为 LCD 错误（HTTP 状态、broadcast code N 或原始日志）。常见原因：sequence 已使用、memo/消息解码问题，或账户无法支付。修正交易并重新签名。
来自 /demo 的 HTTP 402
PAYMENT-SIGNATURE header is required | 首次请求，或未携带该头。 |
|---|
invalid PAYMENT-SIGNATURE | 该头不是 base64 JSON。 |
|---|