Gnosis Pay 充值成功却刷卡失败：查可用余额与拒付码
链小知 · 进阶 · 核验 · 依官方文档整理
从账户配置、支持token和余额分项排查，而不是只看Safe链上余额。
开始前准备
- 准备本人已存在的账户配置、充值hash、卡片错误原文/拒付码、币种与操作时间；不提供卡号、CVV、PIN或身份文件。
- 适用当前Gnosis Pay新Partner/User API；普通卡用户可让本人使用的产品支持提供对应状态，旧个人产品界面不能套新API菜单。
- 已有认证会话的查询不发起付款；API使用Bearer授权。开户/KYC、卡片申请、解封、支付与提现另行处理；费用查当前发行方案。
1. 核对账户实际配置
从已有产品账户记录取得链、币种与Safe owner地址。开发者现有会话可GET https://core.prod.gnosispay.com/user-api/user/account；Sandbox使用core.sandbox.gnosispay.in，测试结果不证明生产可用。
链上Safe余额与卡片可花余额不是同一字段；不要只用任意Gnosis地址的余额判断当前卡账户。账户配置未知时先让本人产品支持核对。
检查结果：网络、账户、币种和环境明确。
2. 把充值资产与支持表对照
按链和完整合约核对，官方新基础设施表列Celo的USDC/USDT，以及Gnosis的EURe/GBPe/USDCe。比如Gnosis USDCe合约为0x2a22f9c3b484c3629090FeED35F17Ff8F88f76F0。
具体账户还必须配置该币种，列表不表示任何地区任何个人卡都能用。其他链、同名合约或定制token需要发行方案明确支持，不通过转账测试。
检查结果：充值网络/合约与账户配置相符或有明确差异。
3. 读取可花与处理中余额
已有Bearer会话可GET https://core.prod.gnosispay.com/user-api/user/balances/v2。按currency分别记录spendable、nonSpendable、processingDeposits、processingWithdrawals及tokens明细。
处理中的充值尚未可花，受审查资金可能不可花；提现处理中从可花余额扣除但未链上结算。raw bigint字符串按对应decimals转换，货币层与token层精度分别读，不相互套用。
检查结果：得到四项余额状态与正确单位；401/404/502保留读取失败。
4. 用具体拒付码查原因
从已有Partner Dashboard/API/webhook或产品支持记录取得此次拒付码，对照官方表：810为余额不足，CND为账户blocked，FRB对应未激活状态。没有码时不要只凭“declined”归因gas。
部分码技术原因还标pending confirmation，未列码使用通用拒绝信息；这类结果保留未知，不能猜测风控原因或指导重复重试。
检查结果：错误码、用户信息和官方解释一一对应。
5. 区分卡消费与链上提现条件
token明细中的maxInstantWithdraw表示当前即时提现可接受量，已考虑卡授权占用与链上支持；它不是刷卡成功保证，也不能拿spendable直接替换。
整理配置、充值hash、余额四项、拒付码与时间。只确认对应阶段，费用、地区/KYC资格及解除限制由当前发行产品核实；不擅自补充充值、解封或再刷一笔。
检查结果：交付可花余额与拒付原因记录，剩余限制明确。
怎样确认完成
- 确认账户配置、充值身份、可花状态和具体拒付码；无法确认则逐项留待核查。
- 依据官方文档整理，真实账户/API返回与资金操作尚待实际验证。
常见错误与边界
- 链上余额不等于卡片可花余额；充值未完成AML可能仍在处理中。
- 新基础设施支持表不等于个人开户或任意卡片币种范围。