API接入
介绍
商户通过调用收银台页面，用户使用加密货币进行支付。用户在前端使用加密货币支付后，我们通过webhook发送订单信息。
商户可以在商户后台上查看更多详细信息。
快速开始
在开始集成之前，您需要获取用于技术集成的customerNum和secret。请联系我们的业务团队获取生产环境的appid和secret。
在获取生产环境帐户之前，您可以先在我们的测试环境中进行集成。
请联系我们获取沙盒环境帐户。
环境信息
沙盒环境: https://crypto-payment-sbx.alchemytech.cc
生产环境: https://crypto-payment.alchemytech.cc
商户配置
商户入网前请以下信息以配置账户。
| 配置项 | 必填 | 详细说明 |
|---|---|---|
| 商户标志 | Y | 显示在收银台页面顶部 |
| 主按钮颜色 | N | 根据以下标准设置 |
| 加密货币 | Y | 默认选项包括所有支持的加密货币 |
| 支付通道 | Y | 支付通道 (QR Code Payment, Binance Pay, Exchange, Wallet Payment) |
| 支付滑点 | N | 配置方法：± X% 由于货币价格波动，当用户使用非稳定货币进行支付时，如果用户的支付成功，商户将按照当前市场价格支付，结算金额将扣除费用。如果损失超过商户设置的滑点，则支付将失败。收到用戶支付金额大於订单金额，以订单金额结算给商户。 例如：如果商户设置了1%的支付滑点，用户订购了价值100U的非稳定币，在支付后，如果这种非稳定币跌至价值98U，订单将失败并退款。 然而，如果这种非稳定币升至价值102U，订单将以支付101U给商户的形式结算。如果未配置，则默认由客户承担货币价格波动的风险。ACH接收用户支付后，扣除ACH费用并将整笔金额结算给商户。 |
| redirectURL | Y | 用户无论何种情况下返回商户指定的默认页面 |
| 结算货币 | Y | USDT-TRX／法币（ EUR、THB、HKD、USD） |
| 结算地址 | 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 | / |
入账与结算方式
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
5. 异常交易处理规则说明
1、对于 Internal Transaction（内部交易）、TON 非官方充值交易、SUI MoveCall 等平台暂不支持自动识别的充值方式，系统无法自动入账。如需协助人工入账，请联系客服提交相关交易信息，经审核确认后可进行处理，服务费为 47 USDT/笔。
2、对于需要填写 Memo、Tag 或 Payment ID 的币种，如因 Memo 信息填写错误导致充值未到账，用户需提供相关交易资料申请人工处理。服务费为 31 USDT/笔，且超过充值时间 15 天的申请将不予受理。
3、如提币至第三方平台后因收款方原因被退回至原出金地址，用户需提供相关证明材料申请人工认领处理。服务费为 47 USDT/笔，且超过退回时间 15 天的申请将不予受理。
4、对于触发 KYT 风险监测的交易，平台将根据具体情况进行审核，并可能要求用户补充相关证明材料。如需原路退回资产，服务费为 5 USDT/笔。
Updated 7 days ago