# Gnosis Pay 充值成功却刷卡失败：查可用余额与拒付码

整理：链小知（AI 辅助）
资料核对日期：2026-10-12
引用地址：https://lianxiaozhi.com/tools/guides/gnosis-pay-check-spendable
难度：进阶
核验方式：官方文档整理，未执行真实账户操作

从账户配置、支持token和余额分项排查，而不是只看Safe链上余额。

## 使用工具
- [Gnosis Pay](https://lianxiaozhi.com/tools/gnosis-pay) · [官方入口](https://gnosispay.com/)

## 前置条件
- 准备本人已存在的账户配置、充值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地址的余额判断当前卡账户。账户配置未知时先让本人产品支持核对。

核对结果：网络、账户、币种和环境明确。
依据：[Manage Accounts](https://docs.gnosispay.com/guides/accounts/manage-accounts.md)

## 2. 把充值资产与支持表对照

按链和完整合约核对，官方新基础设施表列Celo的USDC/USDT，以及Gnosis的EURe/GBPe/USDCe。比如Gnosis USDCe合约为0x2a22f9c3b484c3629090FeED35F17Ff8F88f76F0。

具体账户还必须配置该币种，列表不表示任何地区任何个人卡都能用。其他链、同名合约或定制token需要发行方案明确支持，不通过转账测试。

核对结果：充值网络/合约与账户配置相符或有明确差异。
依据：[Supported Tokens and Chains](https://docs.gnosispay.com/concepts/safe/tokens-and-chains-supported.md)
依据：[Manage Accounts](https://docs.gnosispay.com/guides/accounts/manage-accounts.md)

## 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保留读取失败。
依据：[Manage Accounts](https://docs.gnosispay.com/guides/accounts/manage-accounts.md)
依据：[Get Account Balances v2](https://docs.gnosispay.com/api-reference/user-movements/get-account-balances-v2.md)

## 4. 用具体拒付码查原因

从已有Partner Dashboard/API/webhook或产品支持记录取得此次拒付码，对照官方表：810为余额不足，CND为账户blocked，FRB对应未激活状态。没有码时不要只凭“declined”归因gas。

部分码技术原因还标pending confirmation，未列码使用通用拒绝信息；这类结果保留未知，不能猜测风控原因或指导重复重试。

核对结果：错误码、用户信息和官方解释一一对应。
依据：[Card Decline Reasons](https://docs.gnosispay.com/concepts/card/decline-codes.md)

## 5. 区分卡消费与链上提现条件

token明细中的maxInstantWithdraw表示当前即时提现可接受量，已考虑卡授权占用与链上支持；它不是刷卡成功保证，也不能拿spendable直接替换。

整理配置、充值hash、余额四项、拒付码与时间。只确认对应阶段，费用、地区/KYC资格及解除限制由当前发行产品核实；不擅自补充充值、解封或再刷一笔。

核对结果：交付可花余额与拒付原因记录，剩余限制明确。
依据：[Get Account Balances v2](https://docs.gnosispay.com/api-reference/user-movements/get-account-balances-v2.md)
依据：[Manage Accounts](https://docs.gnosispay.com/guides/accounts/manage-accounts.md)
依据：[Card Decline Reasons](https://docs.gnosispay.com/concepts/card/decline-codes.md)

## 常见错误
- 链上余额不等于卡片可花余额；充值未完成AML可能仍在处理中。
- 新基础设施支持表不等于个人开户或任意卡片币种范围。

## 完成检查
- 确认账户配置、充值身份、可花状态和具体拒付码；无法确认则逐项留待核查。
- 依据官方文档整理，真实账户/API返回与资金操作尚待实际验证。

## 相关知识

## 官方依据
- [Manage Accounts](https://docs.gnosispay.com/guides/accounts/manage-accounts.md)
- [Get Account Balances v2](https://docs.gnosispay.com/api-reference/user-movements/get-account-balances-v2.md)
- [Supported Tokens and Chains](https://docs.gnosispay.com/concepts/safe/tokens-and-chains-supported.md)
- [Card Decline Reasons](https://docs.gnosispay.com/concepts/card/decline-codes.md)