# PYUSD 转不出或兑换净额不符：查暂停、冻结、账户 hold 与费用类型

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

对已有错误/结果核对 EVM view 字段和角色边界，再把 PayPal 转移条件、一步流程费用及发行方赎回阶段分开。

## 使用工具
- [PayPal USD（PYUSD）官方资产核对](https://lianxiaozhi.com/tools/paypal-pyusd) · [官方入口](https://docs.paxos.com/guides/stablecoin/pyusd/mainnet)

## 前置条件
- 准备原错误/既有只读结果、链与 proxy 地址、读取时点/区块、owner/from/to/spender、金额单位、平台流程与费用明细。没有原结果时只能建立检查清单，不报告当前状态。
- 固定 PYUSD 与 PaxosTokenV2 源码/ABI用于解释，不代表当前部署；PayPal US 2026-05-19 与 Paxos 2026-06-30 条款有各自客户范围。无需授权、签名、管理角色或私钥。

## 1. 先按发生位置分类失败

在原记录找失败发生于钱包/合约转移，还是 PayPal 账户 Transfer/买卖，或 Paxos 赎回/提款。保存 exact error、服务方、网络与时间；账户页面不允许转出不等链 paused，链转移失败也不自动等账号被冻结。

PayPal 美国条款的 omnibus balance 不标特定链，Paxos 直接服务只面向符合条件的客户；先确定实际产品再选择下面对应分支。没有原报错时写“未取得失败原因”，不根据余额不动猜被冻结。

核对结果：失败层与原服务确定，链/平台/发行方证据未混用。
依据：[PayPal 美国加密账户条款](https://www.paypal.com/us/legalhub/paypal/cryptocurrencies-tnc?country.x=US&locale.x=en_US)
依据：[Paxos 当前美元稳定币条款](https://www.paxos.com/terms-and-conditions/stablecoin-terms-conditions)

## 2. 核已有 EVM 只读结果的地址和类型

若有此前取得的合约结果，先确认链、官方 token proxy、读取区块/时间和 ABI：paused()、isFrozen(address) 返回 bool；balanceOf(address)、allowance(owner,spender) 返回 uint256。isFrozen 要填要查的完整地址，allowance 则必须分别有 owner 和实际 spender，不能只拿钱包地址查一次。

读取实施逻辑应是实现 ABI 配合 proxy 状态；固定 BaseStorage 的 paused/frozen 不是当前在线值。没有 response、null、RPC 错误、ABI 不匹配或遗漏字段均记未知，false/0 只有成功返回且参数正确才成立；本篇不代读 RPC。

核对结果：地址/参数、返回类型和时点清楚，未知与 false/0 分开。
依据：[PYUSD 固定官方仓库说明](https://raw.githubusercontent.com/paxosglobal/pyusd-contract/c9ea76760d3dfcd8243a58a02ff11bb61f68759a/README.md)
依据：[PYUSD 固定 ABI：只读字段与错误](https://raw.githubusercontent.com/paxosglobal/pyusd-contract/c9ea76760d3dfcd8243a58a02ff11bb61f68759a/PYUSD.abi)
依据：[PYUSD 固定 V2 基础状态](https://raw.githubusercontent.com/paxosglobal/paxos-token-contracts/c58720109f3cd3e8bf8bd8dbd090ddc257081da5/contracts/BaseStorage.sol)
依据：[Paxos PYUSD 当前主网标识](https://docs.paxos.com/guides/stablecoin/pyusd/mainnet)

## 3. 把错误对应具体转移条件

固定 V2 transfer 受暂停检查，_transfer 检查 from/to 冻结与余额；transferFrom 还检查 spender 是否冻结和 allowance。对既有 AddressFrozen、ContractPaused、InsufficientAllowance、InsufficientFunds 分别记录涉及地址、金额原值/精度与授权 owner/spender，不能用一个 isFrozen(from)=false 排除其他角色或暂停。

PYUSD EVM decimals=6；只有匹配该定义时才换算金额。授权不足不要求无限授权或重新 approve 才能完成诊断。固定 pause/unpause 为 PAUSE_ROLE，freeze/unfreeze/wipe 为 ASSET_PROTECTION_ROLE，普通持有人不能自行解除，README旧 owner 描述不覆盖角色源码。

核对结果：已有错误与具体条件相符或留版本未知，未把诊断变成授权/管理动作。
依据：[PYUSD 固定子模块转移与限制](https://raw.githubusercontent.com/paxosglobal/paxos-token-contracts/c58720109f3cd3e8bf8bd8dbd090ddc257081da5/contracts/PaxosTokenV2.sol)
依据：[PYUSD 固定 EVM 代币定义](https://raw.githubusercontent.com/paxosglobal/pyusd-contract/c9ea76760d3dfcd8243a58a02ff11bb61f68759a/contracts/PYUSD.sol)
依据：[PYUSD 固定 ABI：只读字段与错误](https://raw.githubusercontent.com/paxosglobal/pyusd-contract/c9ea76760d3dfcd8243a58a02ff11bb61f68759a/PYUSD.abi)
依据：[PYUSD 固定官方仓库说明](https://raw.githubusercontent.com/paxosglobal/pyusd-contract/c9ea76760d3dfcd8243a58a02ff11bb61f68759a/README.md)

## 4. 排查平台余额不能转移的条件

若问题来自 PayPal，核已有 Activity 和购买资金结算记录：负余额及银行付款购买未结算等会限制转移，hold 可允许卖出但禁止转出。按美国帮助核当前对应流程、账户额度与网络最低额，不把余额数字当全部可转移。

美国帮助例子外部 PYUSD 最低 Ethereum 10、Solana/Arbitrum 1；周转移额度 25000 USD，消费者/商户重置日不同。这里只核原记录是否命中该 US 规则；其他地区、客户端、当前菜单或特殊账户需要自己的现行说明，不能默认全球一致。

核对结果：平台资金/hold、额度、最低额独立标明，不冒充合约冻结。
依据：[PayPal 美国加密资产转移帮助](https://www.paypal.com/us/cshelp/article/how-do-i-transfer-my-crypto-help822)
依据：[PayPal 美国加密账户条款](https://www.paypal.com/us/legalhub/paypal/cryptocurrencies-tnc?country.x=US&locale.x=en_US)

## 5. 按真实 action 核费用与美元基数

在原明细确定是普通外部转移、一步 buy-and-transfer，还是一步 transfer-and-sell。美国 2026-05-19 费表：普通接收与内部 PayPal/Venmo 转移无费用；普通外部发送有可变 network fee；一步买转 PYUSD 为转移美元值 1.5% 加网络费，一步转卖为接收美元值 1.5%。

例如一步买转名义 100 USD 的百分比费用为 1.50 USD，另列实际 network fee；不假定扣费位置或净到达值。该 1.5% 不能套普通发送，也不能拿 PYUSD buy/sell 零费或其他币阶梯费覆盖这两种组合动作。币数量、美元估值、network fee 币种与实际净額分别保存。

核对结果：action、百分比基数、网络费及净额原记录可核，不把宣传零费当全流程零成本。
依据：[PayPal 美国消费者当前费用](https://www.paypal.com/us/digital-wallet/paypal-consumer-fees?locale.x=en_US)

## 6. 把发行方赎回与银行提款单独结案

若原服务是 Paxos，当前条款区分一般持有人与已验证客户，适用地域/注册主体、合规与最低额可能限制直接 redemption；兑换后的平台 USD credit 与本人银行 withdrawal 是两阶段。条款赎回向下舍入到美分，银行/钱包费及适用 pricing supplement 另核，不以 PayPal 费用推 Paxos。

汇总“链错误/状态”“平台可转移”“费用流程”“发行方或银行阶段”四项已知/未知。平台 rewards 是另行资格和规则，发行方条款不把代币设计为持有人回报；不以少到账解释成代币必然生息、保本或自动兑回。没有当前状态/银行回执时不能报告解冻或到账。

核对结果：限制和费用归于正确主体，代币状态、兑换与银行结果各自有证据或未知。
依据：[Paxos 当前美元稳定币条款](https://www.paxos.com/terms-and-conditions/stablecoin-terms-conditions)
依据：[PayPal 美国加密账户条款](https://www.paypal.com/us/legalhub/paypal/cryptocurrencies-tnc?country.x=US&locale.x=en_US)
依据：[Paxos PYUSD 帮助旧范围](https://support.paxos.com/articles/4933327727-paypal-usd-pyusd)

## 常见错误
- 任何一次读失败不等 paused=false/isFrozen=false/余额0；from、to、spender不同。
- 普通转账与一步买转/转卖费率不同，链手续费与 USD 百分比不能相加成同单位。
- 管理角色、账户审核和银行结果未核，不提供解除冻结或重新授权指令。

## 完成检查
- 原失败可定位对应合约/平台/发行方层或明确留未知。
- 已有结果类型/单位、US 条件和实际 action 费用已对照；没有 RPC、签名、转账、管理或兑换验收。

## 相关知识
- [Solana 增发权与冻结权是什么？权限撤销不等于代币安全](https://lianxiaozhi.com/learn/mint-and-freeze-authority)
- [稳定币脱锚怎么看？交易价格与发行方兑付是两条路径](https://lianxiaozhi.com/learn/stablecoin-depeg-and-redemption)
- [把数据上链，与只保存数据哈希有什么区别？](https://lianxiaozhi.com/learn/data-onchain-vs-offchain)

## 官方依据
- [PayPal 美国加密账户条款](https://www.paypal.com/us/legalhub/paypal/cryptocurrencies-tnc?country.x=US&locale.x=en_US)
- [Paxos 当前美元稳定币条款](https://www.paxos.com/terms-and-conditions/stablecoin-terms-conditions)
- [PYUSD 固定官方仓库说明](https://raw.githubusercontent.com/paxosglobal/pyusd-contract/c9ea76760d3dfcd8243a58a02ff11bb61f68759a/README.md)
- [PYUSD 固定 ABI：只读字段与错误](https://raw.githubusercontent.com/paxosglobal/pyusd-contract/c9ea76760d3dfcd8243a58a02ff11bb61f68759a/PYUSD.abi)
- [PYUSD 固定 V2 基础状态](https://raw.githubusercontent.com/paxosglobal/paxos-token-contracts/c58720109f3cd3e8bf8bd8dbd090ddc257081da5/contracts/BaseStorage.sol)
- [Paxos PYUSD 当前主网标识](https://docs.paxos.com/guides/stablecoin/pyusd/mainnet)
- [PYUSD 固定子模块转移与限制](https://raw.githubusercontent.com/paxosglobal/paxos-token-contracts/c58720109f3cd3e8bf8bd8dbd090ddc257081da5/contracts/PaxosTokenV2.sol)
- [PYUSD 固定 EVM 代币定义](https://raw.githubusercontent.com/paxosglobal/pyusd-contract/c9ea76760d3dfcd8243a58a02ff11bb61f68759a/contracts/PYUSD.sol)
- [PayPal 美国加密资产转移帮助](https://www.paypal.com/us/cshelp/article/how-do-i-transfer-my-crypto-help822)
- [PayPal 美国消费者当前费用](https://www.paypal.com/us/digital-wallet/paypal-consumer-fees?locale.x=en_US)
- [Paxos PYUSD 帮助旧范围](https://support.paxos.com/articles/4933327727-paypal-usd-pyusd)
