API接入
简介
商户通过调用收银台页面，用户使用加密货币进行支付。用户在前端使用加密货币支付后，我们通过webhook发送订单信息。
商户可以在商户后台上查看更多详细信息。
快速开始
在开始集成之前，您需要获取用于技术集成的customerNum和secret。请联系我们的业务团队获取生产环境的appid和secret。
在获取生产环境帐户之前，您可以先在我们的测试环境中进行集成。
请联系我们获取沙盒环境帐户。
环境信息
商户配置
商户入网前请以下信息以配置账户。
| 配置项 | 必填 | 详细说明 |
|---|---|---|
| 商户标志 | Y | 显示在收银台页面顶部 |
| 主按钮颜色 | N | 根据以下标准设置 |
| Token | Y | 默认选项包括所有支持的加密货币 |
| Gateway | Y | 支付通道 |
| 支付滑点 | N | 配置方法：± X% 由于货币价格波动，当用户使用非稳定货币进行支付时，如果用户的支付成功，商户将按照当前市场价格支付，结算金额将扣除费用。如果损失超过商户设置的滑点，则支付将失败。如果ACH扣除的费用超过订单金额的1%，将不会结算给商户。 例如：如果商户设置了1%的支付滑点，用户订购了价值100U的非稳定币，在支付后，如果这种非稳定币跌至价值98U，订单将失败并退款。 然而，如果这种非稳定币升至价值102U，订单将以支付101U给商户的形式结算。如果未配置，则默认由客户承担货币价格波动的风险。ACH接收用户支付后，扣除ACH费用并将整笔金额结算给商户。 |
| redirectURL | Y | 用户无论何种情况下返回商户指定的默认页面 |
| 结算货币 | Y | USDT-TRX |
| 结算地址 | Y | 接收结算的加密货币 |
| IP 白名单 | Y | 基于安全考虑，需要将商户的出口IP地址加入白名单 |
| 域名白名单 | Y | 基于安全考虑，需要将商户的域名加入白名单 |
| 手续费扣费方式 | Y | 用户承担／商户承担 例： 订单金额100，费率3% 商户承担：商户手续费成本属于商户支付，用户支付金额100，用户支付100，手续费：3，商户结算金额：100-3 用户承担：用户支付承担商户手续费，订单金额100，用户支付金额103 ，手续费：3，商户结算金额：100 |
| 退款订单回调地址 | N | 接收退款订单回调的地址 |
订单模式说明
如果需要订单增加支付金额的容错量，可以按商戶可以接受的差额设置支付滑点，或者订单模式选择充值模式；订单／充值模式由创建订单传参确认。
- 订单模式：会较验金额，支付金额低于订单金额会订单失败，用户可以在前端自行发起退款；
- 充值模式：不较验支付金额，只要支付金额能成功收到即为订单成功，按支付金额入账。
订单退款规则
以下四种情况将触发ACH页面上的自动退款流程，用户可以通过填写退款详情在界面上发起自动退款流程。
否则，如果用户在ACH端未完成退款，则订单金额将结算给商户；商户可以通过退款接口退款给用户
| 失败原因 | 失败类型 |
|---|---|
| 发送金额低于订单金额，订单失败 | lower_amount |
| 支付成功，结算金额超过订单金额，订单失败 | currency_fluctuation |
| 用户发送不同加密货币或网络的加密货币 | wrong_payment |
| 支付成功，金额超过订单金额超过≥5U | / |
Updated 16 days ago