先看结论：链上支付不可撤销，没有自动拒付，也没有自动退款。退款就是商家手动发起的一笔出款，从热钱包发到客户的地址。出款流程里有地址簿、审批、一次性验证码和限额几道安全检查，退款前要先核对地址和网络。
1. 退款是怎么回事
银行卡有拒付机制，链上转账没有。资金一旦确认就无法撤回，所以退款只能是商家自己再发一笔转账，把约定的数量转回客户的钱包地址。官方文档也是这样说明的：退款需要在后台或通过 API 手动处理。
这笔转账从项目的热钱包发出。没有为该项目配置热钱包，或者热钱包里的币和 gas 不够，就发不出去。详见 钱包分工。
官方流程用到邮件发送一次性验证码，需要邮件服务已经配置好。在 PayRamHost，出款和审批的具体功能是否已为你的账号开通，以你的后台实际显示为准。不确定的话请联系我们。
2. 退款前先核对什么
- 这笔付款确实成功了吗？在后台或用状态接口确认状态是
FILLED或OVER_FILLED，不要凭客户的截图。见 支付状态详解。 - 让客户用书面方式提供收款地址和网络，并让他再确认一次。官方文档明确警告：网络和地址必须匹配，如果属于不同的区块链，出款会失败，资金可能丢失。
- 别想当然地原路退回。付款记录里有来源地址，但如果客户是从交易所提币过来的，来源地址往往是交易所的地址，退回去可能不会被入账到客户名下。请客户提供自己的钱包地址。
- 币种和数量。确认退多少、用哪种币、哪条链，并留意热钱包里这种币的余额够不够，以及有没有足够的 gas。
- 保留记录。把退款和原订单的
invoice_id、reference_id关联起来，方便对账。
3. 出款流程：从创建到发出
按官方文档，后台里的出款是这样走的：
- 在左侧 Withdraw 菜单里进入 Payouts。
- 把收款人加进地址簿（Address Book）。点击 Add New，填入网络、钱包地址和备注。保存时需要一次性验证码确认。地址簿的作用是保证每次都转给正确的地址。
- 回到出款页，点击 Create Payout，选择收款人，填入金额，创建。
- 出款请求会出现在后台，等待审批（见下一节）。批准后进入发送队列，上链发出。
先把收款人放进地址簿再出款，是官方设计的一个防错环节：避免每次手输地址时输错。
4. 审批与验证码
- 非管理员角色创建的出款，需要管理员批准才会处理。
- 批准时，一个 6 位验证码会发到审批管理员自己的邮箱，有效期 10 分钟。输入验证码后，批准才生效。
- 可以批准的人：Root 和管理员（任何出款，包括自己创建的）；项目管理员（自己负责的项目的出款）。其他成员即使创建了出款，也无权批准。
- 拒绝的出款会变成
rejected，是最终状态。
这套设计的目的，是避免一个人单独把钱转走。给团队分配权限时，请遵循“谁创建、谁审批”分开的原则。
5. 限额设置
限额按项目设置，决定一笔新的出款是直接发送、等待审批，还是被拒绝：
| 设置项 | 作用 |
|---|---|
| 自动批准（开关） | 关闭后，每笔出款都要等待审批 |
| 自动批准金额 | 超过这个金额的出款需要审批 |
| 每日限额 | 会使该账号过去 24 小时出款总额超过限额的出款，需要审批 |
| 每小时限额 | 同上，统计过去 60 分钟 |
| 最低金额 | 低于这个金额的出款会被拒绝 |
某些项设为 0 有特殊含义：自动批准金额为 0，表示每笔出款都要审批；每日、每小时限额为 0，表示不限制；最低金额为 0，表示没有最低要求。留空表示沿用默认设置。修改只对之后创建的出款生效。
6. 出款状态的含义
| 状态 | 含义 |
|---|---|
pending-approval | 等待审批 |
pending-otp-verification | 管理员已批准，等待输入邮件里的验证码 |
pending | 排队等待发送。如果热钱包余额暂时不够，最多等 48 小时让你充值，超时则失败 |
initiated | 已广播上链，有交易哈希。这期间哈希可能因为加速费用而变化，请以最新的为准 |
sent | 已在链上确认，钱已经转出，视为成功。sent 的出款不会再变成失败 |
processed | 系统记账完成，没有 Webhook，不需要等待 |
failed | 没有成功，原因见失败说明 |
rejected | 被管理员拒绝 |
cancelled | 发送前被取消 |
最终状态是 sent、failed、rejected 和 cancelled。
7. 用 API 发起出款
你的程序也可以用项目 API 密钥发起出款，接口是 POST /api/v1/withdrawal/merchant。通过 API 创建的出款同样受上面的限额和审批规则约束，被限额拦下的会进入等待审批状态，审批仍要在后台完成，不能通过 API 批准。出款状态可以用 Webhook 或查询接口跟踪，具体字段以 PayRam 官方文档 为准。
支持的网络和币种见 PayRam 支持哪些区块链和币种：比特币可以收，但不支持出款。
8. 常见问题
客户只想退一部分，可以吗？
可以。出款的金额由你填写，没有必须全额退回的限制。请在订单备注里记录原因和金额。
退款的 gas 由谁出？
由热钱包支付，也就是由商家承担，不包含在服务费内。
转错地址怎么办？
链上转账无法撤回。转错地址或网络，资金通常无法找回，所以才要用地址簿、让客户确认地址，并先用小额验证新地址。
少付或多付的款怎么退？
多付的部分，可以退回，也可以记为客户余额抵扣以后的账单；少付的，让客户补足，或退回已收到的部分。见 支付状态详解。