# luckWinPay接口文档

本站地址：https://doc.lucky-winpay.com (opens new window)

# 本站内容介绍

lucky-winpay支付文档

商户系统

1.商户账号申请：

联系平台运营人员获取

2.商户系统网址

https://merchant.lucky-winpay.com (opens new window)

3.商户登录系统

账户：联系平台运营人员提供

注：首次登陆后记得修改初始密码哦！！！

# 数字签名规范

# 商户测试账号基本信息

测试商户基本信息：

"商户名":TestingMerchants
"商户编号":861100000010620
"商户秘钥":6640768026EFD8DCB4E058F38AE512C9
"平台公钥":MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQCmKYf2CA+Tzh5uWQ2NZvlbCelf95JOOysXDWqHYbT53qHYRp6rKp1wOH+EHr2ZfRvrCrXfTM/ubFhchZrsIpRGtwgZqHeRodlM9Y6rtyKHznoBdRTC78zE9aIuFYv4f5lK0pjdt7xpXw4I1RSaDP19N5RpeKf7ALsxYcpxJ6wAMwIDAQAB

1
2
3
4

测试商户RSA公钥：

MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQC9XmTEKfKy5BtKE6j1261ufZKTDNoXTHLxvlxHYIITm5ZU8cRgV5oGAgdvJ/1HWw/mJccQBd8FkzFZj7FIfiVwFgUS2jXMlo2RMcyo+qLNOoQngQcXmxac3IBmchU80pmfqdHnbrViVptD/ng2ght678FwzuovBd8GEBoKPUosxQIDAQAB

测试商户RSA私钥：

MIICeAIBADANBgkqhkiG9w0BAQEFAASCAmIwggJeAgEAAoGBAL1eZMQp8rLkG0oTqPXbrW59kpMM2hdMcvG+XEdgghObllTxxGBXmgYCB28n/UdbD+YlxxAF3wWTMVmPsUh+JXAWBRLaNcyWjZExzKj6os06hCeBBxebFpzcgGZyFTzSmZ+p0edutWJWm0P+eDaCG3rvwXDO6i8F3wYQGgo9SizFAgMBAAECgYEAnMFIlIFM3/ynAljn4izoka/s50EaP3MPK0GyzXr78hM3DDXdowqg+xwu3zqxFKIytQbMk1zo0oqXrVWfIS0a+xMVGmvEBQ8gb8bjxhK3GRP9wPhqtm2lreBIPxdlK49/4zO89xtwCwAXRaL+Nb3WiSTWPZKwGq9CmPoYvbg7gQECQQDeV4OjvJD2S5NKcfkFEaTV05XhmDVRlMEfLyLMzBDhbiTbilHHVvRM6eDfoD32j7Knk+3X1Wav+k/QVbX+1XqhAkEA2gkPpcV1QdXIhtrgU1qvEL8BDc8/y4f57mJIlVNGZwgTQ/ynbFlU1DLAknxOv+fTEBeHby218bvJ3fIQwlpDpQJBALwDEMPSXlqGycQ34DUTGGngA2vCg8O6oBu4hhrbrKKTuwMSUdjYhLjNRGSVYhAurwnZo1PRloXUis1GzSDycEECQGN1NK0SqI1Sfrl9SEzdlfQWnN12x4wJR+oE7UUoinnfRiKCMsEK8tYlHJD1oVqK3k193irJ+C//0HKsxBZT5H0CQQDbSXEQYN3olvDwVNwZ47I2/X5F47z1yqHK2dAJQDN/1QvjTYHPMM85qpAHLUi1jKp3eEEppX/4nfdSGchMzFcx

所有接口的签名规范：

将所有参数按照字段名的 ASCII 码(字典序)从小到大排序后使用 QueryString的格式（即key1=value1&key2=value2…）拼接成签名串, 空参数和sign不参与签名

注意以下重要规定：

参数名ASCII码从小到大排序（字典序）；
使用 QueryString 的格式（即key1=value1&key2=value2…）拼接；
验证调用返回或支付中心主动通知签名时，传送的sign参数不参与签名，将生成的签名与该sign值作校验；
空值不参与签名；

# RSA公钥生成步骤规则参考

访问http://web.chacuo.net/netrsakeypair (opens new window) 点击生成密钥对,删除RSA生成格式->BEGIN RSA PRIVATE KEY和END PUBLIC KEY,即第一行和最后一行
访问http://www.ab173.com/gongju/other/compress.php (opens new window) 将生成的公钥和私钥复制到压缩文本框中去除换行和空格
把公钥上传至商户后台,平台会使用该公钥进行解密并且验签。
私钥自己隐秘保存(加密用)

# Md5加密格式案例(案例只做参考)

