易优EuPay接口文档
易优EuPay接口采用简洁设计，支持多语言多终端调用，在保障交互安全的基础上，当前仅提供以下几个常用接口，商户方使用期间应妥善保管密钥，定期进行数据拉取，对于支付成功的订单除推送验证外，应再次调用订单查询接口进行验证。
易优EuPay对于Telegram社区生态具有很好的弥补，基于易优在Telegram内的@eupay机器人，方便商户方快速接入Telegram支付生态链，为Telegram社区运营和bot应用开发者提供高效安全的支付网关服务，易优25万+数字货币用户亦能助你如虎添翼，为你带来海量优质客源。更多说明请查看易优Eupay简介>
【更新日志】
【商户设置】
升级商户成功后，您可进入商户设置>页面，对EupayAPI接口业务进行商户相关设置，通过接口调用和消息推送完整您的支付交互流程。
接口密钥：商户方调用接口的身份验证令牌，可点击[生成密钥]更新。
服务器IP：商户方调用接口的服务器IP地址，若要调用Eupay转账接口，则必须设置加白，多IP使用逗号相连。
通知地址：Eupay订单支付成功后向商户方推送订单消息的地址，每个订单我们会推送3次通知消息，商户方无需反馈，POST推送数据如下，其中“sign”签名可用md5(商户密钥+Eupay订单编码+订单金额)进行来源验证。
{
"id": "123123354623132343", //商户方订单id
"sn": "2024062508101629697", //Eupay订单编码
"title": "测试收款订单", //商户订单标题
"money": "2.021", //订单支付金额
"pay": "1", //支付成功
"pay_money": "2.0008", //商户实收金额
"sign": "2f8b30403a8b37294486984713c3057d", //验证签名
"addtime": "1719274216", //订单创建时间
"endtime": "1719274704" //支付完成时间
}
跳转地址：若设置有，订单在线支付成功后则跳转到此商户地址，若地址为“https://www.mysite.com/my_order.html?id=”，则跳转时为“https://www.mysite.com/my_order.html?id=易优订单编码”，若未设置，用户在线支付成功后默认打开账户明细>页面。
【接口说明】
请参考以下PHP代码进行接口请求
//发送post请求
function curlPost($url,$data=null){
$ch = curl_init();
$params[CURLOPT_URL] = $url; //请求url地址
$params[CURLOPT_HEADER] = FALSE; //是否返回响应头信息
$params[CURLOPT_SSL_VERIFYPEER] = false;
$params[CURLOPT_SSL_VERIFYHOST] = false;
$params[CURLOPT_RETURNTRANSFER] = true; //是否将结果返回
$params[CURLOPT_POST] = true;
if($data){
$params[CURLOPT_POSTFIELDS] = $data;
}
curl_setopt_array($ch, $params); //传入curl参数
$content = curl_exec($ch); //执行
curl_close($ch); //关闭连接
return $content;
}
//示例
$url='https://www.otc-eu.com/api/eupay.html';
$data=array(
'action'=>'eupay', //接口名称
'key'=>'80001818:cd5028e3f88ewrwerwertssryyg', //商户密钥
);
//请求接口
$str=curlPost($url,$data);
$data_array = json_decode($str,true);
//打印返回数据
print_r($data_array);
商户查询：
使用该接口可以查询商户基本信息和当前账户余额。
接口地址：/api/eupay.html
请求类型：POST
请求参数：*action="eupay"，*key="商户密钥"
返回数据：status 状态码，info 提示信息，data 数据信息
{
"status": "success",
"info": "账户查询成功",
"data": {
"eupay_id": 80099988, //商户id
"eupay_name": "测试商户", //商户名称
"eupay_usdt": 36.7597, //USDT余额
"eupay_rates": 0.01, //服务费率
"user_id": "oXdwbHYKvAk9cgz6EB", ///易优id
"user_name": "xiaoyaozi1998", //易优昵称
"user_time": 1706514271, //注册时间
"user_url": "https:\/\/www.otc-eu.com\/user.html?id=oXdwbHYKvAk9cgz6EB" //易优主页
}
}
Eupay转账：
商户可以使用该接口向其他易优Eupay账户即时转账USDT，该接口单笔转账限额为 1000USDT，无转账手续费，此接口调用端ip必须与商户设置内服务器ip地址相同。
接口地址：/api/eupay.html
请求类型：POST
请求参数：*action="eupay_to"，*key="商户密钥"，*eupay_id="收款账户"，*to_usdt="转账数量"
返回数据：status 状态码，info 提示信息，data 数据信息
{
"status": "success",
"info": "Eupay转账成功",
"data": {
"id": "2024062516190985842", //账目id
"type": "out", //账目类型 in(收款) out(转出)，
"eupay_id": 80000019, //对方id
"eupay_name": "jiezongbang3867", //对方Eupay账户名
"usdt": 1.001, //出入数量
"user_id": "tyMEEvqxmyuJl4Q3S254xaiySngG6uLq", //对方易优id
"user_name": "jiezongbang3867", //对方易优昵称
"user_url": "https:\/\/www.otc-eu.com\/user.html?id=tyMEEvqxmyuJl4Q3S254xaiySngG6uLq", //对方易优主页
"addtime": 1719303549 //账目日期
}
}
Eupay账目记录：
使用该接口可以查询商户Eupay转账收款历史记录，每页10条数据。
接口地址：/api/eupay.html
请求类型：POST
请求参数：*action="eupay_list"，*key="商户密钥"，*page="页码"
返回数据：status 状态码，info 提示信息，data 数据信息
{
"status": "success",
"info": "数据获取成功",
"data": [{
"id": "2024052217312147234",
"type": "out",
"usdt": 1,
"eupay_id": 80000019,
"eupay_name": "jiezongbang3867",
"user_id": "tyMEEvqxmyuJl4Q3S254xaiySngG6uLq",
"user_name": "jiezongbang3867",
"user_url": "https:\/\/www.otc-eu.com\/user.html?id=tyMEEvqxmyuJl4Q3S254xaiySngG6uLq",
"addtime": 1719369557
}, {
"id": "2024052217305881472",
"type": "in",
"usdt": 1,
"eupay_id": 80000019,
"eupay_name": "jiezongbang3867",
"user_id": "tyMEEvqxmyuJl4Q3S254xaiySngG6uLq",
"user_name": "jiezongbang3867",
"user_url": "https:\/\/www.otc-eu.com\/user.html?id=tyMEEvqxmyuJl4Q3S254xaiySngG6uLq",
"addtime": 1719369557
}]
}
订单创建：
使用该接口可以创建商户收款订单，创建成功返回易优支付页面地址，如商户方多次提交订单id相同金额相同，将视为同一订单，返回该id未支付未过期的近期订单。
接口地址：/api/eupay.html
请求类型：POST
请求参数：*action="order_add"，*key="商户密钥"，*money="收款USDT"， id="商户方订单id"，title="商户方订单标题"
返回数据：status 状态码，info 提示信息，data 数据信息
{
"status": "success",
"info": "订单创建成功",
"order": {
"id": "12312335462673434", //商户方订单id (可为空)
"sn": "2024062610192698272", //易优Eupay订单唯一编码
"title": "在线购物支付", //订单标题 (为空时“商户[8000*****]收款订单”)
"money": 1, //订单USDT支付金额
"pay": 2, //订单状态 (1=支付成功，2=待付款，3=已取消)
"addtime": 1719368366, //订单创建时间
"endtime": 1719454766, //订单超时或完成时间
"url_web": "https:\/\/www.otc-eu.com\/eupay_order.html?sn=2024062610192698272", //易优在线支付地址
"url_bot": "https:\/\/t.me\/eupay?start=ordershow_2024062610192698272" //Telegram内支付链接
}
}
订单查询：
使用该接口可以查询该笔订单支付状态，如支付成功，并返回支付用户数据。
接口地址：/api/eupay.html
请求类型：POST
请求参数：*action="order_query"，*key="商户密钥"，*sn="Eupay订单编码"
返回数据：status 状态码，info 提示信息，data 数据信息
{
"status": "success",
"info": "订单查询成功",
"order": {
//订单数据
"id": null,
"sn": "2024061103183585258",
"title": "商户[80099988]收款订单",
"money": 1, //订单金额
"pay": 1, //支付成功
"pay_money": 0.99, //商户实收金额
"user": {
//支付用户数据(如有)
"eupay_id": 80000026,
"user_id": "E8GtwVpaJd3a15c1T0OeU16RRABloxab",
"user_name": "otc-eu.com",
"user_time": 1640941103,
"user_url": "https:\/\/www.otc-eu.com\/user.html?id=E8GtwVpaJd3a15c1T0OeU16RRABloxab"
},
"addtime": 1718075915,
"endtime": 1718076262,
"url_web": "https:\/\/www.otc-eu.com\/eupay_order.html?sn=2024061103183585258",
"url_bot": "https:\/\/t.me\/eupay?start=ordershow_2024061103183585258"
}
}
订单记录：
使用该接口可以查询Eupay商户订单历史记录，每页10条数据。
接口地址：/api/eupay.html
请求类型：POST
请求参数：*action="order_list"，*key="商户密钥"，*page="页码"
返回数据：status 状态码，info 提示信息，data 数据信息
{
"status": "success",
"info": "数据获取成功",
"data": [{
"id": "12312335462673434",
"sn": "2024062610192698272",
"title": "在线购物支付1",
"money": 1,
"pay": 2,
"pay_money": 0,
"user": null,
"addtime": 1719368366,
"endtime": 1719454766,
"url_web": "https:\/\/www.otc-eu.com\/eupay_order.html?sn=2024062610192698272",
"url_bot": "https:\/\/t.me\/eupay?start=ordershow_2024062610192698272"
},{
"id": "123123354623132343",
"sn": "2024062508101629697",
"title": "在线购物支付2",
"money": 2.021,
"pay": 1,
"pay_money": 2.0008,
"user": {
"eupay_id": 80000019,
"user_id": "tyMEEvqxmyuJl4Q3S254xaiySngG6uLq",
"user_name": "jiezongbang3867",
"user_time": 1708613409,
"user_url": "https:\/\/www.otc-eu.com\/user.html?id=tyMEEvqxmyuJl4Q3S254xaiySngG6uLq"
},
"addtime": 1719274216,
"endtime": 1719274704,
"url_web": "https:\/\/www.otc-eu.com\/eupay_order.html?sn=2024062508101629697",
"url_bot": "https:\/\/t.me\/eupay?start=ordershow_2024062508101629697"
}, {
"id": "1231233546231323213",
"sn": "2024062109064968411",
"title": "在线购物支付3",
"money": 2,
"pay": 1,
"pay_money": 1.98,
"user": {
"eupay_id": 80000019,
"user_id": "tyMEEvqxmyuJl4Q3S254xaiySngG6uLq",
"user_name": "jiezongbang3867",
"user_time": 1708613409,
"user_url": "https:\/\/www.otc-eu.com\/user.html?id=tyMEEvqxmyuJl4Q3S254xaiySngG6uLq"
},
"addtime": 1718932009,
"endtime": 1718964308,
"url_web": "https:\/\/www.otc-eu.com\/eupay_order.html?sn=2024062109064968411",
"url_bot": "https:\/\/t.me\/eupay?start=ordershow_2024062109064968411"
}]
}
