![]()
常见问题解答
![]()
订单金额限制
1. 最小金额限制：
Gate支付：0.0001 （所有货币单位）
Web3链上支付：0.01 USDT（或等价值其他币种）
闪兑最小金额：查询币种对接口会返回最大最小值
订单金额必须不低于设定的最小金额。例如，若最小金额限制为 0.0001，则订单金额 ≥ 0.0001 即可，如 0.0001、0.00011 等。
2. 精度限制：
订单金额的小数位数不得超过设定的精度。例如，若精度设定为 0.0001（即最多 4 位小数），则 0.001 是有效的，而 0.00011 会报错，不会进行四舍五入。
订单金额需同时满足最小金额和精度两项要求，否则无法提交。例如：若最小金额限制为 0.0001，精度限制为 0.1，则 0.01 仍不符合精度要求，会报错。
![]()
提现手续费说明
![]()
查询提现状态 API
![]()
说明
调用 “查询提现状态” 接口可获取不同币种在各支持链上的提现手续费信息，用户可根据需要选择合适的链。
![]()
手续费参数
withdraw_fix_on_chains：固定提现手续费
withdraw_percent_on_chains：百分比提现手续费（部分特殊币种适用，计算方式为提现金额 × 该百分比）
![]()
计算方式
提现手续费 = 固定费用 + (百分比费率 × 提现数量)
![]()
其他注意事项
目前大多数常用链仅收取固定手续费，该费用每小时更新。
建议在每次提现前调用该接口，以获取最新手续费数据，确保计算准确。
![]()
为什么用户在有效期内支付，但被判定为过期订单？
支付时间以链上检测到这笔交易时间为准，不是以用户实际操作时间为准，中间会有时间差。
![]()
为什么 Gate APP 或 Web 端账单情况与实际收单情况不一致？
App 或 Web 端内展示的账单显示的是订单金额，不是实际用户支付的金额。
即使用户支付的金额与订单金额不一致，也会显示订单金额。查看账单详情，必须以商户后台的数据为准。
![]()
创建订单 API 中 merchantTradeNo 和 merchantUserId 的含义
merchantTradeNo：商户侧系统的订单号，不超过 32 个字符。
merchantUserId：商户侧用户的账号 ID。必须是一个存在的用户 ID，否则在地址支付退款时无法识别支付用户。
![]()
关于地址支付的回调信息
![]()
为什么支付回调信息有两条？
资金到账通知（TRANSFER_ADDRESS）：实际到账金额的通知。
订单状态变更通知（PAY_ADDRESS）：订单状态的变更通知。
商户需要结合这两类信息判断订单是否成功，以便执行发货或处理失败订单。
![]()
回调信息发送时间点
资金到账通知
链上确认支付成功后，为商户实时入账资金，同时回调给商户。订单状态变更通知
订单状态发生变化时触发。
![]()
回调信息状态解读
1. 资金到账通知（biztype = TRANSFER_ADDRESS）
TRANSFERRED_ADDRESS_IN_TERM：订单有效期内即时到账。
TRANSFERRED_ADDRESS_DELAY：超过有效期的支付到账，将实际支付对应金额充值到商户支付账户中（超过有效期即时到账）。
2. 订单状态变更通知（biztype = PAY_ADDRESS）
PAY_SUCCESS：支付成功。
PAY_CLOSE：订单过期。
PAY_ERROR：支付遇到错误。
PAY_EXPIRED_IN_PROCESS：等待链上确认资金。
PAY_BLOCK：固定地址订单，安全审核中。
![]()
地址支付的支付场景及订单状态判断
1. 有效期内一次性足额或超额支付
描述： 在订单有效期内，只要足额或者超额支付，待链上确认资金后，就会实时发送回调信息。
订单状态 ：首先等待链上确认资金，回调一个中间态：bizStatus 为 PAY_EXPIRED_IN_PROCESS。等待链上确认资金后，订单成功，回调bizStatus 为 PAY_SUCCESS，到账金额为doneAmountOnChain
资金到账通知 ：bizStatus 为 TRANSFERRED_ADDRESS_IN_TERM，到账金额为 transferAmount。
2. 有效期内未足额支付
描述 ：用户在订单有效期内支付不足订单金额的，待链上确认资金后，给商户入账用户实际支付的金额，并实时发送资金到账的回调信息。
订单状态 ：有效期内，此时订单状态没有发生变化，不发送订单状态的回调信息。
资金到账通知 ：bizStatus 为 TRANSFERRED_ADDRESS_IN_TERM，到账金额为 transferAmount。
3.有效期内未足额支付，且未补足
描述 ：用户在订单有效期内支付不足订单金额，且在有效期内没有补足。
订单状态 ：订单有效期结束的时候，发送订单状态的回调。bizStatus为PAY_CLOSE，到账金额为doneAmountOnChain。
资金到账通知 ：用户支付完成后，已经实时回调，不再重复发送。
4. 有效期内未足额支付，但已补足
4.1 有效期内补足金额：
用户补足剩余金额后 ：
订单状态 ：此时等待链上确认资金，回调一个中间态：bizStatus 为 PAY_EXPIRED_IN_PROCESS。
资金到账通知 ：等待链上确认补足的资金，所以不发送资金到账通知。
链上确认成功后 ：
订单状态 ：等链上资金确认完毕，金额足够，此时订单才算成功，bizStatus 为 PAY_SUCCESS，到账金额为doneAmountOnChain （此时为所有支付的汇总金额）。
资金到账通知 ：bizStatus 为 TRANSFERRED_ADDRESS_IN_TERM，到账金额为 transferAmount。
4.2 有效期外补足金额：
订单状态 ：因检测到有效期内没有足额支付，在订单有效期结束的时候，会先发送订单状态的回调。bizStatus为PAY_CLOSE，到账金额为doneAmountOnChain。
资金到账通知 ：用户支付完成后，已经实时回调，不再重复发送。
用户有效期外补足剩余金额后 ：会发送资金到账的回调，bizStatus 为 TRANSFERRED_ADDRESS_DELAY，到账金额为 transferAmount。 (此种情况下不会额外发送订单状态的回调，最终回调信息中不包含 doneAmountOnChain 字段。如用户使用多笔交易完成支付，商户需自行累加所有回调中的 transferAmount 以确认最终到账总额。)
5. 过期支付
描述 ：用户在订单有效期外支付，不管是部分还是足额，亦或是超额支付，链上确认成功后，会实时到账。
订单状态变 ：因为有效期内没有支付任何金额，在订单有效期结束的时候，会回调bizStatus 为 PAY_CLOSE。
资金到账 ：无资金到账通知。
过期后支付： 过期后支付一笔，回调一笔资金到账的通知，bizStatus 为 TRANSFERRED_ADDRESS_DELAY，到账金额为 transferAmount。 (此种情况下不会额外发送订单状态的回调，最终回调信息中不包含 doneAmountOnChain 字段。如用户使用多笔交易完成支付，商户需自行累加所有回调中的 transferAmount 以确认最终到账总额。)
商户需要根据 订单状态 和 资金到账 两条回调信息判断订单是否成功。
