前言
开发者可通过Epusdt提供的http api将交易功能集成至任何系统
接口统一加密方式
签名算法MD5
签名生成的通用步骤如下：
第一步，将所有非空参数值的参数按照参数名ASCII码从小到大排序（字典序），使用URL键值对的格式（即key1=value1&key2=value2…）拼接成待加密参数。
重要规则：
◆ 参数名ASCII码从小到大排序（字典序）；
◆ 如果参数的值为空不参与签名；
◆ 参数名区分大小写； 第二步，待加密参数最后拼接上api接口认证token得到待签名字符串，并对待签名字符串进行MD5运算，再将得到的MD5字符串所有字符转换为小写，得到签名signature。 注意：signature的长度为32个字节。
举例：
假设传送的参数如下：
order_id : 20220201030210321
amount : 42
notify_url : http://example.com/notify
redirect_url : http://example.com/redirect
假设api接口认证token为：epusdt_password_xasddawqe(api接口认证token可以在.env文件设置)
第一步：对参数按照key=value的格式，并按照参数名ASCII字典序排序如下：
amount=42¬ify_url=http://example.com/notify&order_id=20220201030210321&redirect_url=http://example.com/redirect
第二步：拼接API密钥并加密：
MD5(amount=42¬ify_url=http://example.com/notify&order_id=20220201030210321&redirect_url=http://example.com/redirectepusdt_password_xasddawqe)
最终得到最终发送的数据：
order_id : 20220201030210321
amount : 42
notify_url : http://example.com/notify
redirect_url : http://example.com/redirect
signature : 1cd4b52df5587cfb1968b0c0c6e156cd
PHP加密示例
function epusdtSign(array $parameter, string $signKey)
{
ksort($parameter);
reset($parameter);
$sign = '';
$urls = '';
foreach ($parameter as $key => $val) {
if ($val == '') continue;
if ($key != 'signature') {
if ($sign != '') {
$sign .= "&";
$urls .= "&";
}
$sign .= "$key=$val";
$urls .= "$key=" . urlencode($val);
}
}
$sign = md5($sign . $signKey);//密码追加进入开始MD5签名
return $sign;
}
创建交易接口
POST 创建交易
POST /api/v1/order/create-transaction
Body 请求参数
{
"order_id": "2022123321312321321",
"amount": 100,
"notify_url": "http://example.com/",
"redirect_url": "http://example.com/",
"signature": "xsadaxsaxsa"
}
请求参数
| 名称 | 位置 | 类型 | 必选 | 中文名 | 说明 |
|---|---|---|---|---|---|
| body | body | object | 否 | ||
| » order_id | body | string | 是 | 请求支付订单号 | |
| » amount | body | number | 是 | 支付金额(CNY) | 小数点保留后2位，最少0.01 |
| » notify_url | body | string | 是 | 异步回调地址 | |
| » redirect_url | body | string | 否 | 同步跳转地址 | |
| » signature | body | string | 是 | 签名 | 接口统一加密方式 |
返回示例
成功
{
"status_code": 200,
"message": "success",
"data": {
"trade_id": "202203271648380592218340",
"order_id": "9",
"amount": 53,
"actual_amount": 7.9104,
"token": "TNEns8t9jbWENbStkQdVQtHMGpbsYsQjZK",
"expiration_time": 1648381192,
"payment_url": "http://example.com/pay/checkout-counter/202203271648380592218340"
},
"request_id": "b1344d70-ff19-4543-b601-37abfb3b3686"
}
返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | 成功 | Inline |
返回数据结构
状态码 200
| 名称 | 类型 | 解释 | 说明 |
|---|---|---|---|
| » status_code | integer | 请求状态 | 请参考下方status_code返回状态码及含义 |
| » message | string | 消息 | |
| » data | object | 返回数据 | |
| »» trade_id | string | 交易号 | |
| »» order_id | string | 请求支付订单号 | |
| »» amount | float | 请求支付金额 | CNY,保留2位小数 |
| »» actual_amount | float | 实际需要支付的金额 | USDT,保留四位小数 |
| »» token | string | 钱包地址 | |
| »» expiration_time | integer | 过期时间 | 时间戳秒 |
| »» payment_url | string | 收银台地址 | |
| » request_id | string | true |
异步回调
支付成功后，Epusdt会向目标服务器发生异步通知，告知该笔交易已经支付完成。
失败Epusdt最高最多重试5次，请注意验证消息签名。
目标服务器处理完成后请返回字符串ok即可，否则Epusdt会一直重试发送消息，最高5次
POST 【异步回调地址】
Body 请求参数
{
"trade_id": "202203251648208648961728",
"order_id": "2022123321312321321",
"amount": 100,
"actual_amount": 15.625,
"token": "TNEns8t9jbWENbStkQdVQtHMGpbsYsQjZK",
"block_transaction_id": "123333333321232132131",
"signature": "xsadaxsaxsa",
"status": 2
}
请求参数
| 名称 | 位置 | 类型 | 必选 | 中文名 | 说明 |
|---|---|---|---|---|---|
| body | body | object | 否 | ||
| » trade_id | body | string | 是 | 交易号 | |
| » order_id | body | string | 是 | 请求支付订单号 | |
| » amount | body | float | 是 | 支付金额(CNY) | 小数点保留后2位 |
| » actual_amount | body | float | 是 | 实际需要支付的usdt金额(USDT) | 小数点保留后4位 |
| » token | body | string | 是 | 钱包地址 | |
| » block_transaction_id | body | string | 是 | 区块交易号 | |
| » signature | body | string | 是 | 签名 | |
| » status | body | int | 是 | 订单状态 | 1：等待支付，2：支付成功，3：已过期 |
status_code返回状态码及含义
| 状态码 | 说明 |
|---|---|
| 400 | 系统错误 |
| 401 | 签名认证错误 |
| 10002 | 支付交易已存在，请勿重复创建 |
| 10003 | 无可用钱包地址，无法发起支付 |
| 10004 | 支付金额有误, 无法满足最小支付单位 |
| 10005 | 无可用金额通道 |
| 10006 | 汇率计算错误 |
| 10007 | 订单区块已处理 |
| 10008 | 订单不存在 |
| 10009 | 无法解析参数 |
原文链接：https://www.aileym.com/blog/1909.html，转载请注明出处。
版权声明：
本站资源均由互联网用户分享或高价购买,所有资源均经过测试,去除后门,绿色安全,
希望为大家提供有价值的资源,源码仅提供下载学习之用!
我们不承担任何技术及版权问题,且不对任何资源负法律责任,如有侵权请联系站长以便删除。
本站资源均由互联网用户分享或高价购买,所有资源均经过测试,去除后门,绿色安全,
希望为大家提供有价值的资源,源码仅提供下载学习之用!
我们不承担任何技术及版权问题,且不对任何资源负法律责任,如有侵权请联系站长以便删除。
评论0