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% 由于货币价格波动，当用户使用非稳定货币进行支付时，如果用户的支付成功，商户将按照当前市场价格支付，结算金额将扣除费用。如果损失超过商户设置的滑点，则支付将失败。如果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

订单退款规则

以下四种情况将触发ACH页面上的自动退款流程。

用户可以通过填写退款详情在界面上发起自动退款流程。

否则，如果用户在ACH端未完成退款，则订单金额将结算给商户。

失败原因	失败类型
发送金额低于订单金额，订单失败	lower_amount
支付成功，结算金额超过订单金额，订单失败	currency_fluctuation
用户发送不同加密货币或网络的加密货币	wrong_payment
支付成功，金额超过订单金额超过≥5U	/