Gate Pay 常见问题

常见问题解答

订单金额限制

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

https://www.gate.com/docs/gatepay/withdraw/zh_CN/#_3-5-%E6%8F%90%E7%8E%B0%E6%89%8B%E7%BB%AD%E8%B4%B9%E6%9F%A5%E8%AF%A2

说明

调用「提现手续费查询」这个接口,会返回币种支持链所需要的手续费。用户可根据需要选择合适的链。
参考下面这俩参数:

手续费参数

「withdraw_fix_on_chains」是固定手续费「withdraw_percent_on_chains」是百分比提现手续费用(有些特殊币种提现的时候需要用提现数量x这个百分比)

计算方式

提现手续费就是这两部分相加:固定费用+百分比费率*提现数量

其他注意事项

现在常用的链基本上只有这个固定费用(这里的固定费用是每小时更新的)
建议每次提现的时候,都需要调用下这个接口,确认下手续费。手续费是每小时更新的。

为什么用户在有效期内支付，但被判定为过期订单？

支付时间以链上检测到这笔交易时间为准，不是以用户实际操作时间为准，中间会有时间差。

为什么 Gate APP和商户后台的账单收支情况不一致

Gate Pay商户后台显示的账单信息对应的为商户余额账户（该账户仅 Gate Pay 注册商户拥有），主要用于商户的收款与资金下发操作。
Gate APP 则为 Gate 交易所的个人账户。

由于商户余额账户与个人账户相互独立，二者之间的资金与账单信息不互通，因此在 Gate 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：超过有效期的支付到账，将实际支付对应金额充值到商户支付账户中（超过有效期即时到账）。
TRANSFERRED_ADDRESS_BLOCK：交易存在安全风险，拒收，需要联系Gate Pay客户经理原路退回资金。

2. 订单状态变更通知（biztype = PAY_ADDRESS）

PAY_SUCCESS：支付成功。
PAY_CLOSE：订单过期。
PAY_EXPIRED_IN_PROCESS：等待链上确认资金。

地址支付的支付场景及订单状态判断

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 以确认最终到账总额。)

商户需要根据 订单状态和资金到账 两条回调信息判断订单是否成功。