1.所有查询接口和通知接口使用MD5加密，在签名串最后加上秘钥&key=key形成最终签名串

例:

加密前

busi_code=100303&ccy_no=INR&countryCode=IND&goods=goods&mer_no=xxx
&mer_order_no=1627975567581P05&notifyUrl=http://www.google.com
&order_amount=500.00&pageUrl=http://baidu.com&pemail=test@gmail.com
&phone=8696100462&pname=zhangsan&timeout_express=30m&key=xxx

1
2
3
4

加密后

16c17647ca9f4fa080cef02bd6a7a588

# RSA加密格式案例(案例只做参考)

1.支付、代付、补单接口使用RSA加密(密钥长度1024位,密钥格式PKCS#8方式)加密
2.使用工具类或者在线网址生成公钥和私钥,私钥自己保存,公钥上传至商户后台.使用私钥加密签名串
3.加密做base64转码再进行URL编码(只对sign值做url编码)
备注：不需要在最后面拼接&key=key

例:

加密前

busi_code=100303&ccy_no=INR&goods=test&mer_no=xxx&mer_order_no=testOrder1650441426386&
notifyUrl=http://www.google.com&order_amount=100&pageUrl=http://www.baidu.com&pemail
=test@mail.com&phone=9852146882&pname=Zhang San

1
2
3

加密后

hv_OoRZejna_3baya6wSRadYNvV718BQ_QLthR56OWkLx-4FrOKCawwM_4y33rcjpLM8
bwqr_mRYGMQ19PKKmBB5HABQXhBBZ76x2Dqyl77kRSOHlt3akG8mKGiq8p8etP-jS8va
2eHpLS96lTt-Kc5wcgrlFjFwZ1s8xlLa0NQOIlED1afGnLEsZRXyf0oyZY-NpOUDJYHG
us6aTfbfR5gd6Z-yQ8h4ELK8D_UNJTUQBVkxL4ffXI2KR2fGoWyaOjX6ZCXwgA9yg5Yk
p5whwtzckE0fQzZeFJPXKn_ad_tTGcdx5MGnKcm8I_vT39a8HjfQcT3VWskGDsNr5Tt8VA

1
2
3
4
5

# 加密算法工具类

访问https://core.lucky-winpay.com/download (opens new window)

# 支付类型编码

支付类型编码	支付类型说明
100303	印度代收

# 支付业务

# 支付下单

简要描述：

商户业务系统通过支付下单接口发起支付收款订单。

请求URL：

https://core.lucky-winpay.com/ty/orderPay (opens new window)

请求方式：

Post

Header：

参数名称	是否必填	类型	参考值	描述
Content-Type	是	String	application/json	HTTP请求内容类型，仅支持application/json。

请求参数说明

序号	参数名	参数名称	类型	是否必填	说明
1	mer_no	商户号	String	是	商户编号
2	mer_order_no	商户订单号	String	是	商户必须保证订单号唯一
3	pname	姓名	String	是	案例:zhang san(必须是字母),如没有可以固定上传
4	pemail	邮箱	String	是	案例:test@gmail.com(需要符合邮箱格式),如没有可以固定上传
5	phone	手机号	String	是	案例:13122336688(纯数字,不需要加区号)
6	order_amount	交易金额	String	是	金额,两位小数
7	ccy_no	币种编码	String	是	币种编码例:INR:印度卢比,BRL:巴西币
8	busi_code	支付类型编码	String	是	100303 详情见：支付类型编码
9	notifyUrl	异步通知地址	String	是	支付成功后，平台主动通知商家系统，商家系统必须指定接收通知的地址。
10	pageUrl	支付成功，页面跳转地址	String	否	支付成功,页面跳转地址
11	sign	数字签名	String	是	详见：数字签名规范

请求参数示例

{
  "mer_no": "xxx",
  "phone": "9852146882",
  "pname": "ZhangSan",
  "order_amount": "100",
  "sign": "hv_OoRZejna_3baya6wSRadYNvV718BQ_QLthR56OWkLx-4FrOKCawwM_4y33rcjpLM8bwqr_mRYGMQ19PKKmBB5HABQXhBBZ76x2Dqyl77kRSOHlt3akG8mKGiq8p8etP-jS8va2eHpLS96lTt-Kc5wcgrlFjFwZ1s8xlLa0NQOIlED1afGnLEsZRXyf0oyZY-NpOUDJYHGus6aTfbfR5gd6Z-yQ8h4ELK8D_UNJTUQBVkxL4ffXI2KR2fGoWyaOjX6ZCXwgA9yg5Ykp5whwtzckE0fQzZeFJPXKn_ad_tTGcdx5MGnKcm8I_vT39a8HjfQcT3VWskGDsNr5Tt8VA",
  "notifyUrl": "http://www.google.com",
  "pageUrl": "http://www.baidu.com",
  "ccy_no": "INR",
  "pemail": "test@mail.com",
  "busi_code": "100303",
  "mer_order_no": "testOrder1650441426386"
}

1
2
3
4
5
6
7
8
9
10
11
12
13

返回参数说明

序号	参数名	参数名称	类型	说明
1	mer_no	商户号	String	原样返回
2	mer_order_no	商户订单号	String	原样返回
3	order_amount	交易金额	String	原样返回
4	busi_code	支付类型编码	String	支付类型编码
5	notifyUrl	异步通知地址	String	原样返回
6	pageUrl	支付成功，页面跳转地址	String	原样返回
7	order_no	平台订单号	String	下单成功返回平台唯一订单号
8	order_time	订单时间	String	时间戳：(格式为yyyyMMddHHmmss 4位年+2位月+2位日+2位时+2位分+2位秒)
9	status	订单提交状态	String	成功：SUCCESS 失败：FAIL
10	order_data	支付链接	String	下单成功时有值
11	upi	下单账号	String	下单成功时有值
12	link	二维码信息	String	下单成功时有值
13	pname	下单人姓名	String	原路返回
14	pemail	下单人email姓名	String	原路返回
15	phone	手机号	String	原路返回
16	ccy_no	币种编码	String	原路返回
17	sign	数字签名	String	下单成功返回详见：数字签名规范
18	err_code	错误码	String	请求失败返回错误码
19	err_msg	错误信息	String	请求失败返回错误描述

返回参数示例

{
  "order_no": "2406240000000057242115043852",//平台订单号
  "mer_no": "861100000014282",
  "pname": "zhangsan",
  "sign": "ej-S5i5P75AX6y8Qavg9_xmdafT_VOEgtQAAizybVsUM3kIom1Ai_w9Stwvlb1WS9oiJ0s12_WuftE3TNh9qEACkd9T5Pd1VOIb-lgjCnjNsJU53W5ELK1Bi6D8DtyBGIVLnY_EqOHVuat6nxosnntBZibwoj4NKV4IxZAlbMQ6JgDs733-p_W_oN_RA7EIo-zlh7oVGBot_Xk7c2hOz442EfjZj_kmzo8m9t_UgcNMSPdlzOxlzH0hPLK1ARrSneIGMguVpfR4Y0lrjpqcjRV5Ser5kaX9yEf7753xBVPtcdKHszARMC4CPwv8YD73RqDRupyQTd_G-msIz7CFD1l4QtAnxlYB3H0t-gb0bIzPlgyDH-0r8KPSe0695guT2vhq2qVneQr_9RSyP1uY9EXZA3vIFFKAeyvqCGETATZdcHUfTle7BIb7QKYy_e3IFChFGYTeBf6Ny0_U5U6vJp7Y5zJ69gWNjtz_az-O8MRafQo8ayI0SzTHpRlYcOjiEPOqPQM5OBI8t6ZvpGFrx8FHT1kfZqpNdLQBkVWNXunlL5OBmpMeRbMrDHPbQ7FS4UlGB9GwCCH-iqwKVs7P3m_t1f9-YHNsr_hi31RftSI5OSUz6EbSkuufn-BDxEvVvK-GBontyI76r5PJrifhk8voO5IlFlQz6JbJYNQiVxlM",
  "order_time": "20240624115043",
  "pemail": "test@gmail.com",
  "phone": "6789322980",
  "order_data": "https://lucky.tatatapay.com/v1.0/api/payOrder?orderId=3202406241150444&sign=16CEE42F2B6BC4C558F10D5DDDCAD8DE",
  "order_amount": "800.00",
  "notifyUrl": "https://wb.babyforever.top/api/pay/notify",
  "pageUrl": "http://www.baidu.com",
  "ccy_no": "INR",
  "busi_code": "100303",
  "mer_order_no": "1111719201041754",
  "status": "SUCCESS"
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

# 支付查询

简要描述：

商户业务系统通过支付查询接口，查询支付收款订单，支付中心会返回订单最新的数据。

请求URL：

https://core.lucky-winpay.com/ty/orderQuery (opens new window)

请求方式：

Post

Header：

参数名称	是否必填	类型	参考值	描述
Content-Type	是	String	application/json	HTTP请求内容类型，仅支持application/json。

请求参数说明

序号	参数名	参数名称	类型	是否必填	说明
1	mer_no	商户号	String	是	商户编号
2	mer_order_no	商户订单号	String	否	商户订单号
3	order_no	平台订单号	String	否	平台订单号，（和商户订单号2选1，两个都传只会查平台订单号）
4	request_no	请求流水号	String	是	每次请求,请求流水号需要不同
5	request_time	请求时间	String	是	时间戳格式:( yyyyMMddHHmmss)
6	sign	数字签名	String	是	详见：数字签名规范

请求参数示例

{
  "order_no": "2104060000001717561144728475",
  "mer_no": "xxx",
  "request_time": "20210406145308",
  "request_no": "1617695588427",
  "sign": "xxx",
  "mer_order_no": "1617695248072"
}

1
2
3
4
5
6
7
8

返回参数实例

序号	参数名	参数名称	类型	说明
1	mer_no	商户号	String	原样返回
2	mer_order_no	商户订单号	String	原样返回
3	order_amount	订单金额	String	订单金额
4	order_no	平台订单号	String	平台订单号
5	utr	utr	String	平台支付utr
6	pay_amount	实际支付金额	String	实际支付金额
7	order_time	订单时间	String	时间戳：(格式为yyyyMMddHHmmss 4位年+2位月+2位日+2位时+2位分+2位秒)
8	pay_time	支付时间	String	时间戳：(格式为yyyyMMddHHmmss 4位年+2位月+2位日+2位时+2位分+2位秒)
9	order_status	订单状态	String	UNPAY:待支付 SUCCESS:成功 FAIL:失败
10	order_err_code	订单错误码	String	错误码
11	order_err_msg	订单错误信息	String	错误描述
12	sign	数字签名	String	详见：数字签名规范
13	query_err_code	查询错误码	String	请求失败返回错误码
14	query_err_msg	查询错误信息	String	请求失败返回错误描述

返回参数示例

{
  "order_no": "2104060000001717561144728475",
  "mer_no": "xxx",
  "order_err_msg": "success",
  "request_no": "1617695588427",
  "query_status": "SUCCESS",
  "sign": "xxx",
  "order_time": "20210406144728",
  "order_status": "UNPAY",
  "order_err_code": "0",
  "request_time": "20210406145308",
  "order_amount": "100000.00",
  "mer_order_no": "1617695248072",
  "query_err_code": "000002",
  "query_err_msg": "orderQuery success"
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

# 支付补单

简要描述：

商户通过订单号与银行流水UTR进行补发通知。

请求URL：

https://core.lucky-winpay.com/ty/orderPayPatch (opens new window)

请求方式：

Post

Header：

参数名称	是否必填	类型	参考值	描述
Content-Type	是	String	application/json	HTTP请求内容类型，仅支持application/json。

请求参数说明

序号	参数名	参数名称	类型	是否必填	说明
1	mer_no	商户号	String	是	商户编号
2	mer_order_no	商户订单号	String	是	商户必须保证订单号唯一
3	utr	补单utr	String	是	补单utr
4	sign	数字签名	String	是	详见：数字签名规范

请求参数示例

{
  "mer_no": "861100000033178",
  "utr": "154637893541",
  "sign": "907835048d3eecc672d5f600e08bce99",
  "mer_order_no": "1660283627634air"
}

1
2
3
4
5
6

返回参数说明

序号	参数名	参数名称	类型	说明
1	data	补单详情	String	status 为true时才有值,返回SUCCESS表示成功，其他提示信息表示补单失败
2	errCode	错误码	String	原样返回
3	errMsg	错误信息	String	原样返回
4	status	补单状态	Boolean	true,只代表接口请求成功,实际订单状态以异步通知为准

返回参数示例

{
  "data": "此订单支付状态成功,请核实!",
  "errCode": "",
  "errMsg": "",
  "status": true
}

1
2
3
4
5
6
7

# 查询utr

简要描述：

根据utr查询订单信息以及状态。

请求URL：

https://core.lucky-winpay.com/ty/queryOrderUtr (opens new window)

请求方式：

Post

Header：

参数名称	是否必填	类型	参考值	描述
Content-Type	是	String	application/json	HTTP请求内容类型，仅支持application/json。

请求参数说明

序号	参数名	参数名称	类型	是否必填	说明
1	mer_no	商户号	String	是	商户编号
2	utr	utr	String	是	订单utr
3	sign	数字签名	String	是	详见：数字签名规范

请求参数示例

{
  "mer_no": "861100000033178",
  "utr": "306386329131",
  "sign": "907835048d3eecc672d5f600e08bce99",
}

1
2
3
4
5

返回参数说明

序号	参数名	参数名称	类型	说明
1	errCode	错误码	String	原样返回
2	errMsg	错误信息	String	原样返回
3	status	补单状态	Boolean	true,只代表接口请求成功,实际订单状态以异步通知为准
4	data	补单详情	String	status 为true时才有值

data：

序号	参数名	参数名称	类型	说明
1	amount	订单金额	String	订单金额
2	merchant_order_no	商户订单号	String	到账已核销情况下返回
3	utr_status	订单状态	String	utr状态例如： 1没有查到 2到账已核销 3到账未核销 4查到已使用(非当前商户)
4	resMsg	msg	String	提示信息

返回参数示例

{
    "data": {
        "utr_status": "2",
        "amount": "200.00",
        "merchant_order_no": "1111714109347357",
        "resMsg":"查询成功"
    },
    "errCode": "",
    "errMsg": "",
    "status": true
}

1
2
3
4
5
6
7
8
9
10
11

# 查询upi

简要描述：

查询近期使用upi地址。

请求URL：

https://core.lucky-winpay.com/ty/checkRecentUpi (opens new window)

请求方式：

Post

Header：

参数名称	是否必填	类型	参考值	描述
Content-Type	是	String	application/json	HTTP请求内容类型，仅支持application/json。

请求参数说明

序号	参数名	参数名称	类型	是否必填	说明
1	mer_no	商户号	String	是	商户编号
2	upi	upi	String	是	upi账号
3	sign	数字签名	String	是	详见：数字签名规范

请求参数示例

{
  "mer_no": "861100000033178",
  "upi": "sdffga3131rp@sbi",
  "sign": "907835048d3eecc672d5f600e08bce99",
}

1
2
3
4
5

返回参数说明

序号	参数名	参数名称	类型	说明
1	errCode	错误码	String	原样返回
2	errMsg	错误信息	String	原样返回
3	status	补单状态	Boolean	true,只代表接口请求成功,实际订单状态以异步通知为准
4	data	补单详情	String	status 为true时才有值

data：

序号	参数名	参数名称	类型	说明
1	query_status	查询状态	String	SUCCESS 成功,FAIL 失败(表示是否是本平台近期的upi)
2	query_message	查询说明	String	查询upi的说明信息
3	errCode	错误码	String	原样返回
4	errMsg	错误信息	String	原样返回
5	status	补单状态	Boolean	true,只代表接口请求成功,实际订单状态以异步通知为准

返回参数示例

{
  "data": {
      "query_status": "SUCCESS",
      "query_message": "SUCCESS"
    },
    "errCode": "",
    "errMsg": "",
    "status": true
}

1
2
3
4
5
6
7
8
9

# 代付业务

# 单笔代付

简要描述：

商户业务系统通过支付查询接口，查询支付收款订单，支付中心会返回订单最新的数据。

请求URL：

https://settle.lucky-winpay.com/withdraw/singleOrder (opens new window)

请求方式：

Post

Header：

参数名称	是否必填	类型	参考值	描述
Content-Type	是	String	application/json	HTTP请求内容类型，仅支持application/json。

请求参数说明

序号	参数名	参数名称	类型	是否必填	说明
1	mer_no	商户号	String	是	平台分配的唯一商户编号
2	mer_order_no	商户订单号	String	是	商户订单号需要唯一,不能重复
3	acc_no	平收款账号	String	是	收款账号
4	acc_name	收款户名	String	是	收款姓名
5	ccy_no	币种	String	是	币种例:INR:印度卢比
6	order_amount	金额	String	是	卢比为单位,保留二位小数
7	bank_code	银行编码	String	是	印度代付类型,填UPI表示的是UPI代付,IMPS/BANK/PAYTM表示银行卡代付.
8	mobile_no	手机号	String	是	手机号
9	email	邮箱	String	是	邮箱
10	province	省份	String	是	印度银行卡代付需要填写(IFSC)
11	notifyUrl	回调地址	String	是	代付提交成功,有最终结果,均会向该地址发送回调
12	summary	备注	String	是	备注
13	sign	数字签名	String	是	详见：数字签名规范
14	identity_no	身份证号	String	否	巴西代付必须填写收款人税号(CPF)，相当于身份ID,11位或14位。
15	identity_type	证件类型	String	否	巴西PIX代付,需要填写,分为CPF, CNPJ, PHONE, EMAIL, EVP五种之一。

请求参数示例

{
  "summary": "summary",
  "bank_code": "BANK",
  "acc_name": "zhangsan",
  "mer_no": "xxx",
  "province": "PYTM0123456",
  "order_amount": "10",
  "mobile_no": "423524127",
  "email":"sdahdasdhajsd15616@gmail.com",
  "acc_no": "912523192592",
  "sign": "ADtr_JPO1WKUnhOSvfdkAPiLsHsXDbrjpIB0k9QCdGo90EvZzvNGJpLsr7INXXhnN_XmePCCFdNaqMoye0mbVYWbVfC_koEZ79mNtcssjeD2RshxdND7viU1VQWiZEs8rRYJL0wSIAsFxWw7T8nd8SDQwkHBun5wS_QS44GWKY4QAhjK6yVTsQfKx69YoDLyR-PdII9dwhk6MJxwpSIKURbOVbPFH6PEcLICpgY5JCXWp_Y5gi5zUP8Xf5R9AMYt3UCA6VfteL_Z_NXW8pPcYXLvf69yPPiIKZxt_dFPPhXZgx51Q2w_S1go63PlAPpszHnxyXLi4cgGK3WF6qVpmw",
  "notifyUrl": "http://www.google.com",
  "ccy_no": "INR",
  "mer_order_no": "testOrder1650535029326"
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

返回错误说明

序号	参数名	参数名称	类型	说明
1	status	订单提交状态	String	仅表示订单受理状态非订单代付状态; SUCCESS：成功 FAIL:失败
2	err_code	错误码	String	错误码
3	err_msg	错误信息	String	错误描述

当status为SUCCESS时，以下参数才返回

序号	参数名	参数名称	类型	说明
1	mer_no	商户号	String	原样返回
2	mer_order_no	商户订单号	String	原样返回
3	order_no	平台订单号	String	订单金额
4	account_no	子账户号	String	原样返回
5	acc_no	实收款账号	String	原样返回
6	acc_name	收款户名	String	原样返回
7	ccy_no	币种	String	原样返回
8	order_amount	金额	String	原样返回
9	summary	摘要	String	原样返回

请求成功返回参数示例

{
    "summary": "代付测试",
    "order_no": "202406250000000088220161629375",
    "bank_code": "BANK",
    "mer_no": "861100000010620",
    "mobile_no": "6789322980",
    "sign": "iAekl4sq_ZvusA3oJI5CUhDsUWzpkMoHHkvQ5gc89qz96MFdD5CVq9AnzRtIXLcx8LvSmnOIxR9rjAbs5wIQA-zKvjf-lTRmsQsOGn8HWrMI-3AX4D7iCwXOgczrgo_HWQcggzW31xa3X-s2bY5DFea4a2HGy6xamQN-WfAU9fCT8PAFNkbZVMGdJ9kwdIta9E8C2u-X5l0GIkUQwNWRC7mpfIpZrq6cyOhZvXs-UQVZ5Mt-gXd7KKvIKDhr0KLo1agzmT0SP07r32XbfYize23SUH0FoF1fR4VF1mIb_NOb4QQ-h1K0XPbXZnYpoZw1e0JESYaF0H5abBpRusyjGitU-6xQybSH9exUiyj8wj6cqClComPBl0jx5RFiyb2hb4DhV4o2BUZ9UDa8OqZGM9fXIrNRvuptQm1c2R-JU9OOBYgnbBEX8Z3BciL6LcZlMm2i5qq8DeK4F0WTlDXrvpwlxNKjPuDo8fEwSFNc9aGbzRox6offYlRHIOtje-2jBePrmEJO4Lo2AJhYF3CBh0RSR8lNzcWunusQj3iv9Y1Utzpv9KGVn_h1AMj13M4K2v-9fY3nxwRQtjNk-N12DT98-iQAo7H3N5FR34iIadave-D7hBz8v3LBxD4Wr8FG4FHQc3mTRcoraIZk3xB4epIIpLW6pQgaQItGu2SElmY",
    "err_code": "999999",
    "err_msg": "This order is a test order",
    "account_no": "9051400000011797",
    "acc_name": "Neeraj Kapoor",
    "province": "ICIC0000087",
    "order_amount": "10.00",
    "acc_no": "008701535655",
    "notifyUrl": "https://wb.babyforever.top/api/pay/notify",
    "ccy_no": "INR",
    "mer_order_no": "5551719303386444",
    "email": "test@gmail.com",
    "status": "SUCCESS"
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

# 代付订单查询

简要描述：

商户业务系统通过转账查询接口，查询转账付款订单，支付中心会返回订单最新的数据。

请求URL：

https://settle.lucky-winpay.com/withdraw/singleQuery (opens new window)

请求方式：

Post

Header：

参数名称	是否必填	类型	参考值	描述
Content-Type	是	String	application/json	HTTP请求内容类型，仅支持application/json。

请求参数说明

序号	参数名	参数名称	类型	是否必填	说明
1	mer_no	商户号	String	是	平台分配的唯一商户编号
2	mer_order_no	商户订单号	String	是	商户订单号需要唯一,不能重复
3	order_no	平台订单号	String	否	平台订单号
4	request_no	请求流水号	String	是	每次请求流水号唯一,不可重复
5	request_time	请求时间戳	String	是	时间戳:24小时制,每次请求需要当前时间：yyyyMMddHHmmss
6	sign	数字签名	String	是	详见：数字签名规范

请求参数示例

{
  "order_no": "2104060000001717561144728475",
  "mer_no": "xxx",
  "request_time": "20210406145308",
  "request_no": "1617695588427",
  "sign": "xxx",
  "mer_order_no": "1617695248072"
}

1
2
3
4
5
6
7
8

返回错误说明

序号	参数名	参数名称	类型	说明
1	query_status	查询状态	String	SUCCESS 成功,FAIL 失败；只表示代表查询状态，不表示业务状态
2	query_err_code	查询错误码	String	错误描述信息
3	query_err_msg	查询错误信息	String	错误描述

query_status等于SUCCESS以下数据才返回

序号	参数名	参数名称	类型	说明
1	mer_no	商户号	String	原样返回
2	mer_order_no	商户订单号	String	原样返回
3	request_no	请求流水号	String	原样返回
4	request_time	请求时间戳	String	原样返回
5	order_no	平台订单号	String	原样返回
6	utr	utr	String	平台订单utr
7	acc_no	收款账号	String	原样返回
8	acc_name	收款户名	String	原样返回
9	email	邮箱	String	邮箱
10	ccy_no	币种	String	原样返回
11	order_amount	金额	String	原样返回
12	fee	手续费	String	手续费
13	status	订单状态	String	SUCCESS:成功 FAIL:失败 UNKNOW:处理中
14	err_code	数字签名	String	订单错误码
15	err_msg	错误信息	String	订单错误描述

请求成功返回参数示例

{
  "order_no": "202104060000001719561153501557",
  "mer_no": "xxx",
  "request_no": "1617698213425",
  "query_status": "SUCCESS",
  "fee": "10.50",
  "sign": "842628d8c151e26f439023eba701394c",
  "acc_name": "Zhang San",
  "request_time": "20210406153653",
  "err_msg": "",
  "order_amount": "10.00",
  "acc_no": "15846325",
  "ccy_no": "VND",
  "mer_order_no": "1617698100961",
  "query_err_code": "000002",
  "query_err_msg": "Business verification success",
  "status": "UNKNOW"
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

# 代付余额查询

简要描述：

查询商户账户余额。

请求URL：

https://settle.lucky-winpay.com/withdraw/balanceQuery (opens new window)

请求方式：

Post

Header：

参数名称	是否必填	类型	参考值	描述
Content-Type	是	String	application/json	HTTP请求内容类型，仅支持application/json。

请求参数说明

序号	参数名	参数名称	类型	是否必填	说明
1	request_no	请求流水号	String	是	请求流水号必须唯一，每次需不同
2	request_time	请求时间戳	String	是	时间戳格式:( yyyyMMddHHmmss)，采用东七区时间戳
3	mer_no	商户号	String	是	平台分配的唯一商户号
4	sign	数字签名	String	是	详见：数字签名规范

请求参数示例

{
  "mer_no": "xxx",
  "request_time": "20210406153905",
  "request_no": "1617698345334",
  "sign": "xxx"
}

1
2
3
4
5
6

返回错误说明

序号	参数名	参数名称	类型	说明
1	query_status	查询状态	String	SUCCESS 成功,FAIL 失败；只表示代表查询状态，不表示业务状态
2	query_err_code	查询错误码	String	查询错误码
3	query_err_msg	查询错误信息	String	查询错误描述

query_status等于SUCCESS以下数据才返回

序号	参数名	参数名称	类型	说明
1	request_no	请求流水号	String	原样返回
2	request_time	请求时间戳	String	原样返回
3	mer_no	商户号	String	原样返回
4	list{account_no}	子账号	String	list，多笔
5	list{ccy_no}	币种	String	list，多笔
6	list{balance}	可用余额	String	list，多笔
7	list{frozen_balance}	冻结余额	String	list，多笔;整数
8	list{sign}	数字签名	String	详见：数字签名规范

请求成功返回参数示例

{
  "mer_no": "xxx",
  "request_time": "20210406153905",
  "request_no": "1617698345334",
  "query_status": "SUCCESS",
  "list": [
    {
      "account_no": "9110200000028799",
      "ccy_no": "IDR",
      "balance": "22535331.25",
      "frozen_balance": "0.00",
      "sign": "xxx"
    },
    {
      "account_no": "9110200000028743",
      "ccy_no": "INR",
      "balance": "9867.22",
      "frozen_balance": "0.00",
      "sign": "e47652c689c8cab2162635ff70166606"
    },
    {
      "account_no": "9021600000518997",
      "ccy_no": "NGN",
      "balance": "60633.86",
      "frozen_balance": "0.00",
      "sign": "f36807a3fd65a2ea6fe0ae7e25eabba3"
    },
    {
      "account_no": "9111700000054909",
      "ccy_no": "THB",
      "balance": "35206.94",
      "frozen_balance": "0.00",
      "sign": "3357463f515b3767370a903305823cc1"
    },
    {
      "account_no": "9111700000058884909",
      "ccy_no": "USDTERC",
      "balance": "1379.00",
      "frozen_balance": "0.00",
      "sign": "d86fa4207f884823a3e9b8e2bc0681ab"
    },
    {
      "account_no": "9111000000036280",
      "ccy_no": "VND",
      "balance": "10101.49",
      "frozen_balance": "0.00",
      "sign": "0d15f761d263c1a07063551e9ca0d7ad"
    }
  ],
  "query_err_code": "000002",
  "query_err_msg": "余额查询 success"
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52

# 平台通知

# 支付通知

简要描述：

当支付订单客户支付成功时，支付中心会向商户业务系统发起回调通知。
如果商户系统没有正确返回，支付网关会延迟再次通知。
商户接收到回调信息处理业务代码成功，需要返回 SUCCESS,否则平台会已10分钟发送3次通知,60分钟5次通知,24小时内10次通知,商户需要正确处理多次通知,防止资金重复处理。
注所有回调参数除sign之外,其余不为空参数都需要带入签名

请求URL：

回调notifyUrl参数

请求方式：

Post

Header：

参数名称	是否必填	类型	参考值	描述
Content-Type	是	String	application/x-www-form-urlencoded	HTTP请求内容类型

参数说明

序号	参数名	参数名称	类型	是否返回	说明
1	busi_code	支付类型	String	是	支付类型编码
2	err_code	错误码	String	否	错误码
3	err_msg	错误信息	String	否	错误描述
4	mer_no	商户号	String	是	商户编号
5	mer_order_no	商户订单号	String	是	商户唯一订单号
6	order_amount	订单金额	String	是	保留二位小数
7	order_no	平台订单号	String	是	平台唯一订单号
8	order_time	订单时间	String	是	格式 (yyyy-MM-dd HH:mm:ss)
9	pay_amount	支付金额	String	是	保留两位小数
10	utr	支付utr	String	否	支付成功时返回
11	pay_time	支付时间	String	是	格式 (yyyy-MM-dd HH:mm:ss)
12	status	订单状态	String	是	SUCCESS：成功 FAIL:失败
13	sign	数字签名	String	是	详见：数字签名规范

# 转账通知

简要描述：

当转账订单上游付款成功时，支付中心会向商户业务系统发起回调通知。
如果商户系统没有正确返回，支付网关会延迟再次通知。
商户接收到回调信息处理业务代码成功，需要返回 SUCCESS,否则平台会已10分钟发送3次通知,60分钟5次通知,24小时内10次通知,商户需要正确处理多次通知,防止资金重复处理。
注所有回调参数除sign之外,其余不为空参数都需要带入签名

请求URL：

回调notifyUrl参数

请求方式：

Post

Header：

参数名称	是否必填	类型	参考值	描述
Content-Type	是	String	application/x-www-form-urlencoded	HTTP请求内容类型

参数说明

序号	参数名	参数名称	类型	是否返回	说明
1	err_code	错误码	String	否	错误码
2	err_msg	错误信息	String	否	错误描述
3	mer_no	商户号	String	是	商户编号
4	mer_order_no	商户订单号	String	是	商户订单号
5	order_amount	订单金额	String	是	保留二位小数
6	ccy_no	币种	String	是	币种
7	order_no	平台订单号	String	是	平台订单号
8	utr	支付utr	String	否	转账成功时返回
9	create_time	订单创建时间	String	是	格式 (yyyy-MM-dd HH:mm:ss)
10	pay_time	订单支付时间	String	否	格式 (yyyy-MM-dd HH:mm:ss)
11	status	订单状态	String	是	SUCCESS:成功 FAIL:失败 UNKNOW:处理中
12	sign	数字签名	String	是	详见：数字签名规范

# 币种编码

币种编码（大写）

序号	编码	名称
1	INR	印度卢比

感谢您的阅读！

# luckWinPay接口文档

# 本站内容介绍

# 数字签名规范

# 商户测试账号基本信息

# RSA公钥生成步骤规则参考

# Md5加密格式案例(案例只做参考)

# RSA加密格式案例(案例只做参考)

# 加密算法工具类

# 支付类型编码

# 支付业务

# 支付下单

Post

# 支付查询

Post

# 支付补单

Post

# 查询utr

Post

# 查询upi

Post

# 代付业务

# 单笔代付

Post

# 代付订单查询

Post

# 代付余额查询

Post

# 平台通知

# 支付通知

Post

# 转账通知

Post

# 币种编码