API接入
介绍
商户通过调用收银台页面，用户使用加密货币进行支付。用户在前端使用加密货币支付后，我们通过webhook发送订单信息。
商户可以在商户后台上查看更多详细信息。
快速开始
在开始集成之前，您需要获取用于技术集成的customerNum和secret。请联系我们的业务团队获取生产环境的appid和secret。
在获取生产环境帐户之前，您可以先在我们的测试环境中进行集成。
请联系我们获取沙盒环境帐户。
环境信息
沙盒环境: https://crypto-payment-sbx.alchemytech.cc
生产环境: https://crypto-payment.alchemytech.cc
商户配置
商户入网前请以下信息以配置账户。
配置项 | 必填 | 详细说明 |
|---|---|---|
商户标志 | Y | 显示在收银台页面顶部 |
主按钮颜色 | N | 根据以下标准设置 |
Token | Y | 默认选项包括所有支持的加密货币 |
Gateway | Y | 支付通道 |
支付滑点 | N | 配置方法：± X% |
redirectURL | Y | 用户无论何种情况下返回商户指定的默认页面 |
结算货币 | Y | USDT-TRX／法币 |
结算地址 | Y | 接收结算的加密货币 |
IP 白名单 | Y | 基于安全考虑，需要将商户的出口IP地址加入白名单 |
域名白名单 | Y | 基于安全考虑，需要将商户的域名加入白名单 |
手续费扣费方式 | Y | 用户承担／商户承担 |
退款订单回调地址 | N | 接收退款订单回调的地址 |
订单模式说明
如果需要订单增加支付金额的容错量，可以按商戶可以接受的差额设置支付滑点，或者订单模式选择充值模式；订单／充值模式由创建订单传参确认。
- 订单模式：会较验金额，支付金额低于订单金额会订单失败，用户可以在前端自行发起退款；
- 充值模式：不较验支付金额，只要支付金额能成功收到即为订单成功，按支付金额入账。
订单退款规则
以下四种情况将触发ACH页面上的自动退款流程，用户可以通过填写退款详情在界面上发起自动退款流程。
否则，如果用户在ACH端未完成退款，则订单金额将结算给商户；商户可以通过退款接口退款给用户
| 失败原因 | 失败类型 |
|---|---|
| 发送金额低于订单金额，订单失败 | lower_amount |
| 支付成功，结算金额超过订单金额，订单失败 | currency_fluctuation |
| 用户发送不同加密货币或网络的加密货币 | wrong_payment |
| 支付成功，金额超过订单金额超过≥5U | / |
入账与结算方式
1. 入账方式
USDT账户
- 用户完成支付后，账户系统会根据当前市场汇率进行结算，扣除交易手续费，并将相应的USDT金额入账至待结算账户。
法币账户
- 用户完成支付后，账户系统会根据当前市场汇率进行结算，扣除交易手续费，并将相应的法币金额（如欧元、美元等）入账至待结算账户。
2. 结算方式
S0 结算
- 账户系统实时结算至可提现账户。此结算方式确保用户在支付完成后可以立即提现，且用户不可触发退款。
D+X 结算
- 账户系统每天 00:00:00（UTC+8 时区）对待结算账户中的订单进行结算，所有 X 小时之前的待结算金额将被结算至可提现账户。
D+X 结算示例：
- 假设当前时间为 2025年1月20日 00:00:00，X 为 24，则该结算将包括所有在 2025年1月19日 00:00:00 之前待结算账户中的订单。
注意事项：
- 在结算时，若用户已发起退款的订单，支付订单将延期至下一个结算日。
- 在结算时，若用户未发起退款的订单，退款订单状态将改为
TIMEOUT，支付订单会被结算。
3. 提现方式
USDT账户
USDT账户支持以下提现方式：
- USDT提现
- 法币提现
法币账户
法币账户仅支持法币提现。
4. 法币提现支持的币种
- EUR、THB、HKD、USD
Updated 22 days ago