线下支付

动态二维码

在线测试 在线浏览

请求方式:GET

请求地址:http://zhaoyin.lfwin.com/payapi/trans/qrcode

Query参数名 类型 必需 描述 示例 e.g.
apikey string 商家APIKEY,唯一标识,由服务商提供
txn string 时间戳,单位秒,动态变化时间 ,建议每隔5分钟变化一次时间戳
sign string 签名,参照签名算法
money string 支付金额,单位元,最小值0.01,表示0.01元,0表示不带支付金额

详细说明:

测试环境
apikey        :  00014005
signkey   :   punr8ucu

脱机动态二维码内容生成规则(测试环境)
http://zhaoyin.lfwin.com/payapi/trans/qrcode?apikey=00014005&money=0&txn=1234567890&sign=e625c726af2178754627050ac6830271   (不带支付金额)

http://zhaoyin.lfwin.com/payapi/trans/qrcode?apikey=00014005&money=0.01&txn=1234567890&sign=58c93bc33a1ab39c4cd27efc8bf878da (带支付金额)

sign(签名规则) ,参照签名算法
所有参数按照字段名的ascii码从小到大排序后使用QueryString的格式(即key1=value1&key2=value2…)拼接而成,key值为sign不参与签名组串
apikey=00014005&money=0&txn=1234567890

MD5签名计算公式:

sign=Md5(原字符串&signkey=商户密钥).toLowerCase


sign=md5(apikey=00014005&money=0&txn=1234567890&signkey=punr8ucu);

结果:

sign=e625c726af2178754627050ac6830271

最后得到二维码内容 :http://zhaoyin.lfwin.com/payapi/trans/qrcode?apikey=00014005&money=0&txn=1234567890&sign=e625c726af2178754627050ac6830271

将该二维码内容生成二维码,供用户扫码支付。


返回示例:

                                不带支付金额:
http://zhaoyin.lfwin.com/payapi/trans/qrcode?apikey=00014005&money=0&txn=1234567890&sign=e625c726af2178754627050ac6830271
带支付金额:
http://zhaoyin.lfwin.com/payapi/trans/qrcode?apikey=00014005&money=0.01&txn=1234567890&sign=58c93bc33a1ab39c4cd27efc8bf878da
                            

账单下载

在线测试 在线浏览

请求方式:POST

请求地址:http://zhaoyin.lfwin.com/payapi/pay/downbill?test=1

Body参数名 类型 必需 描述 示例 e.g.
service string 接口名称 pay.wxpay.bill
apikey string 商家APIKEY,唯一标识,由服务商提供 00014005
nonce_str string 随机字符串,长度不超过32位 123456
sign string 签名,参照签名算法 22a57619806c41b86409a502d73c3631
bill_date string 下载对账单的日期,格式:20180420表示2018年4月20号 20180420

详细说明:

建议商户10点后再获取隔天账单:
官方支付宝账单 返回实例:  
pay.alipay.bill 是一个下载支付宝账单链接,有一定的时效性。注意 只返回支付成功的订单(退款会另外一行)
{
    "bill": "http://dwbillcenter.alipay.com/downloadBillFile.resource?bizType=trade&userId=20888117706448930156&fileType=csv.zip&bizDates=20180419&downloadFileName=20888117706448930156_20180419.csv.zip&fileId=%2Ftrade%2F20888117706448930156%2F20180419.csv.zip&timestamp=1524484696&token=e9811aa84e1c836e578a9a234e246a57",
    "service": "",
    "version": "3.0",
    "charset": "UTF-8",
    "message": "SUCCESS",
    "status": "10000",
    "sign_type": "MD5",
    "sign": "4fff7294059954394bb88c99bfe8ab27"
}

官方微信账单 返回实例:  
pay.wxpay.bill 是 微信账单内容注意 只返回支付成功的订单(退款会另外一行)
数据以文本表格的方式返回,第一行为表头,后面各行为对应的字段内容,字段内容跟查询订单或退款结果一致

第一行为表头

从第二行起,为数据记录,各参数以逗号分隔,参数前增加`符号,为标准键盘1左边键的字符,字段顺序与表头一致。

倒数第二行为订单统计标题,最后一行为统计数据

总交易单数,总交易额,总退款金额,总代金券或立减优惠退款金额,手续费总金额 

{
    "bill": "交易时间,公众账号ID,商户号,特约商户号,设备号,微信订单号,商户订单号,用户标识,交易类型,交易状态,付款银行,货币种类,应结订单金额,代金券金额,微信退款单号,商户退款单号,退款金额,充值券退款金额,退款类型,退款状态,商品名称,商户数据包,手续费,费率,订单金额,申请退款金额,费率备注\r\n`2018-07-20 08:03:44,`wx0fe958a999250740,`1241316302,`1341407901,`,`4200000139201807201874243789,`201807200803420070062114,`oJp8Fj2VMIrhVW-rR7FzKeHcLQik,`MICROPAY,`SUCCESS,`SPDB_DEBIT,`CNY,`0.01,`0.00,`0,`0,`0.00,`0.00,`,`,`微赢家灵风分店消费,`,`0.00000,`0.60%,`0.01,`0.00,`\r\n`2018-07-20 08:06:42,`wx0fe958a999250740,`1241316302,`1341407901,`,`4200000139201807201874243789,`201807200803420070062114,`oJp8Fj2VMIrhVW-rR7FzKeHcLQik,`MICROPAY,`REFUND,`SPDB_DEBIT,`CNY,`0.00,`0.00,`50000507622018072005466889439,`201807200803420070062114rf932840,`0.01,`0.00,`ORIGINAL,`PROCESSING,`微赢家灵风分店消费,`,`0.00000,`0.60%,`0.00,`0.01,`\r\n`2018-07-20 ,
    "service": "pay.wxpay.bill",
    "version": "3.0",
    "charset": "UTF-8",
    "message": "SUCCESS",
    "status": "10000",
    "sign_type": "MD5",
    "sign": "6d94566521224f672c087418036b7e26"
}

网商微信支付宝账单,返回实例
注意 只返回支付成功的订单(退款会另外一行)
{
    "bill": "商户号,银行订单号,合作机构订单号,交易类型,货币种类,交易金额,手续费费率,手续费,清算金额,原银行订单号(退款或撤销时出现),订单完成时间,备注,分账类型,支付渠道,ISV费用,\r\n,226801000001912532501,2018070210152010070001500075224243,20180702141855007008448,支付交易,CNY,0.02,0.0035,0.00,0.02,,20180702 14:19:04,,T1,ALI,0.00,\r\n,226801000001912532501,2018070210152010070001500075076338,20180702102830007001551,支付交易,CNY,0.01,0.0035,0.00,0.01,,20180702 10:28:36,,T1,ALI,0.00,\r\n,226801000001912532501,2018070210152010070001500075057187,20180702101820007005604,支付交易,CNY,0.01,0.0035,0.00,0.01,,20180702 10:18:28,,T1,ALI,0.00,\r\n,226801000001912532501,3,0.04,0,0.00,0.00,T1",
    "service": "",
    "version": "3.0",
    "charset": "UTF-8",
    "message": "SUCCESS",
    "status": "10000",
    "sign_type": "MD5",
    "sign": "9fb455b9d5529c62288cedfcb942cc60"
}

富友微信支付宝账单,返回实例
注意 只返回交易状态1 交易状态说明=SUCCESS,既支付成功的订单(退款会另外一行)
TIPS:交易类型  TX02-银行卡收单  TX09-微信支付  TX15-支付宝支付  TX25-京东钱包支付  TX26-QQ钱包支付  TX18是退款
{
    "bill": "商户号|卡号|卡属性|参考号|交易类型|终端号|商户订单号|渠道订单号|交易金额|交易状态(1、0)|交易状态说明|交易完成时间|清算日期|退款单号|交易手续费|OPENID,\r\n,0005810F0438877||01|910517589620|TX09||201807041044470070089385|4200000137201807044217271408|0.01|1|SUCCESS|2018-07-04 10:45:04|20180704||0.00|c63GL8D8nlEL0UO5vE",
    "service": "",
    "version": "3.0",
    "charset": "UTF-8",
    "message": "SUCCESS",
    "status": "10000",
    "sign_type": "MD5",
    "sign": "0af5fa835522deb8fbefc01da1e550ef"
}

间联1微信支付宝账单,返回实例
注意 只返回支付成功的订单(退款会另外一行)
{
    "bill": "商户号,订单类型,商户订单号,平台流水,交易时间,交易类型,交易状态,货币种类,交易金额,交易手续费,批次号,商户退款单号,平台退款流水,退款金额,退款状态,退款时间,附加数据,\r\n,'E1800305780,'支付,'201807201111490070059798,'316815162,'2018-07-20 11:11:51,'支付宝刷卡,'成功,'CNY,'0.02,'0.01,',',',',',',',\r\n,'E1800305780,'支付,'201807201128040070040611,'316842589,'2018-07-20 11:28:22,'支付宝扫码,'成功,'CNY,'0.02,'0.01,',',',',',','",
    "service": "heli.wxpay.bill",
    "version": "3.0",
    "charset": "UTF-8",
    "message": "SUCCESS",
    "status": "10000",
    "sign_type": "MD5",
    "sign": "1f270c5582e354ac8f5d723488a8617b"
}


乐刷微信支付宝账单,返回实例
注意 只返回支付成功的订单(退款会另外一行)
{
    "bill": "BT:编号,交易时间,订单号,商户号,费率(万分之一),交易金额(分),手续费(分),结算金额(分),资金流向,交易类型,支付方式,卡类型,商户优惠类型,参考号,凭证号,终端号,第三方订单号,第三方退款号,支付时间,上游订单号(网、银联),上游订单号(微信、支付宝),付款银行,消费者标识,扫码支付交易类型,\r\n,BV:0,2018-09-05 17:01:57,1809051701539580,1800108235,60,1,0.0,1.0,进账,消费,支付宝支付,未知,标准类,,*,*,20180905170157,,2018-09-05 17:01:57,9961536138116952670358640,2018090522001487381001546868,PCREDIT,,MICROPAY,\r\n,BV:1,2018-09-05 17:03:11,1809051702525273,1800108235,60,1,0.0,1.0,进账,消费,支付宝支付,未知,标准类,,*,*,20180905170255,,2018-09-05 17:03:11,9381536138174798211719663,2018090522001487381001627601,PCREDIT,,NATIVE,\r\n,BV:2,2018-09-05 16:25:09,1809051624321550,1800108235,60,1,0.0,1.0,进账,消费,微信支付,未知,标准类,,*,*,20180905162435,,2018-09-05 16:25:09,4200000174201809050620481357,4200000174201809050620481357,CFT,,NATIVE,\r\n,BV:3,2018-09-05 16:28:51,1809051628471611,1800108235,60,1,0.0,1.0,进账,消费,微信支付,未知,标准类,,*,*,20180905162843,,2018-09-05 16:28:51,4200000179201809051497591108,4200000179201809051497591108,CFT,o3gd1jqWBBJBBxMbk_csc9IxYqTI,MICROPAY,\r\n,BV:4,2018-09-05 15:47:09,1809051539327666,1800108235,60,1,0.0,1.0,进账,消费,支付宝支付,未知,标准类,,*,*,20180905153931,,2018-09-05 15:47:09,9961536133170899714148113,2018090522001487381001458222,PCREDIT,,NATIVE,\r\n,BV:5,2018-09-05 16:00:01,1809051559230613,1800108235,60,1,0.0,1.0,进账,消费,支付宝支付,未知,标准类,,*,*,20180905155923,,2018-09-05 16:00:01,9391536134362898173519589,2018090522001487381001639322,PCREDIT,,NATIVE",
    "service": "lspay.wxpay.bill",
    "version": "3.0",
    "charset": "UTF-8",
    "message": "SUCCESS",
    "status": "10000",
    "sign_type": "MD5",
    "sign": "195bd2958afc15499c60e6f83ed2137a"
}

返回示例:

                                {
    "bill": "交易时间,公众账号ID,商户号,特约商户号,设备号,微信订单号,商户订单号,用户标识,交易类型,交易状态,付款银行,货币种类,应结订单金额,代金券金额,商品名称,商户数据包,手续费,费率,订单金额,费率备注\r\n`2018-04-19 17:35:03,`wx9e3f16c45c100b5d,`1241316302,`1242092202,`,`4200000051201804191766814095,`201804191734570070061727,`oFowzs0k5PhcBnaEZCfVU0pFPm30,`MICROPAY,`SUCCESS,`ICBC_DEBIT,`CNY,`0.01,`0.00,`微赢家灵风分店消费,`,`0.00000,`0.60%,`0.01,`\r\n`2018-04-19 14:41:14,`wx9e3f16c45c100b5d,`1241316302,`1242092202,`,`4200000055201804191749686756,`201804191441090070069475,`oFowzs0k5PhcBnaEZCfVU0pFPm30,`MICROPAY,`SUCCESS,`ICBC_DEBIT,`CNY,`0.01,`0.00,`微赢家灵风分店消费,`,`0.00000,`0.60%,`0.01,`\r\n`2018-04-19 17:40:47,`wx9e3f16c45c100b5d,`1241316302,`1242092202,`,`4200000057201804191764549017,`201804191740400070024579,`oFowzs0k5PhcBnaEZCfVU0pFPm30,`MICROPAY,`SUCCESS,`ICBC_DEBIT,`CNY,`0.01,`0.00,`微赢家灵风分店消费,`,`0.00000,`0.60%,`0.01,`\r\n`2018-04-19 18:28:17,`wx9e3f16c45c100b5d,`1241316302,`1242092202,`,`4200000059201804191683222134,`201804191828100070023520,`oFowzs0k5PhcBnaEZCfVU0pFPm30,`MICROPAY,`SUCCESS,`ICBC_DEBIT,`CNY,`0.01,`0.00,`微赢家灵风分店消费,`,`0.00000,`0.60%,`0.01,`\r\n`2018-04-19 17:54:13,`wx9e3f16c45c100b5d,`1241316302,`1242092202,`,`4200000060201804191487196734,`201804191754050070029503,`oFowzs0k5PhcBnaEZCfVU0pFPm30,`MICROPAY,`SUCCESS,`ICBC_DEBIT,`CNY,`0.01,`0.00,`微赢家灵风分店消费,`,`0.00000,`0.60%,`0.01,`\r\n`2018-04-19 17:32:24,`wx9e3f16c45c100b5d,`1241316302,`1242092202,`,`4200000062201804191840942570,`201804191732150070039843,`oFowzs0k5PhcBnaEZCfVU0pFPm30,`MICROPAY,`SUCCESS,`ICBC_DEBIT,`CNY,`0.01,`0.00,`微赢家灵风分店消费,`,`0.00000,`0.60%,`0.01,`\r\n`2018-04-19 12:15:45,`wx9e3f16c45c100b5d,`1241316302,`1242092202,`,`4200000063201804191685068880,`201804191215400070091171,`oFowzs0k5PhcBnaEZCfVU0pFPm30,`MICROPAY,`SUCCESS,`ICBC_DEBIT,`CNY,`0.01,`0.00,`微赢家灵风分店消费,`,`0.00000,`0.60%,`0.01,`\r\n`2018-04-19 11:49:20,`wx9e3f16c45c100b5d,`1241316302,`1242092202,`,`4200000070201804191483421322,`201804191149190070019590,`oFowzs0k5PhcBnaEZCfVU0pFPm30,`MICROPAY,`SUCCESS,`ICBC_DEBIT,`CNY,`0.01,`0.00,`微赢家灵风分店消费,`,`0.00000,`0.60%,`0.01,`\r\n`2018-04-19 12:13:09,`wx9e3f16c45c100b5d,`1241316302,`1242092202,`,`4200000070201804191562036664,`201804191213030070053641,`oFowzs0k5PhcBnaEZCfVU0pFPm30,`MICROPAY,`SUCCESS,`ICBC_DEBIT,`CNY,`0.01,`0.00,`微赢家灵风分店消费,`,`0.00000,`0.60%,`0.01,`\r\n`2018-04-19 17:26:41,`wx9e3f16c45c100b5d,`1241316302,`1242092202,`,`4200000074201804191898165784,`201804191726250070043489,`oFowzs0k5PhcBnaEZCfVU0pFPm30,`MICROPAY,`SUCCESS,`ICBC_DEBIT,`CNY,`0.01,`0.00,`微赢家灵风分店消费,`,`0.00000,`0.60%,`0.01,`\r\n`2018-04-19 14:35:35,`wx9e3f16c45c100b5d,`1241316302,`1242092202,`,`4200000076201804191517885044,`201804191435300070099613,`oFowzs0k5PhcBnaEZCfVU0pFPm30,`MICROPAY,`SUCCESS,`ICBC_DEBIT,`CNY,`0.01,`0.00,`微赢家灵风分店消费,`,`0.00000,`0.60%,`0.01,`\r\n`2018-04-19 17:52:12,`wx9e3f16c45c100b5d,`1241316302,`1242092202,`,`4200000076201804191847119140,`201804191752050070051064,`oFowzs0k5PhcBnaEZCfVU0pFPm30,`MICROPAY,`SUCCESS,`ICBC_DEBIT,`CNY,`0.01,`0.00,`微赢家灵风分店消费,`,`0.00000,`0.60%,`0.01,`\r\n`2018-04-19 18:06:02,`wx9e3f16c45c100b5d,`1241316302,`1242092202,`,`4200000077201804191541549271,`201804191805540070057784,`oFowzs0k5PhcBnaEZCfVU0pFPm30,`MICROPAY,`SUCCESS,`ICBC_DEBIT,`CNY,`0.01,`0.00,`微赢家灵风分店消费,`,`0.00000,`0.60%,`0.01,`\r\n`2018-04-19 12:06:51,`wx9e3f16c45c100b5d,`1241316302,`1242092202,`,`4200000077201804191542634849,`201804191206500070065816,`oFowzs0k5PhcBnaEZCfVU0pFPm30,`MICROPAY,`SUCCESS,`ICBC_DEBIT,`CNY,`0.01,`0.00,`微赢家灵风分店消费,`,`0.00000,`0.60%,`0.01,`\r\n`2018-04-19 17:23:30,`wx9e3f16c45c100b5d,`1241316302,`1242092202,`,`4200000079201804191557532680,`201804191723070070059291,`oFowzs0k5PhcBnaEZCfVU0pFPm30,`MICROPAY,`SUCCESS,`ICBC_DEBIT,`CNY,`0.01,`0.00,`微赢家灵风分店消费,`,`0.00000,`0.60%,`0.01,`\r\n总交易单数,应结订单总金额,退款总金额,充值券退款总金额,手续费总金额,订单总金额,申请退款总金额\r\n`15,`0.15,`0.00,`0.00,`0.00000,`0.15,`0.00\r\n",
    "version": "3.0",
    "charset": "UTF-8",
    "message": "SUCCESS",
    "status": "10000",
    "sign_type": "MD5",
    "service": "pay.wxpay.bill",
    "sign": "03d0ecf9f9b20ac7c6a43649ecb7eb34"
}
                            
参数名 描述 类型
bill 支付账单 string
version 接口版本号,3.0 number
charset 接口字符编码,UTF-8 string
message 错误信息 string
status 错误状态 number
sign_type 签名方式,MD5 string
sign 签名字符串,参照签名方法 string
service 接口名称 string

订单列表

在线测试 在线浏览

请求方式:POST

请求地址:http://zhaoyin.lfwin.com/payapi/pay/order_list?test=1

Body参数名 类型 必需 描述 示例 e.g.
service string 接口名称 order.list
apikey string 商家APIKEY,唯一标识,由服务商提供 00014005
nonce_str string 随机字符串,长度不超过32位 123456
sign string 签名,参照签名算法 09b926011f6316b3614cf53dd76f51ec
orderid string 系统订单号,唯一值
order_time_s string 下单开始时间,时间戳,精确到秒
order_time_e string 下单结束时间,时间戳,精确到秒
page_no string 第几页,默认第1页
page_size string 每页条数,默认20条,最大200条
mch_orderid string 商户订单号,如果orderid跟mch_orderid同时存在,以orderid为准
order_time string 下单时间,时间戳,精确到秒,如果只传商户订单号,必须传下单时间
paytype string 支付方式:1条码 2扫码 2
bank_type string 支付通道: 0官方; 3富友; 4网商; 5间联1; 6乐刷;
m_paytype string 支付类型 : alipay 支付宝 ; wxpay 微信 ; unpay 银联云闪付 ; bdpay 百度;best 天翼支付
is_refund string 标识:2退款 1撤销 0普通订单
fix_qrcode string 是否固定二维码收款订单(包括H5支付): 0 否 ,1是
paystatus string 支付状态: 1支付成功, 2支付失败, 0待支付

详细说明:

订单列表验签附加说明:
返回lists是数组格式,验签的时候数组json格式化成json字符串,参与签名
例如:
代签名字符串=
charset=UTF-8&current_no=1&lists=[{"orderid":"20171219163537000143109","trade_no":"","paymoney":"0.01","pri_paymoney":"0.01","receipt_amount":"0.00","buyer_pay_amount":"0.00","coupon_fee":"0.00","paytime":"0","paystatus":"0","order_time":"1513672537","mch_orderid":"","paytype":"1","bank_type":"0","m_paytype":"alipay","is_refund":"0"},{"orderid":"20171219163742000149502","trade_no":"","paymoney":"0.01","pri_paymoney":"0.01","receipt_amount":"0.00","buyer_pay_amount":"0.00","coupon_fee":"0.00","paytime":"0","paystatus":"0","order_time":"1513672662","mch_orderid":"","paytype":"1","bank_type":"0","m_paytype":"alipay","is_refund":"0"}]&message=SUCCESS&page_size=2&sign_type=MD5&status=10000&total_items=558&total_no=279&version=3.0&signkey=punr8ucu




支付交易渠道( json字符串) 说明: 
支付宝:
例如:[{"amount":"9.98","fund_channel":"MDISCOUNT"},{"amount":"0.02","fund_channel":"ALIPAYACCOUNT"}]

amont:金额,单位
fund_channel 交易渠道:
COUPON :               支付宝红包
ALIPAYACCOUNT:  支付宝账户
POINT:                        集分宝
DISCOUNT:                折扣券
PCARD:                       预付卡
MCARD:                     商家储值卡
MDISCOUNT:            商户优惠券
MCOUPON:               商户红包
PCREDIT:                   蚂蚁花呗

微信
例如:{"promotion_detail":[{"promotion_id":"2683768328","name":"单品15号测试优惠","scope":"SINGLE","type":"DISCOUNT","amount":1,"activity_id":"4218002","wxpay_contribute":0,"merchant_contribute":1,"other_contribute":0,"goods_detail":[{"goods_id":"6923450656181","quantity":1,"price":2,"discount_amount":1}]}]}
promotion_detail:营销详情
promotion_id:券ID
name:优惠名称
scope:优惠范围
amount:优惠面额,单位
activity_id:活动ID
wxpay_contribute:微信出资,单位
merchant_contribute:商户出资,单位
other_contribute:其他出资,单位
goods_detail:单品列表
goods_id:商品编码
goods_remark:商品备注
discount_amount:商品优惠金额,单位
quantity:商品数量
price:商品价格,单位



返回示例:

                                {
    "total_items": "1610",
    "page_size": "2",
    "current_no": "1",
    "total_no": "805",
    "lists": [
        {
            "orderid": "201806141806100070086269",
            "trade_no": "",
            "paymoney": "0.03",
            "pri_paymoney": "0.03",
            "receipt_amount": "0.03",
            "buyer_pay_amount": "0.03",
            "coupon_fee": "0.00",
            "paytime": "0",
            "company": "汕头市微赢家信息科技有限公司",
            "nickname": "微赢家",
            "shopname": "微赢家灵风分店",
            "buyer_account": "",
            "mid": "0",
            "remarks": "",
            "cdid": "700",
            "paystatus": "0",
            "order_time": "1528970770",
            "mch_orderid": "SH180614180000001312",
            "paytype": "2",
            "bank_type": "0",
            "m_paytype": "wxpay",
            "is_refund": "0",
            "fund_bill_list": "",
            "fix_qrcode": "0"
        },
        {
            "orderid": "201806141806030070046689",
            "trade_no": "",
            "paymoney": "0.03",
            "pri_paymoney": "0.03",
            "receipt_amount": "0.03",
            "buyer_pay_amount": "0.03",
            "coupon_fee": "0.00",
            "paytime": "0",
            "company": "汕头市微赢家信息科技有限公司",
            "nickname": "微赢家",
            "shopname": "微赢家灵风分店",
            "buyer_account": "",
            "mid": "0",
            "remarks": "",
            "cdid": "700",
            "paystatus": "0",
            "order_time": "1528970763",
            "mch_orderid": "SH180614180000001311",
            "paytype": "2",
            "bank_type": "0",
            "m_paytype": "wxpay",
            "is_refund": "0",
            "fund_bill_list": "",
            "fix_qrcode": "0"
        }
    ],
    "version": "3.0",
    "charset": "UTF-8",
    "message": "SUCCESS",
    "status": "10000",
    "sign_type": "MD5",
    "sign": "0764e9d17495423bf34b7e71d10a9605"
}
                            
参数名 描述 类型
total_items 总记录数 number
page_size 每页记录数 number
current_no 当前页码 number
total_no 总页码数目 number
lists 记录列表,array()数组类型,对应key参数如下 array
lists.orderid 系统订单号 number
lists.trade_no 通道流水号 string
lists.paymoney 下单支付金额,单位元 number
lists.pri_paymoney 商家优惠活动后,实际支付金额,单位元 number
lists.receipt_amount 商家实收金额,单位元 number
lists.buyer_pay_amount 买家付款金额,单位元 number
lists.coupon_fee 代金券金额,单位元 number
lists.paytime 支付时间 number
list.shopname 门店名称 string
lists.paystatus 支付状态 1支付成功 2支付失败 0待支付 number
lists.order_time 下单时间 number
lists.mch_orderid 商户订单号 string
lists.paytype 支付方式:1条码 2扫码 string
lists.bank_type 支付通道: 0官方 ; 3富友; 4网商 ;5间联1; 6乐刷 string
lists.m_paytype 支付类型 : alipay 支付宝 ; wxpay 微信 ; unpay 银联云闪付 ; bdpay 百度; best 天翼支付 string
lists.is_refund 标识:2退款 1撤销 0普通订单 string
lists.fund_bill_list 交易支付使用的资金渠道 string
lists.fix_qrcode 是否固定二维码收款订单(包括H5支付): 0 否 ,1是 string
version 接口版本号,3.0 number
charset 接口字符编码,UTF-8 string
message 错误信息 string
status 错误状态 number
sign_type 签名方式,MD5 string
sign 签名字符串,参照签名方法 string
lists.buyer_account 支付账号 string
lists.mid 收款店员ID string
lists.remarks 订单备注 string
lists.cdid 设备ID string
lists.company 商家名称 string
lists.nickname 商家昵称 string
lists.storediscount 商家店铺优惠活动金额,单位元 string
lists.refundmoney 累计退款总金额,单位元 string
lists.service 该订单的支付service string

条码支付

在线测试 在线浏览

请求方式:POST

请求地址:http://zhaoyin.lfwin.com/payapi/pay/barcode

Body参数名 类型 必需 描述 示例 e.g.
service string 接口名称 pay.alipay.barcode
apikey string 商家APIKEY,唯一标识,由服务商提供 00014005
money string 支付金额,单位元,最小值0.01,表示0.01元 0.01
dynamic_id string 支付条形码 286103991909766417
nonce_str string 随机字符串,长度不超过32位 123456
sign string 签名,参照签名算法
fq_num string 花呗分期数,包括3/6/12期的,还款期数越长手续费越高,可选
seller_percent string 花呗分期手续费承担方式,由用户全承担(该值为0),也可以商户全承担(该值为100),可选
mch_orderid string 商家系统外部订单号,必须保证每次下单唯一,如果下单失败请调用查询接口
goods_id string 商品国标码,多个单品逗号分隔,口碑或微信单品优惠所需,可选
goods_name string 商品名称,多个单品逗号分隔,口碑或微信单品优惠所需,可选
quantity string 商品数量,多个单品逗号分隔,口碑或微信单品优惠所需,可选
price string 商品单价,多个单品逗号分隔,口碑或微信单品优惠所需,可选
goods_tag string 微信官方订单优惠标记,代金券或立减优惠功能,如果设置该值,goods_tag内容与配置内容相同,且支付金额满足代金券使用条件才会触发代金券的使用。不设置则只要支付金额满足条件就会触发代金券的使用;
mid string 登录的收款店员id
remarks string 订单备注
guid string 设备唯一标识
store_dis string 平台店铺优惠活动是否打开 ,1打开 0关闭(默认)

详细说明:

微信用户刷卡条形码规则:18位纯数字,以10、11、12、13、14、15开头
支付宝用户刷卡条码规则:  25~30开头的长度为16~24位的数字,实际字符串长度以开发者获取的付款码长度为准
翼支付用户刷卡条形码规则:18位纯数字,以51开头
百度钱包用户刷卡条码规则:   不超过18位纯数字,以31开头
银联云闪付用户刷卡条码规则:  不超过19位纯数字, 以62开头
流程图:






关于支付通道说明:

微信跟支付宝 支付通道分为直连通道跟间联通道:
直连通道跟间联通道区别 在用户微信端支付流程体验都一样的,对于顾客无感知
商家结算的渠道不一样而已,具体可咨询业务方面细节。

直连通道列如:
pay.wxpay.barcode: 官方微信直连通道

间联通道列如:
fuiou.wxpay.barcode  富友微信通道,也就是间联2微信通道
mybank.wxpay.barcode   网商微信通道,也就是间联3微信通道
heli.wxpay.barcode   合利宝微信通道,也就是间联1微信通道
lspay.wxpay.barcode   乐刷微信通道,也就是间联4 微信通道
支付宝类似




返回示例:

                                {
    "service": "pay.alipay.barcode",
    "orderid": "201807121037060070071166",
    "trade_no": "2018071221001004380520962174",
    "paymoney": "1",
    "pri_paymoney": "1",
    "buyer_account": "you***@163.com",
    "receipt_amount": "1.00",
    "buyer_pay_amount": "1.00",
    "point_amount": "0.26",
    "paytime": "1531363027",
    "fund_bill_list": "[{\"amount\":\"0.26\",\"fund_channel\":\"COUPON\"},{\"amount\":\"0.74\",\"fund_channel\":\"ALIPAYACCOUNT\"}]",
    "paystatus": "1",
    "order_time": "1531363026",
    "mch_orderid": "",
    "storediscount": "0",
    "refundmoney": "0.00",
    "coupon_fee": "0.00",
    "version": "3.0",
    "charset": "UTF-8",
    "message": "SUCCESS",
    "status": "10000",
    "sign_type": "MD5",
    "sign": "e88f20a29e6c11b164d759f5a97be7e5"
}
                            
参数名 描述 类型
service 支付通道: pay.wxpay.barcode 微信官方条码; pay.alipay.barcode 支付宝官方条码; mybank.alipay.barcode 网商银行支付宝条码;mybank.wxpay.barcode 网商银行微信条码; string
orderid 系统订单号,唯一值 number
trade_no 通道流水号 number
paymoney 下单支付金额,单位元 number
pri_paymoney 商家优惠活动后,实际支付金额,单位元 number
receipt_amount 商家实收金额,单位元 number
buyer_pay_amount 买家付款金额,单位元 number
point_amount 使用集分宝付款的金额,单位元 number
coupon_fee 官方优惠金额,单位元 string
buyer_account 买家支付宝账号 string
paytime 支付成功时间。时间戳,单位秒 number
fund_bill_list 支付渠道 json字符串,fund_channel :交易使用的资金渠道,详见,支付渠道列表; amount :该支付工具类型所使用的金额;real_amount:渠道实际付款金额 string
paystatus 支付状态:1 支付成功 ,0待付款,2付款失败 number
order_time 下单时间。时间戳,单位秒 number
mch_orderid 商户外部订单号 string
version 接口版本号,3.0 number
charset 接口字符编码,UTF-8 string
message 错误信息 string
status 错误状态 number
sign_type 签名方式,MD5 string
sign 签名字符串,参照签名方法 string
storediscount 商家店铺优惠活动金额,单位元 string
refundmoney 累计退款总金额,单位元 string

扫码支付

在线测试 在线浏览

请求方式:POST

请求地址:http://zhaoyin.lfwin.com/payapi/pay/qrcode?test=1

Body参数名 类型 必需 描述 示例 e.g.
service string 接口名称 pay.wxpay.qrcode
apikey string 商家APIKEY,唯一标识,由服务商提供 00014005
money string 支付金额,单位元,最小值0.01,表示0.01元 0.01
nonce_str string 随机字符串,长度不超过32位 123456
sign string 签名,参照签名算法
fq_num string 花呗分期数,包括3/6/12期的,还款期数越长手续费越高,可选
seller_percent string 花呗分期手续费承担方式,由用户全承担(该值为0),也可以商户全承担(该值为100),可选
goods_id string 商品国标码,多个单品逗号分隔,口碑或微信单品优惠所需,可选
goods_name string 商品名称,多个单品逗号分隔,口碑或微信单品优惠所需,可选
quantity string 商品数量,多个单品逗号分隔,口碑或微信单品优惠所需,可选
price string 商品单价,多个单品逗号分隔,口碑或微信单品优惠所需,可选
mch_orderid string 商家系统外部订单号,必须保证每次下单唯一,如果下单失败请调用查询接口
notify_url string 异步通知地址,支付成功后服务器发起通知
mid string 登录的收款店员id
goods_tag string 微信官方订单优惠标记,代金券或立减优惠功能,如果设置该值,goods_tag内容与配置内容相同,且支付金额满足代金券使用条件才会触发代金券的使用。不设置则只要支付金额满足条件就会触发代金券的使用;
remarks string 订单备注
guid string 设备唯一标识
store_dis string 平台店铺优惠活动是否打开 ,1打开 0关闭(默认)

详细说明:

notify_url异步通知地址,支付成功后服务器发起通知 ,测试环境不发送通知。网商通道预计3月5日左右 上线异步通知
接收异步通知notify_url 页面在收到通知时候 返回success字符时候,服务器会停止通知,总计通知次数大约6次
POST 方式发送
{
  'orderid' :  '20180202171044007002473',
  'trade_no' :  '4200000061201802025681296197',
  'paystatus' :  '1',
  'paymoney' :  '0.01',
  'pri_paymoney' :  '0.01',
  'order_time' :  '1517562644',
  'paytime' :  '1517562682',
  'mch_orderid' :  '',
  'buyer_account' :  '微信账号',
  'notify_url':  'http://www.xxx.com',
  'sign' :  '0ee2e3d34573de75f973630403db24b6',
}
参数注释参照文档

流程图:



关于支付通道说明:

微信跟支付宝 支付通道分为直连通道跟间联通道:
直连通道跟间联通道区别 在用户微信端支付流程体验都一样的,对于顾客无感知
商家结算的渠道不一样而已,具体可咨询业务方面细节。

直连通道列如:
pay.wxpay.barcode: 官方微信直连通道

间联通道列如:
fuiou.wxpay.barcode  富友微信通道,也就是间联2微信通道
mybank.wxpay.barcode   网商微信通道,也就是间联3微信通道
heli.wxpay.barcode   合利宝微信通道,也就是间联1微信通道
lspay.wxpay.barcode   乐刷微信通道,也就是间联4 微信通道
支付宝类似

返回示例:

                                {
    "service": "pay.wxpay.qrcode",
    "orderid": "20171219180802000143200",
    "qr_code": "weixin://wxpay/bizpayurl?pr=BfYkB3H",
    "paymoney": "0.01",
    "pri_paymoney": "0.01",
    "paystatus": "0",
    "order_time": "1513678082",
    "mch_orderid": "",
    "code_url": "http://zhaoyin.lfwin.com/payapi/index/showqr/code/d2VpeGluOi8vd3hwYXkvYml6cGF5dXJsP3ByPUJmWWtCM0g%253D",
    "version": "3.0",
    "charset": "UTF-8",
    "message": "SUCCESS",
    "status": "10000",
    "sign_type": "MD5",
    "sign": "52540332aaab4267be5e5d57fd3b2d83"
}
                            
参数名 描述 类型
service 支付通道: pay.wxpay.qrcode 微信官方条码; pay.alipay.qrcode 支付宝官方条码; mybank.alipay.qrcode 网商银行支付宝条码;mybank.wxpay.qrcode 网商银行微信条码; string
orderid 系统订单号,唯一值 number
qr_code 支付二维码内容 string
paymoney 下单支付金额,单位元 number
pri_paymoney 商家优惠活动后,实际支付金额,单位元 number
paystatus 支付状态:1 支付成功 ,0代付款,2付款失败 number
order_time 下单时间。时间戳,单位秒 number
mch_orderid 商户外部订单号 string
code_url 支付二维码在线地址 string
version 接口版本号,3.0 number
charset 接口字符编码,UTF-8 string
message 错误信息 string
status 错误状态 number
sign_type 签名方式,MD5 string
sign 签名字符串,参照签名方法 string

H5支付

在线测试 在线浏览

请求方式:POST

请求地址:http://zhaoyin.lfwin.com/payapi/pay/jspay

Body参数名 类型 必需 描述 示例 e.g.
service string 接口名称 pay.wxpay.jspay
apikey string 商家APIKEY,唯一标识,由服务商提供 00014005
money string 支付金额,单位元,最小值0.01,表示0.01元 0.01
nonce_str string 随机字符串,长度不超过32位 123456
sign string 签名,参照签名算法 b0b12b65e6347c8d47923e7b2d53d7cc
mch_orderid string 商户外部订单号,必须保证每次下单唯一,如果下单失败请调用查询接口 20180209000000001
notify_url string 异步通知地址,支付成功后服务器发起通知
succ_url string 支付成功跳转页面地址,例如http://www.baidu.com/index.html
err_url string 支付取消或者失败返回的按钮的链接地址,例如http://www.baidu.com/index.html
remarks string 订单备注
store_dis string 平台店铺优惠活动是否打开 ,1打开 0关闭(默认)
hs string 是否https链接返回:默认 0-否 1是

详细说明:

注意:如果要在公众号里面唤起支付使用H5,必须保证公众号主体跟渠道进件主体一致,
扫码固定二维码唤起支付则不存在该问题。
如果是商户自有公众号配置,必须公众号授权域名、公众支付安全目录配置http://www.lfwin.com/wxpay/



关于支付通道说明:

微信跟支付宝 支付通道分为直连通道跟间联通道:
直连通道跟间联通道区别 在用户微信端支付流程体验都一样的,对于顾客无感知
商家结算的渠道不一样而已,具体可咨询业务方面细节。

直连通道列如:
pay.wxpay.barcode: 官方微信直连通道

间联通道列如:
fuiou.wxpay.barcode  富友微信通道,也就是间联2微信通道
mybank.wxpay.barcode   网商微信通道,也就是间联3微信通道
heli.wxpay.barcode   合利宝微信通道,也就是间联1微信通道
lspay.wxpay.barcode   乐刷微信通道,也就是间联4 微信通道
支付宝类似

返回示例:

                                {
    "url": "http://zhaoyin.lfwin.com/index/jspay/pay/data/MjRmYldKYjhidWNEUkZidVVMdlFEQmpGNWk3TDZwa1BkeSs4SW5EVXRJNFphbGdUQTBEL0xldHJwRnMvdFY1SlMyNjYrdm1Cbk9vM0VlZCsySnA1aURpeHZxaWcwNnNQQ09QZ1dtSDVUYTdmRTgxbXo2ZEtGRmdrSzA2VkVn",
    "mch_orderid": "",
    "service": "pay.alipay.jspay",
    "money": "0.02",
    "order_time": "1527850705",
    "version": "3.0",
    "charset": "UTF-8",
    "message": "SUCCESS",
    "status": "10000",
    "sign_type": "MD5",
    "sign": "f1a371fb00b0228187f91871c7521719"
}
                            
参数名 描述 类型
url H5支付跳转的支付页面地址 string
mch_orderid 商户外部订单号,注意:H5订单不返回orderid,支付查询只能用mch_orderid,必须保证mch_orderid商户系统唯一 string
order_time 下单时间,时间戳格式,精确到秒 string
service 接口名称 string
money 支付金额,单位元,最小值0.01,表示0.01元 number
version 接口版本号,3.0 number
charset 接口字符编码,UTF-8 string
message 错误信息 string
status 错误状态 number
sign_type 签名方式,MD5 string
sign 签名字符串,参照签名方法 string

公众号、小程序支付

在线测试 在线浏览

请求方式:POST

请求地址:http://zhaoyin.lfwin.com/payapi/mini/wxpay?test=1

Body参数名 类型 必需 描述 示例 e.g.
service string 接口名称 fuiou.mini.pay
apikey string 商家APIKEY,唯一标识,由服务商提供 00014005
money string 支付金额,单位元,最小值0.01,表示0.01元 0.01
nonce_str string 随机字符串,长度不超过32位 123456
sub_appid string 小程序/公众号appid,sub_appid跟sub_openid对应关系,并且appid跟微信支付商户号关联
sub_openid string 消费者用户在sub_appid下的标识sub_openid
sign string 签名,参照签名算法 b0b12b65e6347c8d47923e7b2d53d7cc
remarks string 订单备注
mch_orderid string 商户外部订单号,必须保证每次下单唯一,如果下单失败请调用查询接口 20180209000000001
notify_url string 异步通知地址,支付成功后服务器发起通知

详细说明:

富友公众号支付测试用例
* sub_appid:            wx5603ffc648ff3752
* sub_openid:          ohyVV0v4UBc63GL8D8nlEL0UO5vE

微信公众号支付测试用例
* sub_appid:          wx033257c23ccc1853
* sub_openid:        oyVHl5STColcoF8toT7j5bU6qCOQ

间联1公众号支付测试用例
* sub_appid:          wxb1bec7d809e7cf40
* sub_openid:        of6M701u-jOaV6lijvcxl-jjB500


*网商公众号支付测试用例
* sub_appid:          wxa9dd178d5b280770
* sub_openid:        oeTMu1l6YrIlKIuPhHcYBwgDJFhQ

公众号支付、小程序支付:
1、可以走系统服务商公众号模式,通过获取系统openid接口 获取到openid 跟 appid,并将该值赋予 sub_appid、sub_openid 作为参数唤起支付
2、走商户公众号模式,商户系统获取openid 跟 appid传递接口唤起支付

3.富友通道的绿洲微信用户。只能填写sub_appid和sub_openid ,并且  sub_appid 固定值为:  wxfa089da95020ba1a, sub_openid 通过获取系统openid获取

(与H5支付的区别是 H5直接返回收银台页面唤起支付,该接口返回是唤起支付的参数,需要做唤起支付处理操作)
service暂有2个枚举值(后期可能加其他支付)
分别为  
wxpay.mini.pay  微信小程序支付
wxpay.js.pay        微信公众号支付 
 sub_appid (小程序的APPID) 跟 sub_openid (消费者用户在sub_appid下的标识)必传
请求成功返回的结果,做如下处理 唤起支付
公众号:

function onBridgeReady(){
   WeixinJSBridge.invoke(
       'getBrandWCPayRequest', {
           "appId":"wx2421b1c4370ec43b",     //公众号名称,由商户传入     
           "timeStamp":"1395712654",         //时间戳,自1970年以来的秒数     
           "nonceStr":"e61463f8efa94090b1f366cccfbbb444", //随机串     
           "package":"prepay_id=u802345jgfjsdfgsdg888",     
           "signType":"MD5",         //微信签名方式:     
           "paySign":"70EA570631E4BB79628FBCA90534C63FF7FADD89" //微信签名 
       },
       function(res){     
           if(res.err_msg == "get_brand_wcpay_request:ok" ) {}     // 使用以上方式判断前端返回,微信团队郑重提示:res.err_msg将在用户支付成功后返回    ok,但并不保证它绝对可靠。 
       }
   ); 
}
if (typeof WeixinJSBridge == "undefined"){
   if( document.addEventListener ){
       document.addEventListener('WeixinJSBridgeReady', onBridgeReady, false);
   }else if (document.attachEvent){
       document.attachEvent('WeixinJSBridgeReady', onBridgeReady); 
       document.attachEvent('onWeixinJSBridgeReady', onBridgeReady);
   }
}else{
   onBridgeReady();
}  

小程序:

示例代码:

wx.requestPayment(
{
'timeStamp': '',
'nonceStr': '',
'package': '',
'signType': 'MD5',
'paySign': '',
'success':function(res){
},
'fail':function(res){},
'complete':function(res){
}
})



请求失败返回实例:
{
    "version": "3.0",
    "charset": "UTF-8",
    "sign_type": "MD5",
    "status": "4000",
    "message": "接口返回错误:FAIL,sub_mch_id与sub_appid不匹配"
}



返回示例:

                                {
    "appId": "wx0fe958a999250740",
    "timeStamp": "'1524221960'",
    "nonceStr": "t7qohzz2sb1e0t3njfqa9p42ghrzq5gs",
    "signType": "MD5",
    "package": "prepay_id=wx2018592074688612d0b75f414227509723",
    "paySign": "B7021278F31DA6B3BD1C6CB1DE38B3DF",
    "service": "wxpay.mini.pay",
    "orderid": "201804201859200070044104",
    "order_time": "1524221960",
    "mch_orderid": "",
    "qr_code": "",
    "trade_type": "JSAPI",
    "prepay_id": "wx2018592074688612d0b75f414227509723",
    "version": "3.0",
    "charset": "UTF-8",
    "message": "SUCCESS",
    "status": "10000",
    "sign_type": "MD5",
    "sign": "5064ba8df2a4960f3e2219f1d83d1f56"
}
                            
参数名 描述 类型
service 接口名称 string
version 接口版本号,3.0 number
charset 接口字符编码,UTF-8 string
message 错误信息 string
status 错误状态 number
sign_type 签名方式,MD5 string
sign 签名字符串,参照签名方法 string
appId 发起微信支付参数,微信分配的小程序/公众号APPID string
timeStamp 发起微信支付参数,时间戳从1970年1月1日00:00:00至今的秒数,即当前的时间 string
nonceStr 发起微信支付参数,随机字符串,长度为32个字符以下。 string
signType 发起微信支付参数,签名算法,暂支持 MD5 string
package 发起微信支付参数,统一下单接口返回的 prepay_id 参数值,提交格式如:prepay_id=* string
paySign 发起微信支付参数,签名 string
service 接口名称 string
orderid 系统订单号,唯一值 number
order_time 下单时间,时间戳格式,精确到秒 number
mch_orderid 商户外部订单号,必须保证每次下单唯一,如果下单失败请调用查询接口 string
qr_code 二维码链接 string
trade_type 交易类型,如下:JSAPI string
prepay_id 预支付交易会话标识 string

获取系统公众号openid

在线测试 在线浏览

请求方式:GET

请求地址:http://www.lfwin.com/wxpay/index.php?g=Home&m=ApiJsPay&a=redirectOpenid

Query参数名 类型 必需 描述 示例 e.g.
state string 支付渠道类型 mybank
redirect string 授权回调通知地址,请使用 urlEncode 对链接进行处理 http://www.baidu.com

详细说明:

注意,redirect跳转地址不要以   列如:http://www.xxx.cn/home/index/index 这样的路由规则形式。要以域名+get参数形式   列如:http://www.xxx.cn?g=home&m=index&a=index ,并urlencode格式化
改接口主要用户公众号支付,服务商模式,openid使用系统渠道appid对应的openid
获取实例:
根据文档拼接链接如下:
http://www.lfwin.com/wxpay/index.php?g=Home&m=ApiJsPay&a=redirectOpenid&redirect=http%3a%2f%2fwww.baidu.com&state=mybank
http  get方式 请求:
页面跳转返回
 :
http://www.baidu.com/?sub_openid=oeTMu1l6YrIlKIuPhHcYBwgDJFhQ&code=081mw94q1Z5eIp0sSh5q1iEc4q1mw94r&sub_appid=wxa9dd178d5b280770
获取openid参数 以及code参数;

获取到openid后:
1.使用商户公众号的,在请求报文中,sub_appid和sub_openid 为商户公众号下的appid跟openid
2.使用系统公众号的,在请求报文中,sub_appid和sub_openid 为商户公众号下的appid跟openid为该接口返回的appid 跟openid
3.富友通道绿洲用户,sub_appid 固定值为 wxfa089da95020ba1a,sub_openid 为获取到的openid

返回示例:

                                http://www.baidu.com/?sub_openid=oeTMu1l6YrIlKIuPhHcYBwgDJFhQ&code=001D4WBe1BdIAr0kqcDe1GaYBe1D4WBO&sub_appid=wxb1bec7d809e7cf40
                            
参数名 描述 类型
openid 用户唯一标识,请注意,在未关注公众号时,用户访问公众号的网页,也会产生一个用户和公众号唯一的OpenID string
appid 系统渠道号的appid string

获取小程序的openid

在线测试 在线浏览

请求方式:POST

请求地址:http://zhaoyin.lfwin.com/payapi/mini/getopenid

Body参数名 类型 必需 描述 示例 e.g.
service string 接口名称 pay.mini.openid
apikey string 商家APIKEY,唯一标识,由服务商提供 00014005
nonce_str string 随机字符串,长度不超过32位 123456
sign string 签名,参照签名算法
sub_appid string 小程序appid wx17c010d0e3761034
sub_secret string 小程序的 app secret ba0d27f4c495cec8cfca8e4a0305d6db
js_code string 小程序的 登录时获取的 code 081aNlJD0Z8iSd2KgfJD07EHJD0aNlJP

返回示例:

                                {
    "session_key": "iPKnlezTMTOCfhHMPgSRRQ==",
    "openid": "o-TUB5WWdSq_ZH73EikkZHnS4eLI",
    "unionid": "",
    "version": "3.0",
    "charset": "UTF-8",
    "message": "SUCCESS",
    "status": "10000",
    "sign_type": "MD5",
    "sign": "54598a22b413c3ab66068c98d286a53e"
}
                            
参数名 描述 类型
session_key 小程序会话密钥 string
openid 小程序用户唯一标识 string
unionid 小程序用户在开放平台的唯一标识符(在满足UnionID下发条件的情况下,返回) string
version 接口版本号,3.0 number
charset 接口字符编码,UTF-8 string
message 错误信息 string
status 错误状态 number
sign_type 签名方式,MD5 string
sign 签名字符串,参照签名方法 string

支付状态轮询

在线测试 在线浏览

请求方式:POST

请求地址:http://zhaoyin.lfwin.com/payapi/pay/query_order

Body参数名 类型 必需 描述 示例 e.g.
service string 接口名称 pay.alipay.query_order
orderid string 系统订单号,唯一值 201807101612530070089833
apikey string 商家APIKEY,唯一标识,由服务商提供 00014005
sign string 签名,参照签名算法
nonce_str string 随机字符串,长度不超过32位 123456
mch_orderid string 商户订单号,如果orderid跟mch_orderid同时存在,以orderid为准 15181042584813748
order_time string 下单时间,时间戳,精确到秒,如果只传商户订单号,必须传下单时间 1518104258

详细说明:

测试环境目前只支持 2018年份的订单查询、轮询以及相关的操作;比如订单号 orderid:20180202171044007002473

返回示例:

                                {
    "service": "pay.wxpay.query_order",
    "orderid": "20171220114136000149917",
    "trade_no": "4200000017201712207715771529",
    "paystatus": "1",
    "paymoney": "0.01",
    "pri_paymoney": "0.01",
    "order_time": "1513741296",
    "paytime": "1513741304",
    "mch_orderid": "",
    "receipt_amount": "0.00",
    "buyer_pay_amount": "0.01",
    "coupon_fee": "0.00",
    "version": "3.0",
    "charset": "UTF-8",
    "message": "SUCCESS",
    "status": "10000",
    "sign_type": "MD5",
    "sign": "5caabe5f5b54e2402ca765a54894fb2e"
}
                            
参数名 描述 类型
service 接口名称 string
orderid 系统订单号,唯一值 number
trade_no 通道流水号 number
paystatus 支付状态:1 支付成功 ,0代付款,2付款失败 number
paymoney 下单支付金额,单位元 number
pri_paymoney 实际支付金额,单位元 number
order_time 下单时间。时间戳,单位秒 number
paytime 支付成功时间。时间戳,单位秒 number
mch_orderid 商户外部订单号 string
receipt_amount 商家实收金额,单位元 number
buyer_pay_amount 买家付款金额,单位元 number
coupon_fee 代金券金额,单位元 number
version 接口版本号,3.0 number
charset 接口字符编码,UTF-8 string
message 错误信息 string
status 错误状态 number
sign_type 签名方式,MD5 string
sign 签名字符串,参照签名方法 string
storediscount 商家店铺优惠活动金额,单位元 string
refundmoney 累计退款总金额,单位元 string
buyer_account 消费者账号 string

退款请求

在线测试 在线浏览

请求方式:POST

请求地址:http://zhaoyin.lfwin.com/payapi/pay/refund_order?test=1

Body参数名 类型 必需 描述 示例 e.g.
service string 接口名称 pay.alipay.refund_order
apikey string 商家APIKEY,唯一标识,由服务商提供 00014005
orderid string 系统订单号,唯一值 20180116091724007002831
nonce_str string 随机字符串,长度不超过32位 123456
sign string 签名,参照签名算法 470b767963acbcf45cf6aeb8f2b1bc4d
refundmoney string 退款金额,单位元 0.01
mid string 登录的退款店员id
mch_orderid string 商户订单号,如果orderid跟mch_orderid同时存在,以orderid为准
order_time string 下单时间,时间戳,精确到秒,如果只传商户订单号,必须传下单时间
reason string 退款理由,15字数以内
auth_mid string 授权的店员id
guid string 设备唯一标识

返回示例:

                                {
    "service": "pay.alipay.refund_order",
    "orderid": "20180109113326007009836",
    "refund_no": "20180109113326007009836rf699673",
    "is_refund": "2",
    "refundtime": "1515468863",
    "refundmoney": "0.01",
    "buyer_account": "you***@163.com",
    "version": "3.0",
    "charset": "UTF-8",
    "message": "SUCCESS",
    "status": "10000",
    "sign_type": "MD5",
    "sign": "d8dcd5197845f4a91a98c99daa0a9e2b"
}
                            
参数名 描述 类型
service 接口名称 string
orderid 系统订单号,唯一值 number
refund_no 退款通道流水号 string
is_refund 标识:2退款 1撤销 0普通订单(默认) number
refundtime 退款时间,时间戳,精确到秒 number
refundmoney 本次退款金额 number
buyer_account 用户支付宝账号 string
version 接口版本号,3.0 number
charset 接口字符编码,UTF-8 string
message 错误信息 string
status 错误状态 number
sign_type 签名方式,MD5 string
sign 签名字符串,参照签名方法 string

退款查询

在线测试 在线浏览

请求方式:POST

请求地址:http://zhaoyin.lfwin.com/payapi/pay/query_refund?test=1

Body参数名 类型 必需 描述 示例 e.g.
service string 接口名称 pay.alipay.query_refund
apikey string 商家APIKEY,唯一标识,由服务商提供 00014005
orderid string 原订单号 20180111161233007007257
nonce_str string 随机字符串,长度不超过32位 123456
sign string 签名,参照签名算法
refund_no string 退款订单号,不传退款订单号情况下查询原订单号已执行退款记录,传该值则不返回mid 20180111161233007007257rf
mch_orderid string 商户订单号,如果orderid跟mch_orderid同时存在,以orderid为准
order_time string 下单时间,时间戳,精确到秒,如果只传商户订单号,必须传下单时间
page_no string 第几页,默认第1页
page_size string 每页条数,默认20条,最大200条

详细说明:

对退款订单进行查询退款记录

返回示例:

                                {
    "total_items": "1",
    "page_size": "20",
    "current_no": "1",
    "total_no": "1",
    "lists": [
        {
            "orderid": "201804172107000070054649",
            "refund_no": "201804172107000070054649rf200391",
            "reason": "",
            "refundmoney": "0.01",
            "refundtime": "1523970773",
            "is_refund": "2",
            "mid": "881",
            "service": "mybank.wxpay.query_refund",
            "pri_paymoney": "0.00",
            "paymoney": ""
        }
    ],
    "version": "3.0",
    "charset": "UTF-8",
    "message": "SUCCESS",
    "status": "10000",
    "sign_type": "MD5",
    "sign": "253a417fbc0d67ac19f3468f971c56e6"
}
                            
参数名 描述 类型
total_items 总记录数 string
current_no 当前页码 string
total_no 总页码数目 string
page_size 每页记录数 string
lists 记录列表,array()数组类型,对应key参数如下 string
lists.service 接口名称 string
lists.orderid 系统订单号,唯一值 number
lists.refund_no 退款通道流水号 string
lists.reason 退款原因 string
lists.pri_paymoney 实际支付金额,单位元 number
lists.paymoney 下单支付金额,单位元 number
lists.refundmoney 本次退款金额,单位元 number
lists.refundtime 退款时间,时间戳,精确到秒 string
lists.mid 退款店员ID string
version 接口版本号,3.0 number
charset 接口字符编码,UTF-8 string
message 错误信息 string
status 错误状态 number
sign_type 签名方式,MD5 string
sign 签名字符串,参照签名方法 string
lists.is_refund 类型:1 撤销 2退款 string
lists.refund_status 退款状态:0待处理 1处理成功 2退款失败 string
lists.auth_mid 授权店员id string

撤销订单

在线测试 在线浏览

请求方式:POST

请求地址:http://zhaoyin.lfwin.com/payapi/pay/cancel_order

Body参数名 类型 必需 描述 示例 e.g.
service string 接口名称 pay.wexpay.cancel_order
apikey string 商家APIKEY,唯一标识,由服务商提供 00014005
orderid string 系统订单号,唯一值 20180112143625007009679
nonce_str string 随机字符串,长度不超过32位 123456
sign string 签名,参照签名算法 2171ed542106e5a26eb0ae7d1f9a7a22
mch_orderid string 商户订单号,如果orderid跟mch_orderid同时存在,以orderid为准
order_time string 下单时间,时间戳,精确到秒,如果只传商户订单号,必须传下单时间
guid string 设备唯一标识
mid string 登录的撤销店员id

详细说明:

本接口针对刷卡支付(被扫)模式用户长时间未等到订单终态或者一直超时,调用本接口撤销订单。当网商银行认定订单已支付成功支付失败,则撤销失败。调用订单撤销前先进行订单查询。

最早可撤销时间在订单创建之后15秒后。

撤销交易需要控制在1:00—23:00,其余时间不允许进行撤销交易。

返回示例:

                                {
    "service": "pay.alipay.cancel_order",
    "orderid": "20180115175018007003208",
    "is_refund": "1",
    "refundtime": "1516010935",
    "refundmoney": "0.00",
    "buyer_account": "",
    "version": "3.0",
    "charset": "UTF-8",
    "message": "SUCCESS",
    "status": "10000",
    "sign_type": "MD5",
    "sign": "ee47e0b712d8689033c5067ce14ea77d"
}
                            
参数名 描述 类型
service 接口名称 string
orderid 系统订单号,唯一值 number
is_refund 标识:2退款 1撤销 string
refundtime 撤销时间 string
refundmoney 撤销返还已支付金额,单位元 string
buyer_account 用户支付宝账号 string
version 接口版本号,3.0 number
charset 接口字符编码,UTF-8 string
message 错误信息 string
status 错误状态 number
sign_type 签名方式,MD5 string
sign 签名字符串,参照签名方法 string

关闭订单

在线测试 在线浏览

请求方式:POST

请求地址:http://zhaoyin.lfwin.com/payapi/pay/close_order

Body参数名 类型 必需 描述 示例 e.g.
service string 接口名称 pay.alipay.close_order
apikey string 商家APIKEY,唯一标识,由服务商提供 00014005
orderid string 系统订单号,唯一值 20180112143625007009679
nonce_str string 随机字符串,长度不超过32位 123456
sign string 签名,参照签名算法 2171ed542106e5a26eb0ae7d1f9a7a22
mch_orderid string 商户订单号,如果orderid跟mch_orderid同时存在,以orderid为准
order_time string 下单时间,时间戳,精确到秒,如果只传商户订单号,必须传下单时间
guid string 设备唯一标识
mid string 登录的撤销店员id

详细说明:

当订单创建后,消费者长时间未付款,合作方可通过本接口关闭订单。
如果订单未支付,关闭订单;
如果订单已经成功或支付失败,无法关闭,返回订单已成功或已失败。
调用失败返回:(生成扫码订单,但用户并未扫码的情况下)
注意:订单生成后不能马上调用关单接口,最短调用时间间隔为5分钟。
{
    "version": "3.0",
    "charset": "UTF-8",
    "sign_type": "MD5",
    "status": "4000",
    "message": ":MT_CLOSE_ORDER_FAIL,关闭支付单失败"
}
调用成功返回:
{
    "service": "mybank.alipay.close_order",
    "is_refund": "3",
    "orderid": "201811061539040070020162",
    "mch_orderid": "",
    "paystatus": "0",
    "pri_paymoney": "0.01",
    "version": "3.0",
    "charset": "UTF-8",
    "message": "SUCCESS",
    "status": "10000",
    "sign_type": "MD5",
    "sign": "512ff44f31d1b24e0df9d1242dbdca0c"
}

返回示例:

                                {
    "service": "mybank.alipay.close_order",
    "is_refund": "3",
    "orderid": "201811061539040070020162",
    "mch_orderid": "",
    "paystatus": "0",
    "pri_paymoney": "0.01",
    "version": "3.0",
    "charset": "UTF-8",
    "message": "SUCCESS",
    "status": "10000",
    "sign_type": "MD5",
    "sign": "512ff44f31d1b24e0df9d1242dbdca0c"
}
                            
参数名 描述 类型
service 接口名称 string
orderid 系统订单号,唯一值 number
is_refund 标识:2-退款订单 1-撤销订单 3-关闭订单 string
paystatus 支付状态 1-支付成功 2-支付失败 0-代付款 string
pri_paymoney 原订单实收金额 string
version 接口版本号,3.0 number
charset 接口字符编码,UTF-8 string
message 错误信息 string
status 错误状态 number
sign_type 签名方式,MD5 string
sign 签名字符串,参照签名方法 string
mch_orderid 商家系统外部订单号,必须保证每次下单唯一,如果下单失败请调用查询接口 string

签名算法

在线测试 在线浏览

请求方式:VIEW

请求地址:http://

详细说明:

数字签名

(ps:测试环境只能用00014005 这组apikey,调通流程上线生产环境请联系技术

测试环境只支持最新月份的订单

接口地址附带的?test=1只是方便测试环境调试接口,可以无视
例如:
http://zhaoyin.lfwin.com/payapi/pay/order_list?test=1
正常的接口地址应该是
http://zhaoyin.lfwin.com/payapi/pay/order_list

为了保证数据传输过程中的数据真实性和完整性,我们需要对数据进行数字签名,在接收签名数据之后进行签名校验。

数字签名有两个步骤,先按一定规则拼接要签名的原始串,再选择具体的算法和密钥计算出签名结果。

一般失败的结果不签名。

签名原始串

无论是请求还是应答,签名原始串按以下方式组装成字符串:

 1、除sign字段外,所有参数按照字段名的ascii码从小到大排序后使用QueryString的格式(即key1=value1&key2=value2…)拼接而成,key值为sign不参与签名组串。

 2、签名原始串中,字段名和字段值都采用原始值,不进行URL Encode。

 3、平台返回的应答或通知消息可能会由于升级增加参数,请验证应答签名时注意允许这种情况。

 4、对平台返回的应答或通知消息进行验签过程也一样,得到的签名结果对比sign参数,如果值相等则签名通过,如果不等,则签名不通过。

举例:

调用扫码支付接口,接口有如下字段:

{

  "service": "pay.alipay.qrcode",

  "apikey": "00014005",

  "money": "0.01",

  "nonce_str": "123456",

}

正确的待签名字符串字段排序为:

apikey=00014005&money=0.01&nonce_str=123456&service=pay.alipay.qrcode

签名算法

目前暂只支持MD5签名

MD5签名

MD5 是一种摘要生成算法,通过在签名原始串后加上商户通信密钥的内容,进行MD5运算,形成的摘要字符串即为签名结果。为了方便比较,签名结果统一转换为32位小写字符。

注意:签名时将字符串转化成字节流时指定的编码字符集(UTF-8)应与参数charset一致。

MD5签名计算公式:

sign=Md5(原字符串&signkey=商户密钥).toLowerCase

假设待签名字符串

apikey=00014005&money=0.01&nonce_str=123456&service=pay.alipay.qrcode

商户密钥为:punr8ucu

经过拼接商户秘钥过程 字符串 string 为:

apikey=00014005&money=0.01&nonce_str=123456&service=pay.alipay.qrcode&signkey=punr8ucu

经过md5加密过程后得到 sign 为:

sign

=md5(apikey=00014005&money=0.01&nonce_str=123456&service=pay.alipay.qrcode&signkey=punr8ucu)

=e2bc07b313c49f166ec03796370d8eb2

异步通知参数

在线测试 在线浏览

请求方式:VIEW

请求地址:http://

详细说明:

正式环境下H5支付,扫码支付以及小程序支付成功时候,如果有传notify_url参数,notify_url网址便会收到支付成功的异步通知,测试环境不发送通知。网商通道预计3月5日左右 上线异步通知
接收异步通知notify_url 页面在收到通知时候 返回success字符时候,服务器会停止通知,总计通知次数大约6次
POST 方式发送
{
  'orderid' :  '20180202171044007002473',
  'trade_no' :  '4200000061201802025681296197',
  'paystatus' :  '1',
  'paymoney' :  '0.01',
  'pri_paymoney' :  '0.01',
  'order_time' :  '1517562644',
  'paytime' :  '1517562682',
  'mch_orderid' :  '',
  'buyer_account' :  '微信账号',
  'notify_url':  'http://www.xxx.com',
  'sign' :  '0ee2e3d34573de75f973630403db24b6',
}
参数注释参照文档

人脸初始化

在线测试 在线浏览

请求方式:POST

请求地址:http://zhaoyin.lfwin.com/payapi/smile/smile_init?test=1

Body参数名 类型 必需 描述 示例 e.g.
service string 接口名称 smile.init
nonce_str string 随机字符串,长度不超过32位 123456
apikey string 商家APIKEY,唯一标识,由服务商提供 00014005
zimmetainfo string 初始化入参(json 字符串) {"apdidToken":"7h/mF79pZvcDyd62s+3LBXivTX4ZQYpLXYwEAAA==","appName":"com.alipay.zoloz.smile","appVersion":"3.2.0.201806042226","bioMetaInfo":"3.7.1:2146304,2","deviceModel":"wintec_anypos","deviceType":"android","machineInfo":{"cameraDriveVer":"","cameraModel":"AstraPro2","cameraName":"AstraPro2","cameraVer":"","ext":"","group":"","machineCode":"WvbEUb7oFjQDAOplta7t9eN2","machineModel":"wintec_anypos","machineVer":"5.1.1"},"merchantInfo":{"areaCode":"2222221","brandCode":"222222","deviceMac":"84:20:96:","deviceNum":"0641KC180","geo":"0.000000,0.000000","wifiMac":"","wifiName":""},"osVersion":"5.1.1","remoteLogID":"06c9adadddba10b70c065ec6a","zimVer":"1.0.0"}
sign string 签名,参照签名算法 5ee3e9abc90cbc1c6a5e22b026729fd5

详细说明:

zimmetainfo(初始化入参)  参照文档 https://docs.alipay.com/pre-open/20180402104715814204/gzay38
集合类型转化为json 字符串。
例如:
{"apdidToken":"7h/mF79pZvcDyd62s+3LBXivTX4ZQYpLXYwEAAA==","appName":"com.alipay.zoloz.smile","appVersion":"3.2.0.201806042226","bioMetaInfo":"3.7.1:2146304,2","deviceModel":"wintec_anypos","deviceType":"android","machineInfo":{"cameraDriveVer":"","cameraModel":"AstraPro2","cameraName":"AstraPro2","cameraVer":"","ext":"","group":"","machineCode":"WvbEUb7oFjQDAOplta7t9eN2","machineModel":"wintec_anypos","machineVer":"5.1.1"},"merchantInfo":{"areaCode":"2222221","brandCode":"222222","deviceMac":"84:20:96:","deviceNum":"0641KC180","geo":"0.000000,0.000000","wifiMac":"","wifiName":""},"osVersion":"5.1.1","remoteLogID":"06c9adadddba10b70c065ec6a","zimVer":"1.0.0"}

返回示例:

                                {
    "zimId": "688ed0977d52b05b04e416c7a4ea0ee3",
    "type": "zimInit",
    "zimInitClientData": "CGQSABoAIqgSQ3RnTENpQTNaalJrWTJZMFlqTmtabUZpTURoa1kyRmxNamRrTkdVNFptTmtOMkl6TVJCa0tyRUxleUpqYjJ4c0lqcDdJblJ2Y0ZSbGVIUmZibTltWVdObElqb2k1cktoNXB5SjVxT0E1cldMNVlpdzZJUzRJaXdpZEc5d1ZHVjRkRjlwYm5SbFozSnBkSGtpT2lMbWlvcm9oTGpucDd2bGhhWGxuSWpsaG9VaUxDSjBiM0JVWlhoMFgyRnVaMnhsSWpvaTZLLTM2WjJpNVpDUjViR1A1Ym1WNUxpSzVwYTU1cEdFNVlPUDVhUzBJaXdpWVdOMGFXOXVUVzlrWlNJNld5STNJaXdpTnlJc0lqY2lMQ0kzSWl3aU55SXNJamNpTENJM0lpd2lOeUlzSWpjaUxDSTNJbDBzSW1KdmRIUnZiVlJsZUhRaU9pTG9yN2ZtaW9yb2hMam1sTDdsaGFYbW9ZYmxob1hrdjUzbWpJSGt1STNsaXFnaUxDSjBiM0JVWlhoMFgyMWhlRjl5WldOMGQybGtkR2dpT2lMbnBydm92NXprdUlEbmdya2lMQ0oxY0d4dllXUkVaWEIwYUVSaGRHRWlPbVpoYkhObExDSjFjR3h2WVdSTmIyNXBkRzl5VUdsaklqb3hMQ0owYjNCVVpYaDBYM04wWVhraU9pTG1yYVBsbktqbHBJVG5rSVlpTENKMGIzQlVaWGgwWDJ4cFoyaDBJam9pNklTNDZZT281THF1NUxpQTU0SzVJaXdpYkdsbmFIUWlPakUzT0N3aWRHbHRaU0k2TWpBc0luUnZjRlJsZUhSZmNtVmpkSGRwWkhSb0lqb2k2WjJnNkwtUjVMaUE1NEs1SWl3aWNtVjBjbmtpT2pNc0luUnZjRlJsZUhSZmNYVmhiR2wwZVNJNkl1aXZ0LW1kb3VXUWtlV3hqLVc1bGVTNGl1YVd1ZWFSaE9XRGotV2t0Q0lzSW5SdmNGUmxlSFJmWW14MWNpSTZJdVdHamVhNGhlYVpzT1M0Z09lQ3VTSXNJblJ2Y0ZSbGVIUmZZbXhwYm1zaU9pTG5uS2pubktqbm5Md2lmU3dpZFdraU9pSTVPVElpTENKMWNHeHZZV1FpT25zaWJXOWtaU0k2SWpJdU1DSXNJbVJsYzJseVpXUlhhV1IwYUNJNk1USTRNQ3dpZFhCc2IyRmtYMk52YlhCeVpYTnpYM0poZEdVaU9qQXVOeXdpWTI5c2JHVmpkR2x2YmlJNld5SlFZVzV2SWwwc0lteHZaMTlqYkdGemMybG1hV1Z5SWpvaU1TTXlJbjBzSW01dlEyRnRVR1Z5YldsemMybHZibGR2Y21Seklqb2k1YnlBNllDYTVaQ081b21ONVktdjVMdWw1TDJfNTVTbzVZaTM2SVM0NVlxZjZJTzk3N3lNNkwtYjVZV2w1WVdONWEtRzVwZTI1THVqSWl3aVpXNTJJam93TENKbVlXTmxWR2x3Y3lJNmV5SnNhVzFwZEVGc1pYSjBJanA3SW5KbGRIVnlia052WkdVaU9qSXdPU3dpY21sbmFIUkNkWFIwYjI1VVpYaDBJam9pNW9pUjU1LWw2WUdUNUxxR0lpd2lkR2wwYkdVaU9pTG1uS3JvZzczb3I0YmxpS3ZrdXJyb2hMZ2lmWDBzSW1Gc1oyOXlhWFJvYlNJNmV5SndiM05sWDJScGMzUmhibU5sVFdGNElqb3hOVEF3TENKbGVXVklkM0poZEdsdklqb3dMakUyTENKemRHRmphMTkwYVcxbElqb3hMakFzSW5Sb2NtVnphRzlzWkNJNmV5SkNZWFJNYVhabGJtVnpjeUk2V3pBdU5WMTlMQ0p3YjNObFgzQnBkR05vSWpvd0xqRTNMQ0o1ZFc1eGFWRjFZV3hwZEhraU9qUXNJbkJ2YzJWZmVXRjNJam93TGpJc0lteHBkbVZ1WlhOelgyTnZiV0pwYm1GMGFXOXVjeUk2SWtKaGRFeHBkbVZ1WlhOeklpd2ljRzl6WlY5bllYVnpjMmxoYmlJNk1TNHdMQ0p3YjNObFgyMXZkR2x2YmlJNk1TNHdMQ0p3YVhSamFGZGxhV2RvZENJNk5Dd2ljRzl6WlY5d2FYUmphRTFwYmlJNkxUQXVNVGNzSW5CdmMyVmZjbVZqZEhkcFpIUm9Jam93TGpNc0luQnZjMlZmYVc1MFpXZHlhWFI1SWpvd0xqazFMQ0prYVhOWFpXbG5hSFFpT2pRc0lubGhkMWRsYVdkb2RDSTZNU3dpY0c5elpWOXNhV2RvZENJNk1DNHdMQ0p3YjNObFgzbGhkMDFwYmlJNkxUQXVNaXdpWW1GMFRHbDJaVzVsYzNOVWFISmxjMmh2YkdRaU9qQXVOU3dpYkc5blgyeGxkbVZzSWpvd0xDSndiM05sWDJScGMzUmhibU5sVFdsdUlqb3lNREFzSW1ScFptWmxjaUk2TUM0eE5Td2liR2wyWlc1bGMzTmZZMjl0WW1sdVlYUnBiMjRpT2xzaVFtRjBUR2wyWlc1bGMzTWlYU3dpYldGNFgybHZaQ0k2TVM0d0xDSnhkV0ZzYVhSNVgyMXBibDl4ZFdGc2FYUjVJam95TUN3aWMzUmhZMnRmYzJsNlpTSTZNU3dpYldsdVgybHZaQ0k2TUM0d2ZYMFNnQUlkTl8tTl9SWGpveFI1V0VMdGlFRFcwcXpCZ0dpQnRINDZ4eU00X2hvSGlncXdqQVEwRDZsdjR4aGc0ZjNQQ1M1Y0d5RjFMNFFBQV9RUUdfN2lUQld3WEViTzREbnZ1b2VoSVdpTG9KNXNxdTBlbmEzT1MzYVJORFpVUVJJZ3dNTGs5RXNRNnhTdG50UGdwbDlUWWpQdHBwRHhvbkYyNTJFVnpCMUM5c3dKbTBBNEJCQlVFMC1qZjZDLWZ0bGZ3RnNwYUY3YjZfX2ExMXVXSEI2N1haQVBSX3IzUFlkVjItRXJDMHhqNEQxblh0YXlPUDBfd1VCbl94MjI3ZC1UcVQtRmtPZHdmU0RtUVNua0o3QW9ITWp5MlB4dV81WlZMdUliMWd5R1ZVRkQ2TTJadHVWWkRiYlhOSWNwdTBONm4xRV8xMVFuTUJmMk5xaC1PQkhmdUpPYypoCmYKDmZhY2VwYXlJbmZvTWFwElR7ImFjdGlvblR5cGUiOiJtb2JpbGUiLCJhY3Rpb25OdW0iOiIxMSIsImFjdGlvbk1vZGUiOiJmaXhlZCIsImFjdGlvbkRpcmVjdCI6ImZyb250In0yBVo1MTEwOg7miJDlip8gKFo1MTEwKQ",
    "version": "3.0",
    "charset": "UTF-8",
    "message": "SUCCESS",
    "status": "10000",
    "sign_type": "MD5",
    "sign": "470549945cd6cecf9eb252abcb2cc411"
}
                            
参数名 描述 类型
zimId 唤起人脸关键参数 string
type 唤起人脸关键参数 string
zimInitClientData 唤起人脸关键参数 string
version 接口版本号,3.0 number
charset 接口字符编码,UTF-8 string
message 错误信息 string
status 错误状态 number
sign_type 签名方式,MD5 string
sign 签名字符串,参照签名方法 string

扫脸支付

在线测试 在线浏览

请求方式:POST

请求地址:http://zhaoyin.lfwin.com/payapi/pay/smile?test=1

Body参数名 类型 必需 描述 示例 e.g.
service string 接口名称 pay.alipay.smile
apikey string 商家APIKEY,唯一标识,由服务商提供 00014005
money string 支付金额,单位元,最小值0.01,表示0.01元 0.01
ftoken string 支付宝脸部识别ftoken信息
nonce_str string 随机字符串,长度不超过32位 123456
sign string 签名,参照签名算法
fq_num string 花呗分期数,包括3/6/12期的,还款期数越长手续费越高,可选
seller_percent string 花呗分期手续费承担方式,由用户全承担(该值为0),也可以商户全承担(该值为100),可选
mch_orderid string 商家系统外部订单号,必须保证每次下单唯一,如果下单失败请调用查询接口
goods_id string 商品国标码,多个单品逗号分隔,口碑或微信单品优惠所需,可选
goods_name string 商品名称,多个单品逗号分隔,口碑或微信单品优惠所需,可选
quantity string 商品数量,多个单品逗号分隔,口碑或微信单品优惠所需,可选
price string 商品单价,多个单品逗号分隔,口碑或微信单品优惠所需,可选
goods_tag string 微信官方订单优惠标记,代金券或立减优惠功能,如果设置该值,goods_tag内容与配置内容相同,且支付金额满足代金券使用条件才会触发代金券的使用。不设置则只要支付金额满足条件就会触发代金券的使用;
mid string 登录的收款店员id
remarks string 订单备注
guid string 设备唯一标识

返回示例:

                                {
    "service": "pay.alipay.smile",
    "orderid": "20171219164426000147633",
    "trade_no": "2017121921001004380253421293",
    "paymoney": "0.01",
    "pri_paymoney": "0.01",
    "buyer_account": "you***@163.com",
    "receipt_amount": "0.01",
    "buyer_pay_amount": "0.01",
    "point_amount": "0.00",
    "paytime": "1513673068",
    "fund_bill_list": "[{\"amount\":\"0.01\",\"fund_channel\":\"ALIPAYACCOUNT\"}]",
    "paystatus": "1",
    "order_time": "1513673066",
    "mch_orderid": "",
    "version": "3.0",
    "charset": "UTF-8",
    "message": "SUCCESS",
    "status": "10000",
    "sign_type": "MD5",
    "sign": "a5b932721a22aa285076c87190c49739"
}
                            
参数名 描述 类型
service 支付通道: pay.alipay.smile 支付宝刷脸支付 string
orderid 系统订单号,唯一值 number
trade_no 通道流水号 number
paymoney 下单支付金额,单位元 number
pri_paymoney 商家优惠活动后,实际支付金额,单位元 number
receipt_amount 商家实收金额,单位元 number
buyer_pay_amount 买家付款金额,单位元 number
point_amount 积分宝付款的金额,单位元 number
coupon_fee 代金券金额,单位元 string
buyer_account 买家支付宝账号 string
paytime 支付成功时间。时间戳,单位秒 number
fund_bill_list 支付渠道 json字符串,fund_channel :交易使用的资金渠道,详见,支付渠道列表; amount :该支付工具类型所使用的金额;real_amount:渠道实际付款金额 string
paystatus 支付状态:1 支付成功 ,0代付款,2付款失败 number
order_time 下单时间。时间戳,单位秒 number
mch_orderid 商户外部订单号 string
version 接口版本号,3.0 number
charset 接口字符编码,UTF-8 string
message 错误信息 string
status 错误状态 number
sign_type 签名方式,MD5 string
sign 签名字符串,参照签名方法 string

DES加密传输

在线测试 在线浏览

请求方式:POST

请求地址:http://zhaoyin.lfwin.com/payapi/des/gateway

Body参数名 类型 必需 描述 示例 e.g.
url string 请求接口地址,参照各接口文档
body string 请求参数主体,参照各接口文档中请求参数,由des 算法加密串,并且base64处理,明文后是json字符串
apikey string 商家APIKEY,唯一标识,由服务商提供

详细说明:

DES加密传输,主要用于安全性要求比较高的接口要求。
接口调用流程,参照各个接口文档的请求参数:
比如扫码支付接口,请求参数为:
{
"service"=>"pay.wxpay.qrcode",
"apikey"=>"00014005",
"money"=>"0.02",
"nonce_str"=>"20180328153131",
"sign"=>"2d9fd128085ff5199ab7832f4d194de4"
}
那么对这些参数进行 json处理,并且des加密,des加密密钥key为signkey的值,不足8字节,前面补0,  加密模式为 CBC 模式,加密后的结果做base64处理
最后获得body=
Q4rtSC4DF0o7cH8MsxBlyCJHFRdnntDm9DYMcXZHFKE2wfEKbACtxiHLGSOLpLlkptsOFemicl4pKRLmu0hUPlLw+sSKHMCXFP17Sz6D2izQTAqHHTs0sbhw5cL/QUpkedD5iT+G9mZbnN//HVerPcWHaWdmAfwiv4leiz9MEysjaKpsj7eDNtqHW51AtsY+

最后请求接口的参数为

{
 'url'=>'http://zhaoyin.lfwin.com/payapi/pay/qrcode',   'body'=>'Q4rtSC4DF0o7cH8MsxBlyCJHFRdnntDm9DYMcXZHFKE2wfEKbACtxiHLGSOLpLlkptsOFemicl4pKRLmu0hUPlLw+sSKHMCXFP17Sz6D2izQTAqHHTs0sbhw5cL/QUpkedD5iT+G9mZbnN//HVerPcWHaWdmAfwiv4leiz9MEysjaKpsj7eDNtqHW51AtsY+',
 'apikey'=>'00014005'
}


请求成功返回实例:
{
    "message": "SUCCESS",
    "status": "10000",
    "sign_type": "DES",
    "body": "Q4rtSC4DF0o7cH8MsxBlyCJHFRdnntDmGkWHYsqq/cXXqXnp3sVFjvJbXs0dgDrhuf7BZRdcfejPwduu+WsLgUKymVd7ybdQ/S3CWolAs6jcPwrd62f/bKaZqN9xW6eQtjcGRX0BSpgouSBhldqpMZho9fShf7Jt30P5NynzMTrbpnm400lC/U4ycveW2uEQqSNS5od3q6bkx+T7kU0c2QNqBPFJnL3K52ARgS3Chu8IzzrIR3Zq68DCUbC4D21/6rAP922UHOm0kOCVQfch20KB0LWVWj09ee8da2wYUGnytAEKPb4ZzNj9EaVVmIoaC2x9YeXtm4YmGnalK2FG/LbsRRb4i/Q+qwoOxgitJgubCoLumGykvE+Rt5U5vy5v5XjguQ2xg4EvhD+Mt9+eO15LwRDFwfVwhi9yOwOiucUlJ/EToMqYeXRVAV+0pmEhy0cYD0fylpCu20shqcscBuJaRe4Gn7i8UF1T7F87qYv2wIl/I24Gl/jc03poyEW5Qp/oBSZ8thJ3ceoMtlbyEzI2qDPSlaz7vulImrANip4ZbWLv9LDBgdRPbOqN8qbU05CoUYNwz5VfwiJFmEuebfgas/YyYPD1YuHKiMHGX3zUyhspL7yYpg=="
}
请求失败返回实例:
{
    "version": "3.0",
    "charset": "UTF-8",
    "sign_type": "MD5",
    "status": "3900",
    "message": "验签失败"
}

返回示例:

                                {
    "message": "SUCCESS",
    "status": "10000",
    "sign_type": "DES",
    "body": "Q4rtSC4DF0o7cH8MsxBlyCJHFRdnntDmGkWHYsqq/cXXqXnp3sVFjvJbXs0dgDrhuf7BZRdcfejPwduu+WsLgUKymVd7ybdQ/S3CWolAs6jcPwrd62f/bKaZqN9xW6eQtjcGRX0BSpgouSBhldqpMZho9fShf7Jt30P5NynzMTrbpnm400lC/U4ycveW2uEQqSNS5od3q6bkx+T7kU0c2QNqBPFJnL3K52ARgS3Chu8IzzrIR3Zq68DCUbC4D21/6rAP922UHOm0kOCVQfch20KB0LWVWj09ee8da2wYUGnytAEKPb4ZzNj9EaVVmIoaC2x9YeXtm4YmGnalK2FG/LbsRRb4i/Q+qwoOxgitJgubCoLumGykvE+Rt5U5vy5v5XjguQ2xg4EvhD+Mt9+eO15LwRDFwfVwhi9yOwOiucUlJ/EToMqYeXRVAV+0pmEhy0cYD0fylpCu20shqcscBuJaRe4Gn7i8UF1T7F87qYv2wIl/I24Gl/jc03poyEW5Qp/oBSZ8thJ3ceoMtlbyEzI2qDPSlaz7vulImrANip4ZbWLv9LDBgdRPbOqN8qbU05CoUYNwz5VfwiJFmEuebfgas/YyYPD1YuHKiMHGX3zUyhspL7yYpg=="
}
                            
参数名 描述 类型
body 请求参数主体,参照各接口文档中返回参数,由des 算法加密串,并且base64处理,明文后是json字符串 string
sign_type 加密方式固定值DES ,注意跟 body体明文后的sign_type 不同,如果接口返回失败,sign_type可能为md5 string
status 错误状态 string
message 错误信息 string

业务相关

商家云播报

在线测试 在线浏览

请求方式:POST

请求地址:http://zhaoyin.lfwin.com/bsapi/merchant/mer_report

Body参数名 类型 必需 描述 示例 e.g.
service string 接口名称 yun.speaker.add
apikey string 商家APIKEY,唯一标识,由服务商提供 00014005
nonce_str string 随机字符串,长度不超过32位 123456
sign string 签名,参照签名算法
money string 播报金额,单位元,当service参数为yun.speaker.add、yun.sound.add必填
m_paytype string 支付类型 : alipay 支付宝 ; wxpay 微信 ; unpay 银联云闪付 ;
orderid string 系统订单号,唯一值,为线下支付接口返回的订单号orderid,当service参数为ai.pos.add必填
remarks string 播报备注信息,最大 255 个字节。
volume string 播报音量设置值,范围为 0 到 100,代表从无音到最大声,当service参数为yun.speaker.vol必填
mch_orderid string 商户订单号,必须保证每次下单唯一,mch_orderid 跟orderid不能同时为空,当service参数为ai.pos.add选填
order_time string 下单时间,时间戳,精确到秒,如果只传商户订单号,必须传下单时间,当service参数为ai.pos.add选填

详细说明:


返回示例:

                                {
    "version": "3.0",
    "charset": "UTF-8",
    "message": "SUCCESS",
    "status": "10000",
    "sign_type": "MD5",
    "sign": "3e340587550bc6a6dc9d6f07d5e8689a"
}
                            
参数名 描述 类型
version 接口版本号,3.0 number
charset 接口字符编码,UTF-8 string
message 错误信息 string
status 错误状态 number
sign_type 签名方式,MD5 string
sign 签名字符串,参照签名方法 string

商家云打印

在线测试 在线浏览

请求方式:POST

请求地址:http://zhaoyin.lfwin.com/bsapi/merchant/mer_print

Body参数名 类型 必需 描述 示例 e.g.
service string 接口名称 yun.print.add
apikey string 商家APIKEY,唯一标识,由服务商提供 00014005
nonce_str string 随机字符串,长度不超过32位 123456
sign string 签名,参照签名算法
data string 云打印数据, base64 编码,打印数据格式参照热敏打印机编程手册
business_id string 打印编号, 必须保证每次请求接口唯一
orderid string 商家订单号

返回示例:

                                {
    "version": "3.0",
    "charset": "UTF-8",
    "message": "SUCCESS",
    "status": "10000",
    "sign_type": "MD5",
    "sign": "3e340587550bc6a6dc9d6f07d5e8689a"
}
                            
参数名 描述 类型
version 接口版本号,3.0 number
charset 接口字符编码,UTF-8 string
message 错误信息 string
status 错误状态 number
sign_type 签名方式,MD5 string
sign 签名字符串,参照签名方法 string

商家结算

在线测试 在线浏览

请求方式:POST

请求地址:http://zhaoyin.lfwin.com/bsapi/merchant/mer_summary

Body参数名 类型 必需 描述 示例 e.g.
service string 接口名称 mer.summary
apikey string 商家APIKEY,唯一标识,由服务商提供 00014005
nonce_str string 随机字符串,长度不超过32位 123456
sign string 签名,参照签名算法
guid string 设备编号 11111
union_pay string 是否返回银联订单汇总:1是 0否(默认)
staff_account string 执行结算的店员账号

详细说明:


返回示例:

                                {
    "alipay": {
        "succ_count": "0",
        "ref_count": "0",
        "succ_money": "0",
        "pri_money": "0",
        "ref_money": "0"
    },
    "wxpay": {
        "succ_count": "0",
        "ref_count": "0",
        "succ_money": "0",
        "pri_money": "0",
        "ref_money": "0"
    },
    "bdpay": {
        "succ_count": "0",
        "ref_count": "0",
        "succ_money": "0",
        "pri_money": "0",
        "ref_money": "0"
    },
    "cashpay": {
        "succ_count": "0",
        "ref_count": "0",
        "succ_money": "0",
        "pri_money": "0",
        "ref_money": "0"
    },
    "best": {
        "succ_count": "0",
        "ref_count": "0",
        "succ_money": "0",
        "pri_money": "0",
        "ref_money": "0"
    },
    "version": "3.0",
    "charset": "UTF-8",
    "message": "SUCCESS",
    "status": "10000",
    "sign_type": "MD5",
    "sign": "0c176ae765650c4be9e43ddc06f83088"
}
                            
参数名 描述 类型
params 字段注释参照汇总查询里面的注释 string
stime 结算开始时间,时间戳格式,精确到秒 string
estime 结算结束时间,时间戳格式,精确到秒 string

商家结算记录

在线测试 在线浏览

请求方式:POST

请求地址:http://zhaoyin.lfwin.com/bsapi/merchant/summary_list

Body参数名 类型 必需 描述 示例 e.g.
service string 接口名称 summary.list
apikey string 商家APIKEY,唯一标识,由服务商提供 00014005
nonce_str string 随机字符串,长度不超过32位
sign string 签名,参照签名算法
guid string 设备编号
time_s string 结算时间范围,搜索开始时间,时间戳
time_e string 结算时间范围,搜索结束时间,时间戳
page_no string 第几页,默认第1页
page_size string 每页条数,默认20条,最大200条

返回示例:

                                {
    "total_items": "1",
    "page_size": "20",
    "current_no": "1",
    "total_no": "1",
    "lists": [
        {
            "id": "2",
            "guid": "11111",
            "detail": "{\"alipay\":{\"succ_count\":0,\"ref_count\":0,\"succ_money\":0,\"pri_money\":0,\"ref_money\":0},\"wxpay\":{\"succ_count\":0,\"ref_count\":0,\"succ_money\":0,\"pri_money\":0,\"ref_money\":0},\"bdpay\":{\"succ_count\":0,\"ref_count\":0,\"succ_money\":0,\"pri_money\":0,\"ref_money\":0},\"cashpay\":{\"succ_count\":0,\"ref_count\":0,\"succ_money\":0,\"pri_money\":0,\"ref_money\":0},\"best\":{\"succ_count\":0,\"ref_count\":0,\"succ_money\":0,\"pri_money\":0,\"ref_money\":0}}",
            "staff_account": ""
        }
    ],
    "version": "3.0",
    "charset": "UTF-8",
    "message": "SUCCESS",
    "status": "10000",
    "sign_type": "MD5",
    "sign": "ed18642aadcd2471b38adcfbed5a4555"
}
                            
参数名 描述 类型
total_items 总记录数 number
page_size 每页记录数 number
current_no 当前页码 number
total_no 总页码数目 number
lists 记录列表,array()数组类型,对应key参数如下 array
lists.id 结算记录ID number
lists.guid 结算设备编号 number
lists.detail 结算详情,json字符串,字段注释参照汇总查询 string
lists.staff_account 结算店员账号 string
version 接口版本号,3.0 number
charset 接口字符编码,UTF-8 string
message 错误信息 string
status 错误状态 number
sign_type 签名方式,MD5 string
sign 签名字符串,参照签名方法 string
lists.stime 结算开始时间,时间戳格式,精确到秒 string
lists.etime 结算结束时间,时间戳格式,精确到秒 string

广告图片

在线测试 在线浏览

请求方式:POST

请求地址:http://zhaoyin.lfwin.com/bsapi/merchant/mer_advert

Body参数名 类型 必需 描述 示例 e.g.
service string 接口名称 mer.advert
apikey string 商家APIKEY,唯一标识,由服务商提供 00014005
nonce_str string 随机字符串,长度不超过32位 123456
sign string 签名,参照签名算法
rand_num string 随机广告条数,默认1,获取一条广告数据
page_no string 第几页,默认第1页
page_size string 每页条数,默认20条,最大200条

返回示例:

                                {
    "rand_num": "1",
    "uptime": "86400",
    "lists": [
        {
            "title": "测试",
            "img_url": {
                "bg": "http://images.lfwin.com/upload/2/u22604661/2018_08/23_cxax96wgg51sjltv.jpg",
                "receipt_code": {
                    "isShowQrcode": "1",
                    "qrcode_info": {
                        "left": "140",
                        "top": "210",
                        "width": "320",
                        "height": "320"
                    }
                },
                "code": [
                    {
                        "code_url": "http://www.lfwin.com",
                        "code_info": {
                            "left": "76",
                            "top": "813.99996948242",
                            "width": "148",
                            "height": "148"
                        }
                    },
                    {
                        "code_url": "asdfasdf",
                        "code_info": {
                            "left": "398",
                            "top": "660",
                            "width": "148",
                            "height": "148"
                        }
                    },
                    {
                        "code_url": "asdf",
                        "code_info": {
                            "left": "74",
                            "top": "658",
                            "width": "146",
                            "height": "146"
                        }
                    }
                ]
            },
            "type": "image"
        }
    ],
    "version": "3.0",
    "charset": "UTF-8",
    "message": "SUCCESS",
    "status": "10000",
    "sign_type": "MD5",
    "sign": "7e4fa89e99e5afa4f8ccdb8ee9a9af86"
}
                            
参数名 描述 类型
uptime 广告图片接口下次更新间隔时间,单位秒 string
rand_num 返回的随机广告条数,实际返回的广告条数该参数为准 number
lists 记录列表,array()数组类型,对应key参数如下 array
lists.title 广告标题 string
lists.img_url 广告内容数据,array()数组类型 string
lists.type 广告类型:image 图片 video 视频 audio 音频 string
lists.img_url.bg 广告背景图片地址 string
lists.img_url.receipt_code 收款码设置数据内容,array()数组类型 object
lists.img_url.receipt_code.isShowQrcode 是否显示收款码 number
lists.img_url.receipt_code.qrcode_info 收款码位置 left|top|width|height string
lists.img_url.code 推广码数据,array()数组类型 array
lists.img_url.code.code_url 推广码地址 string
lists.img_url.code.code_info 推广码位置 left|top|width|height string
message 错误信息 string
version 接口版本号,3.0 number
charset 接口字符编码,UTF-8 string
status 错误状态 number
sign_type 签名方式,MD5 string
sign 签名字符串,参照签名方法 string

获取系统消息

在线测试 在线浏览

请求方式:POST

请求地址:http://zhaoyin.lfwin.com/bsapi/merchant/mer_notice

Body参数名 类型 必需 描述 示例 e.g.
service string 接口名称 mer.notice
apikey string 商家APIKEY,唯一标识,由服务商提供 00014005
nonce_str string 随机字符串,长度不超过32位
sign string 签名,参照签名算法
nid string 系统消息id
page_no string 第几页,默认第1页
page_size string 每页条数,默认20条,最大200条

返回示例:

                                {
    "total_items": "13",
    "page_size": "2",
    "current_no": "1",
    "total_no": "7",
    "lists": [
        {
            "nid": "257",
            "title": "0427更新日志",
            "pubtime": "1524914125",
            "cont": "1. 团购订单备注bug修复\r\n2. 餐饮订单有规格的订单品名bug修复\r\n3. 点餐/外卖订单新增退款提醒和退款详情查看\r\n4. 新增客服联系方式\r\n5. 新增COM智能识别截取金额"
        },
        {
            "nid": "242",
            "title": "0208更新日志",
            "pubtime": "1518061043",
            "cont": "\r\n\t新增功能\r\n\r\n\r\n\t1. 结算提醒优化\r\n2. 新增通知推送,代理商可以发送通知到下属商户的终端\r\n3. 代购订单优化调整\r\n4. 修改收款key时清除本地流水数据\r\n"
        }
    ],
    "version": "3.0",
    "charset": "UTF-8",
    "message": "SUCCESS",
    "status": "10000",
    "sign_type": "MD5",
    "sign": "803f0b1f98c1123601052a866a9147bc"
}
                            
参数名 描述 类型
total_items 总记录数 number
page_size 每页记录数 number
current_no 当前页码 number
total_no 总页码数目 number
lists 记录列表,array()数组类型,对应key参数如下 array
lists.nid 消息id number
lists.title 消息标题 string
lists.pubtime 消息发送时间 number
lists.cont 消息内容 string
version 接口版本号,3.0 number
charset 接口字符编码,UTF-8 string
message 错误信息 string
status 错误状态 number
sign_type 签名方式,MD5 string
sign 签名字符串,参照签名方法 string

单品优惠券

在线测试 在线浏览

请求方式:POST

请求地址:http://zhaoyin.lfwin.com/bsapi/merchant/sin_coupon

Body参数名 类型 必需 描述 示例 e.g.
service string 接口名称 sin.coupon
apikey string 商家APIKEY,唯一标识,由服务商提供 00014005
nonce_str string 随机字符串,长度不超过32位
sign string 签名,参照签名算法
page_no string 第几页,默认第1页
page_size string 每页条数,默认20条,最大200条
goods_id string 商品国标码,多个单品逗号分隔,口碑或微信单品优惠所需,可选
goods_type string 商品优惠券类别,0-所有(默认),1-微信, 2-支付宝 1

详细说明:

单品优惠券列表,用于微信或者支付宝单品优惠活动传参

返回示例:

                                {
    "total_items": "2",
    "page_size": "2",
    "current_no": "1",
    "total_no": "1",
    "lists": [
        {
            "cid": "30",
            "goods_name": "纸巾抽纸",
            "goods_tag": "纸巾抽纸",
            "price": "2.00",
            "goods_type": "1",
            "goods_id": "6922266445033",
            "regtime": "1540193581"
        },
        {
            "cid": "30",
            "goods_name": "棒棒糖",
            "goods_tag": "糖",
            "price": "1.00",
            "goods_type": "1",
            "goods_id": "6911316800588",
            "regtime": "1540193704"
        }
    ],
    "version": "3.0",
    "charset": "UTF-8",
    "message": "SUCCESS",
    "status": "10000",
    "sign_type": "MD5",
    "sign": "1e0ba0520041b1bc145ee90b835f34cc"
}
                            
参数名 描述 类型
total_items 总记录数 number
page_size 每页记录数 number
current_no 当前页码 number
total_no 总页码数目 number
version 接口版本号,3.0 number
charset 接口字符编码,UTF-8 string
message 错误信息 string
status 错误状态 number
sign_type 签名方式,MD5 string
sign 签名字符串,参照签名方法 string
lists 记录列表,array()数组类型,对应key参数如下 array
lists.goods_name 单品优惠券商品名称 string
lists.goods_id 单品优惠券商品国标码 string
lists.price 单品优惠券商品单品单价 number
lists.cid 单品优惠券所属商户id number
lists.goods_type 单品优惠券商品类别,0-所有(默认),1-微信, 2-支付宝 string
lists.regtime 单品优惠券添加时间 number
lists.goods_tag 微信单品优惠券优惠标记 string

设备SN获取商户参数

在线测试 在线浏览

请求方式:POST

请求地址:http://zhaoyin.lfwin.com/payapi/trans/sn?test=1

Body参数名 类型 必需 描述 示例 e.g.
type string 机具型号,联系技术约定机具型号枚举值 air10
sn string 机具编号,联系客服绑定机具sn编码 10000
sign string 机具签名,联系技术约定机具型号签名所需参数
nonce_str string 随机字符串,长度不超过32位 123456

详细说明:

sign 签名说明

联系技术约定机具型号签名所需参数,比如约定 type=sl58 的签名参数 是  signkey=123456 ,signkey 并不等于商户加密秘钥;
那么sign =      md5(nonce_str=123456&sn=SN0000002&type=sl58&signkey=123456)  32位小写md5加密字符串
最后
sign=3696697ae25973e0c0eb49180dc5dd3f

请求的post即为
{
    "type": "sl58",
    "sn": "SN0000002",
    "sign": "3696697ae25973e0c0eb49180dc5dd3f",
}

支付宝刷脸设备zoloz请求返回会有配置参数
  • "terminal_id": "TEST_ZOLOZ_test",

矩亿air10台牌设备请求返回会有配置参数
返回示例: 添加了"_"分割参数的通道类型,方便其他编程语言解析,后期可能会考虑取消 "."分割的参数名

返回示例:

                                {
    "apikey": "00014005",
    "signkey": "punr8ucu",
    "nickname": "微赢家",
    "sn": "97061646271924",
    "type": "q2000",
    "pay.alipay": "0",
    "pay.wxpay": "0",
    "mybank.alipay": "1",
    "mybank.wxpay": "1",
    "fuiou.alipay": "0",
    "fuiou.wxpay": "0",
    "heli.alipay": "0",
    "heli.wxpay": "0",
    "pay.bdpay": "1",
    "pay.best": "1",
    "pay_alipay": "0",
    "pay_wxpay": "0",
    "mybank_alipay": "1",
    "mybank_wxpay": "1",
    "fuiou_alipay": "0",
    "fuiou_wxpay": "0",
    "pay_bdpay": "1",
    "pay_best": "1",
    "heli_wxpay": "0",
    "heli_alipay": "0",
    "version": "3.0",
    "charset": "UTF-8",
    "message": "SUCCESS",
    "status": "10000",
    "sign_type": "MD5",
    "sign": "3dd0f51f5c9809ed196f80bd4abe8464"
}
                            
参数名 描述 类型
apikey 商家APIKEY,唯一标识,由服务商提供 number
signkey 商户加密秘钥,由服务商提供 string
nickname 商家打印名称(昵称) string
sn 设备编号,联系客服绑定设备sn编码 string
type 机具型号,联系技术约定机具型号枚举值 string
pay.alipay 官方支付宝通道:1 表示打开 0关闭 number
pay.wxpay 官方微信通道:1 表示打开 0关闭 number
mybank.alipay 网商支付宝通道:1 表示打开 0关闭 number
mybank.wxpay 网商微信通道:1 表示打开 0关闭 number
fuiou.alipay 银行支付宝通道:1 表示打开 0关闭 number
fuiou.wxpay 银行微信通道:1 表示打开 0关闭 number
pay.bdpay 百度钱包通道:1 表示打开 0关闭 number
pay.best 天翼支付通道:1 表示打开 0关闭 string
version 接口版本号,3.0 number
charset 接口字符编码,UTF-8 string
message 错误信息 string
status 错误状态 number
sign_type 签名方式,MD5 string
sign 签名字符串,参照签名方法 string
heli.alipay 间联支付宝通道:1 表示打开 0关闭 string
heli.wxpay 间联微信通道:1 表示打开 0关闭 string
machine_num 收银机编号(仅zoloz设备返回) string
cashier_num 收银员编号(仅zoloz设备返回) string
erp_server ERP服务地址(仅zoloz设备返回) string
pay_server 支付服务地址(仅zoloz设备返回) string
terminal_id 设备终端号(仅zoloz设备返回) string
api_server 接口域名(仅矩亿air10设备返回) string

店员列表

在线测试 在线浏览

请求方式:POST

请求地址:http://zhaoyin.lfwin.com/bsapi/merchant/mer_staff?test=1

Body参数名 类型 必需 描述 示例 e.g.
service string 接口名称 mer.staff
apikey string 商家APIKEY,唯一标识,由服务商提供 00014005
nonce_str string 随机字符串,长度不超过32位 123456
sign string 签名,参照签名算法
mid string 店员ID
page_no string 第几页,默认第1页
page_size string 每页条数,默认20条,最大200条

返回示例:

                                {
    "total_items": "1",
    "page_size": "20",
    "current_no": "1",
    "total_no": "1",
    "lists": [
        {
            "mid": "881",
            "username": "wyjdz",
            "truename": "微赢家店长wyjdz"
        }
    ],
    "version": "3.0",
    "charset": "UTF-8",
    "message": "SUCCESS",
    "status": "10000",
    "sign_type": "MD5",
    "sign": "1d3920e781820152527656394fba96c0"
}
                            
参数名 描述 类型
total_items 总记录数 number
page_size 每页记录数 number
current_no 当前页码 number
total_no 总页码数目 number
lists 记录列表,array()数组类型,对应key参数如下 array
lists.mid 店员ID number
lists.username 店员登录名 string
lists.truename 店员姓名 string
version 接口版本号,3.0 number
charset 接口字符编码,UTF-8 string
message 错误信息 string
status 错误状态 number
sign_type 签名方式,MD5 string
sign 签名字符串,参照签名方法 string

设备列表

在线测试 在线浏览

请求方式:POST

请求地址:http://zhaoyin.lfwin.com/bsapi/merchant/mer_device?test=1

Body参数名 类型 必需 描述 示例 e.g.
service string 接口名称 mer.device
apikey string 商家APIKEY,唯一标识,由服务商提供 00014005
nonce_str string 随机字符串,长度不超过32位 123456
sign string 签名,参照签名算法
cdid string 设备ID
page_size string 第几页,默认第1页
page_no string 每页条数,默认20条,最大200条

返回示例:

                                {
    "total_items": "2",
    "page_size": "20",
    "current_no": "1",
    "total_no": "1",
    "lists": [
        {
            "cdid": "700",
            "devicename": "测试专用"
        },
        {
            "cdid": "701",
            "devicename": "测试专用2"
        }
    ],
    "version": "3.0",
    "charset": "UTF-8",
    "message": "SUCCESS",
    "status": "10000",
    "sign_type": "MD5",
    "sign": "f37912d29a41b41a2f1db6b1064b294a"
}
                            
参数名 描述 类型
total_items 总记录数 number
page_size 每页记录数 number
current_no 当前页码 number
total_no 总页码数目 number
lists 记录列表,array()数组类型,对应key参数如下 array
lists.cdid 设备ID number
lists.devicename 设备名称 string
version 接口版本号,3.0 number
charset 接口字符编码,UTF-8 string
message 错误信息 string
status 错误状态 number
sign_type 签名方式,MD5 string
sign 签名字符串,参照签名方法 string

汇总查询

在线测试 在线浏览

请求方式:POST

请求地址:http://zhaoyin.lfwin.com/bsapi/merchant/mer_gather

Body参数名 类型 必需 描述 示例 e.g.
service string 接口名称 mer.gather
apikey string 商家APIKEY,唯一标识,由服务商提供 00014005
nonce_str string 随机字符串,长度不超过32位 123456
sign string 签名,参照签名算法
order_time_s string 下单开始时间,时间戳,精确到秒 ,不支持时间跨月
order_time_e string 下单结束时间,时间戳,精确到秒 ,不支持时间跨月
mid string 登录的收款店员id
union_pay string 是否返回银联订单汇总:1是 0否(默认)

详细说明:

下单开始时间order_time_s 跟下单结束时间 order_time_e必须在同一个月的时间戳范围内

返回示例:

                                {
    "alipay": {
        "succ_count": "5",
        "ref_count": "3",
        "succ_money": "0.05",
        "pri_money": "0.02",
        "ref_money": "0.03"
    },
    "wxpay": {
        "succ_count": "8",
        "ref_count": "4",
        "succ_money": "0.08",
        "pri_money": "0.04",
        "ref_money": "0.04"
    },
    "bdpay": {
        "succ_count": "0",
        "ref_count": "0",
        "succ_money": "0",
        "pri_money": "0",
        "ref_money": "0"
    },
    "cashpay": {
        "succ_count": "0",
        "ref_count": "0",
        "succ_money": "0",
        "pri_money": "0",
        "ref_money": "0"
    },
    "best": {
        "succ_count": "0",
        "ref_count": "0",
        "succ_money": "0",
        "pri_money": "0",
        "ref_money": "0"
    },
    "version": "3.0",
    "charset": "UTF-8",
    "message": "SUCCESS",
    "status": "10000",
    "sign_type": "MD5",
    "sign": "2595d62366e71154a52f2b26ac25b09e"
}
                            
参数名 描述 类型
alipay 支付宝收款信息 object
alipay.succ_count 支付宝 - 成功笔数 number
alipay.ref_count 支付宝 - 退款笔数 number
alipay.succ_money 支付宝 - 收款金额,单位元 number
alipay.pri_money 支付宝 - 实收金额,单位元 number
alipay.ref_money 支付宝 - 退款金额,单位元 number
wxpay 微信收款信息 object
wxpay.succ_count 微信 - 成功笔数 number
wxpay.ref_count 微信 - 退款笔数 number
wxpay.succ_money 微信 - 收款金额,单位元 number
wxpay.pri_money 微信 - 实收金额,单位元 number
wxpay.ref_money 微信 - 退款金额,单位元 number
bdpay 百度收款信息 object
bdpay.succ_count 百度 - 成功笔数 number
bdpay.ref_count 百度 - 退款笔数 number
bdpay.succ_money 百度 - 收款金额,单位元 number
bdpay.pri_money 百度 - 实收金额,单位元 number
bdpay.ref_money 百度 - 退款金额,单位元 number
cashpay 现金收款信息 object
cashpay.succ_count 现金 - 成功笔数 number
cashpay.ref_count 现金 - 退款笔数 number
cashpay.succ_money 现金 - 收款金额,单位元 number
cashpay.pri_money 现金 - 实收金额,单位元 number
cashpay.ref_money 现金 - 退款金额,单位元 number
best 翼支付收款信息 string
best.succ_count 翼支付- 成功笔数 string
best.ref_count 翼支付 - 退款笔数 string
best.succ_money 翼支付- 收款金额,单位元 string
best.pri_money 翼支付 - 实收金额,单位元 string
best.ref_money 翼支付 - 退款金额,单位元 string
version 接口版本号,3.0 number
charset 接口字符编码,UTF-8 string
message 错误信息 string
status 错误状态 number
sign_type 签名方式,MD5 string
sign 签名字符串,参照签名方法 string
sunmi 商米订单汇总 ,数组结构,当union_pay=1 才返回,结构类似wxpay string
mispos 欧米工行订单汇总 ,数组结构,当union_pay=1 才返回,结构类似wxpay string
boxpay 盒子订单汇总 ,数组结构,当union_pay=1 才返回,结构类似wxpay string

商户意见反馈

在线测试 在线浏览

请求方式:POST

请求地址:http://zhaoyin.lfwin.com/bsapi/merchant/mer_faq

Body参数名 类型 必需 描述 示例 e.g.
service string 接口名称 mer.faq
apikey string 商家APIKEY,唯一标识,由服务商提供
nonce_str string 随机字符串,长度不超过32位
sign string 签名,参照签名算法
cont string 意见反馈内容
type string 反馈类型: 1-酷收银 2-C端 3-广告台牌
tel string 联系方式,手机号
cont_img string 反馈问题截图,参照图片上传返回picurl参数

返回示例:

                                {
    "shopname": "微赢家灵风分店",
    "cont": "111",
    "tel": "18305999248",
    "imgs": "",
    "type": "2",
    "addtime": "1520594400",
    "version": "3.0",
    "charset": "UTF-8",
    "message": "SUCCESS",
    "status": "10000",
    "sign_type": "MD5",
    "sign": "e545b9940d1bef3230ae5725a4d7e06d"
}
                            
参数名 描述 类型
cont 意见反馈内容 number
tel 联系方式,手机号 number
cont_img 反馈问题截图,参照图片上传返回picurl参数 string
type 反馈类型: 1-酷收银 2-C端 number
addtime 反馈时间。时间戳,精确到秒 number
version 接口版本号,3.0 number
charset 接口字符编码,UTF-8 string
message 错误信息 string
status 错误状态 number
sign_type 签名方式,MD5 string
sign 签名字符串,参照签名方法 string

波普结算接口

在线测试 在线浏览

请求方式:POST

请求地址:http://zhaoyin.lfwin.com/bsapi/merchant/mer_account?test=1

Body参数名 类型 必需 描述 示例 e.g.
service string 接口名称 mer.account
apikey string 商家APIKEY,唯一标识,由服务商提供 00014005
nonce_str string 随机字符串,长度不超过32位
sign string 签名,参照签名算法
order_time_s string 下单开始时间,时间戳,精确到秒 ,不支持时间跨月
order_time_e string 下单结束时间,时间戳,精确到秒 ,不支持时间跨月
mid string 登录的收款店员id
union_pay string 是否返回银联订单汇总:1是 0否(默认)

详细说明:

下单开始时间order_time_s 跟下单结束时间 order_time_e必须在同一个月的时间戳范围内

返回示例:

                                {
    "all_count": "86",
    "can_count": "0",
    "ref_count": "31",
    "ref_money": "3.29",
    "pay_money": "44.99",
    "pri_money": "43.64",
    "rec_money": "0.47",
    "cou_money": "3.06",
    "version": "3.0",
    "charset": "UTF-8",
    "message": "SUCCESS",
    "status": "10000",
    "sign_type": "MD5",
    "sign": "90a3f027f8773533f492c14f22fc8fc9"
}
                            
参数名 描述 类型
all_count 支付完成订单总数 number
can_count 撤销订单总数 number
ref_count 退款订单总数 number
pay_money 下单金额总计,单位元 number
pri_money 扣除商家优惠后实收金额总计,单位元 number
rec_money 商户支付宝优惠券后实收金额总计,单位元 number
cou_money 官方优惠金额总计,单位元 number
ref_money 退款金额总计,单位元 number
version 接口版本号,3.0 number
charset 接口字符编码,UTF-8 string
message 错误信息 string
status 错误状态 number
sign_type 签名方式,MD5 string
sign 签名字符串,参照签名方法 string

商户授权支付

在线测试 在线浏览

请求方式:POST

请求地址:http://zhaoyin.lfwin.com/bsapi/merchant/mer_auth

Body参数名 类型 必需 描述 示例 e.g.
service string 接口名称 mer.auth
apikey string 商家APIKEY,唯一标识,由服务商提供 00014005
nonce_str string 随机字符串,长度不超过32位 123456
sign string 签名,参照签名算法
username string 代理登录账号
pwd string 代理登录密码
sub_mch_id string 微信子商户号,官方通道配置(微信官方支付配置参数)

详细说明:

1、微信官方支付授权通过上传sub_mch_id 参数授权配置;
2、支付宝官方支付通过支付授权链接(支付宝官方支付配置授权),请求登录支付宝并授权(要求商户开通当面付功能)
3、点击前往支付授权链接,授权成功后页面输出授权成功字段例如:
{
     "user_id": "2088xxxxxxx",
    "auth_time": "1517294326",
    "apikey": "00014005",
    "version": "3.0",
    "charset": "UTF-8",
    "message": "SUCCESS",
    "status": "10000",
    "sign_type": "MD5",
    "sign": "b7990367c85a9c75879efbdff6e78883"
}
失败输出
{"version":"3.0","charset":"UTF-8","sign_type":"MD5","status":3010,"message":"\u8bf7\u6c42\u53c2\u6570\u9519\u8bef"}

返回示例:

                                {
    "sub_mch_id": "",
    "ali_auth_url": "https://openauth.alipay.com/oauth2/appToAppAuth.htm?app_id=2016010401063353&redirect_uri=http%3A%2F%2Fdaili.lfwin.com%2FHome%2FAliAuth%2FtoAuth%3Fdata%3DMTFkZFRieVlRT1pVVVZjQVdUWEVSbzlzRy9HTU9DRSswRWpKOHNsODJPaXExSFRNL3RZQlc3SWlraGNPcVVlKzBzdEx5UnhKY0JsMHhHV1pMVlU1Y0pKOXcxbmh2UngrYk9uUTUxMm90Z3kwSE9HNmdmRmJ3TnlE",
    "auth_time": "1517294326",
    "apikey": "00014005",
    "version": "3.0",
    "charset": "UTF-8",
    "message": "SUCCESS",
    "status": "10000",
    "sign_type": "MD5",
    "sign": "b7990367c85a9c75879efbdff6e78883"
}
                            
参数名 描述 类型
sub_mch_id 微信子商户号,官方通道配置(微信官方支付配置参数) string
ali_auth_url 支付授权链接(支付宝官方支付配置授权) string
auth_time 请求授权时间,单位秒,时间戳 number
apikey 商家APIKEY,唯一标识,由服务商提供 number
version 接口版本号,3.0 number
charset 接口字符编码,UTF-8 string
message 错误信息 string
status 错误状态 number
sign_type 签名方式,MD5 string
sign 签名字符串,参照签名方法 string

APIKEY缓存更新

在线测试 在线浏览

请求方式:POST

请求地址:http://zhaoyin.lfwin.com/bsapi/merchant/mer_apikey?test=1

Body参数名 类型 必需 描述 示例 e.g.
service string 接口名称 mer.apikey
apikey string 商家APIKEY,唯一标识,由服务商提供 00014005
nonce_str string 随机字符串,长度不超过32位 123456
sign string 签名,参照签名算法

详细说明:

接口说明:
商家APIKEY,唯一标识,由服务商提供,并且具有缓存商家信息,缓存时间大致一周 , 
正常情况下缓存会随着商家信息更改做更新,如果商家信息执行更改,缓存并没有更新,
需要手动更新 apikey缓存商家信息,则调用该接口

返回示例: 添加了"_"分割参数的通道类型,方便其他编程语言解析,后期可能会考虑取消 "."分割的参数名

返回示例:

                                {
    "apikey": "00014005",
    "company": "汕头市微赢家信息科技有限公司",
    "nickname": "微赢家",
    "shopname": "微赢家灵风分店",
    "devicename": "测试专用",
    "pay.alipay": "0",
    "pay.wxpay": "0",
    "mybank.alipay": "1",
    "mybank.wxpay": "1",
    "fuiou.alipay": "0",
    "fuiou.wxpay": "0",
    "heli.alipay": "0",
    "heli.wxpay": "0",
    "pay.bdpay": "1",
    "pay.best": "1",
    "pay_alipay": "0",
    "pay_wxpay": "0",
    "mybank_alipay": "1",
    "mybank_wxpay": "1",
    "fuiou_alipay": "0",
    "fuiou_wxpay": "0",
    "pay_bdpay": "1",
    "pay_best": "1",
    "heli_wxpay": "0",
    "heli_alipay": "0",
    "version": "3.0",
    "charset": "UTF-8",
    "message": "SUCCESS",
    "status": "10000",
    "sign_type": "MD5",
    "sign": "140c20614458ad2e56771dbffd210c8c"
}
                            
参数名 描述 类型
apikey 商家APIKEY,唯一标识,由服务商提供 number
company 商家公司名称 string
nickname 商家打印名称(昵称) string
shopname 商家店铺名称 string
pay.alipay 官方支付宝通道:1 表示打开 0关闭 string
pay.wxpay 官方微信通道:1 表示打开 0关闭 number
mybank.alipay 网商支付宝通道:1 表示打开 0关闭 number
mybank.wxpay 网商微信通道:1 表示打开 0关闭 number
fuiou.alipay 银行支付宝通道:1 表示打开 0关闭 string
fuiou.wxpay 银行微信通道:1 表示打开 0关闭 number
pay.bdpay 百度钱包通道:1 表示打开 0关闭 string
pay.best 天翼支付通道:1 表示打开 0关闭 string
version 接口版本号,3.0 number
charset 接口字符编码,UTF-8 string
message 错误信息 string
status 错误状态 number
sign_type 签名方式,MD5 string
sign 签名字符串,参照签名方法 string
devicename 商家设备名称 string
heli.alipay 间联1支付宝通道:1 表示打开 0关闭 string
heli.wxpay 间联1微信通道:1 表示打开 0关闭 string
is_high_precision 是否使用高精度识别: 0 否 1 是 string

店员登录

在线测试 在线浏览

请求方式:POST

请求地址:http://zhaoyin.lfwin.com/bsapi/merchant/staff_login?test=1

Body参数名 类型 必需 描述 示例 e.g.
service string 接口名称 staff.login
apikey string 商家APIKEY,唯一标识,由服务商提供 00014005
nonce_str string 随机字符串,长度不超过32位 123456
sign string 签名,参照签名算法
username string 店员登录用户名 litsen
pwd string 店员登录密码(原密码) 123456
new_pwd string 店员登录新密码。如果传入该值,并且该值跟原密码不一致,则将店员密码修改该值

详细说明:

rule_id字段(拥有权限id)说明:

  • 1  移动收款
  • 2  流水列表查看
  • 3  订单退款
  • 4  订单撤销
  • 5  结算
  • 6  卡券营销
  • 7  在线订单
  • 8  会员列表查看
  • 9  会员注册
  • 10 记录查询
  • 11 会员消费
  • 12 会员充值
  • 13 会员积分授予
  • 14 会员积分核销
  • 15 会员卡券发放
  • 16 签到验证
  • 17 修改商家key
  • 18 修改终端key
  • 19 参数设置
  • 30 会员详情查看
  • 31 汇总查询


返回示例:

                                {
    "mid": "881",
    "username": "wyjdz",
    "truename": "微赢家店长wyjdz",
    "phone": "",
    "job": "2",
    "rule_name": "店长权限",
    "rule_id": "1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,30",
    "shopname": "微赢家灵风分店",
    "company": "汕头市微赢家信息科技有限公司",
    "nickname": "微赢家",
    "version": "3.0",
    "charset": "UTF-8",
    "message": "SUCCESS",
    "status": "10000",
    "sign_type": "MD5",
    "sign": "2c362eca61ec0af2f8a9950022855db9"
}
                            
参数名 描述 类型
mid 登录的收款店员id string
username 店员登录用户名 string
truename 店员姓名 string
phone 店员电话 string
job 店员类别: 1普通店员 ; 2店长 number
rule_name 权限角色名称 string
rule_id 拥有的权限id,多个权限英文逗号分隔,权限注释参照详细说明里面 string
shopname 店铺名称 string
company 商家名称 string
nickname 商家打印名称 string
version 接口版本号,3.0 number
charset 接口字符编码,UTF-8 string
message 错误信息 string
status 错误状态 number
sign_type 签名方式,MD5 string
sign 签名字符串,参照签名方法 string
is_cash 是否支持现金收款: 1 是 0 否 string
is_cross_device 是否允许跨终端退款: 1 是 0 否 string
exp_url 商家推广二维码 string

商户支付渠道

在线测试 在线浏览

请求方式:POST

请求地址:http://zhaoyin.lfwin.com/bsapi/merchant/mer_service?test=1

Body参数名 类型 必需 描述 示例 e.g.
service string 接口名称 mer.service
apikey string 商家APIKEY,唯一标识,由服务商提供 00014005
nonce_str string 随机字符串,长度不超过32位 123456
sign string 签名,参照签名算法 e9828aedd9227e37855bcede3af8657b

详细说明:

返回示例: 添加了"_"分割参数的通道类型,方便其他编程语言解析
支付渠道 跟 支付service存在一定规律
比如支付渠道 mybank.alipay=1 那么接口就能用   mybank.alipay.qrcode 、 mybank.alipay.barcode 等等 支付渠道
其他类似,可以开发成可自动识别支付渠道


返回示例:

                                {
    "pay.alipay": "0",
    "pay.wxpay": "0",
    "mybank.alipay": "1",
    "mybank.wxpay": "1",
    "fuiou.alipay": "0",
    "fuiou.wxpay": "0",
    "pay.bdpay": "1",
    "pay.best": "1",
    "heli.alipay": "0",
    "heli.wxpay": "0",
    "company": "汕头市微赢家信息科技有限公司",
    "nickname": "微赢家",
    "shopname": "微赢家灵风分店",
    "devicename": "测试专用",
    "alipay_store_id": "2017022100077000000026757221",
    "apikey": "00014005",
    "pay_alipay": "0",
    "pay_wxpay": "0",
    "mybank_alipay": "1",
    "mybank_wxpay": "1",
    "fuiou_alipay": "0",
    "fuiou_wxpay": "0",
    "heli_wxpay": "0",
    "heli_alipay": "0",
    "pay_bdpay": "1",
    "pay_best": "1",
    "version": "3.0",
    "charset": "UTF-8",
    "message": "SUCCESS",
    "status": "10000",
    "sign_type": "MD5",
    "sign": "5bb118cf62050f8491f198986ca8625a"
}
                            
参数名 描述 类型
pay.alipay 官方支付宝通道:1 表示打开 0关闭 number
pay.wxpay 官方微信通道:1 表示打开 0关闭 number
mybank.alipay 网商支付宝通道:1 表示打开 0关闭 number
mybank.wxpay 网商微信通道:1 表示打开 0关闭 number
fuiou.alipay 银行支付宝通道:1 表示打开 0关闭 number
fuiou.wxpay 银行微信通道:1 表示打开 0关闭 number
pay.bdpay 百度钱包通道:1 表示打开 0关闭 string
pay.best 天翼支付通道:1 表示打开 0关闭 string
version 接口版本号,3.0 number
charset 接口字符编码,UTF-8 string
message 错误信息 string
status 错误状态 number
sign_type 签名方式,MD5 string
sign 签名字符串,参照签名方法 string
company 商家公司名称 string
nickname 商家打印名称(昵称) string
shopname 商家店铺名称 string
alipay_store_id 商家绑定口碑门店id string
apikey 商家APIKEY,唯一标识,由服务商提供 string
devicename 商家设备名称 string
heli.alipay 间联1支付宝通道:1 表示打开 0关闭 string
heli.wxpay 间联1微信通道:1 表示打开 0关闭 string
is_high_precision 是否使用高精度识别: 0 否 1 是 string

商家优惠活动

在线测试 在线浏览

请求方式:POST

请求地址:http://zhaoyin.lfwin.com/bsapi/merchant/mer_discount

Body参数名 类型 必需 描述 示例 e.g.
service string 接口名称 mer.discount
apikey string 商家APIKEY,唯一标识,由服务商提供 00014005
nonce_str string 随机字符串,长度不超过32位 123456
sign string 签名,参照签名算法 c03d2f8f034eb8f5d6466fbd2d126735
page_no string 第几页,默认第1页 1
page_size string 每页条数,默认20条,最大200条 2
time_s string 活动开始时间,时间戳
time_e string 活动结束时间,时间戳

详细说明:


返回示例:

                                {
    "total_items": "10",
    "page_size": "2",
    "current_no": "1",
    "total_no": "5",
    "lists": [
        {
            "dis_name": "优惠8.8折",
            "dis_type": "3",
            "dis_minus": "0.00",
            "dis_count": "8.8",
            "dis_des": "",
            "dis_pay_money": "0.10",
            "dis_max_money": "0.09",
            "dis_min_money": "0.01",
            "dis_stime": "1467129600",
            "dis_etime": "1468684800",
            "dis_way": "0"
        },
        {
            "dis_name": "测试实收金额",
            "dis_type": "1",
            "dis_minus": "0.01",
            "dis_count": "",
            "dis_des": "",
            "dis_pay_money": "0.00",
            "dis_max_money": "0.00",
            "dis_min_money": "0.00",
            "dis_stime": "1470712180",
            "dis_etime": "1471057784",
            "dis_way": "0"
        }
    ],
    "version": "3.0",
    "charset": "UTF-8",
    "message": "SUCCESS",
    "status": "10000",
    "sign_type": "MD5",
    "sign": "3c2c0540e872e907d4d208848d075006"
}
                            
参数名 描述 类型
total_items 总记录数 number
page_size 每页记录数 number
current_no 当前页码 number
total_no 总页码数目 number
lists 记录列表,array()数组类型,对应key参数如下 array
lists.dis_name 商家打折活动名称 string
lists.dis_type 商家打折活动类型: 1 -固定立减 2-折扣优惠 3-随机立减 number
lists.dis_minus 固定立减金额,单位元,例如:0.01元 number
lists.dis_count 折扣值,列如9.5表示95折,数值范围在0-10之间 number
lists.dis_des 优惠活动说明信息 string
lists.dis_pay_money 参与打折活动,订单金额要求,单位元 number
lists.dis_max_money 最高立减优惠金额,单位元 number
lists.dis_min_money 最低立减优惠金额,单位元 number
lists.dis_stime 活动开始时间,时间戳,单位秒 number
lists.dis_etime 活动结束时间,时间戳,单位秒 number
lists.dis_way 参与活动通道 0-全部通道 1-支付宝 2-微信 number
version 接口版本号,3.0 number
charset 接口字符编码,UTF-8 string
message 错误信息 string
status 错误状态 number
sign_type 签名方式,MD5 string
sign 签名字符串,参照签名方法 string

商户入驻图片上传

在线测试 在线浏览

请求方式:POST

请求地址:http://zhaoyin.lfwin.com/bsapi/merchant/pic_upload

Body参数名 类型 必需 描述 示例 e.g.
service string 接口名称 pic.upload
apikey string 商家APIKEY,唯一标识,由服务商提供 00014005
nonce_str string 随机字符串,长度不超过32位 123456
sign string 签名,参照签名算法
username string 代理登录账号
pwd string 代理登录密码
picpath file 图片路径, 转换成文件流格式, 图片大小2M以内,jpg,png,gif三种格式

详细说明:

filepath文件流格式:
php实例:
        $pic_path="E:/Logo2.0.jpg";
$post["picpath"]=new CurlFile($pic_path);
$url='http://zhaoyin.lfwin.com/bsapi/merchant/pic_upload';    
$curl = curl_init();
        curl_setopt($curl, CURLOPT_URL, $url);
        curl_setopt($curl, CURLOPT_POST, 1 );
        curl_setopt($curl, CURLOPT_POSTFIELDS, $post);
        curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
        curl_setopt($curl,CURLOPT_USERAGENT,"Mozilla/4.0");  
        $return= curl_exec($curl);
java实例:
            CloseableHttpClient httpClient = HttpClients.createDefault();
            HttpPost httpPost = new HttpPost("http://zhaoyin.lfwin.com/bsapi/merchant/pic_upload");
            FileBody file = new FileBody(new File("E:\\Logo2.0.jpg"));
            StringBody comment = new StringBody("upload picture", ContentType.TEXT_PLAIN);
            HttpEntity reqEntity = MultipartEntityBuilder.create().addPart("picpath",file)
                    .addPart("comment",comment)
                    .addPart("service",new StringBody("pic.upload",ContentType.TEXT_PLAIN))
                   .addPart("apikey",new StringBody("00014005",ContentType.TEXT_PLAIN))    
                    ..........
                    .build();
            httpPost.setEntity(reqEntity);
            System.out.println("executing request " + httpPost.getRequestLine());
            CloseableHttpResponse response = httpClient.execute(httpPost);
C#实例:
        待补充



返回示例:

                                {
	"picurl": "http:\/\/images.lfwin.com\/lfwin\/images\/upload\/2018\/01\/31\/5e6cb9e1ebad53c7f3c7fd4e12331ebd.png",
	"picname": "ce2e6d8602a1dbe9675ebdd5bead35e0.png",
	"version": "3.0",
	"charset": "UTF-8",
	"message": "SUCCESS",
	"status": "10000",
	"sign_type": "MD5",
	"sign": "13e6b154569a00881880e4a293449446"
}
                            
参数名 描述 类型
picurl 云端服务器地址 string
picname 图片名称 string
version 接口版本号,3.0 number
charset 接口字符编码,UTF-8 string
message 错误信息 string
status 错误状态 number
sign_type 签名方式,MD5 string
sign 签名字符串,参照签名方法 string

商户入驻列表(待完成)

在线测试 在线浏览

请求方式:POST

请求地址:http://zhaoyin.lfwin.com/bsapi/merchant/mer_lists

商户入驻(待完成)

在线测试 在线浏览

请求方式:POST

请求地址:http://zhaoyin.lfwin.com/bsapi/merchant/mer_add?test=1

Body参数名 类型 必需 描述 示例 e.g.
service string 接口名称 mer.add
apikey string 商家APIKEY,唯一标识,由服务商提供
nonce_str string 随机字符串,长度不超过32位
username string 代理登录账号
pwd string 代理登录密码
sign string 签名,参照签名算法
contact_name string 联系人姓名
contact_phone string 联系人手机号
contact_email string 联系人常用邮箱
contact_addr string 联系人地址
contact_province_code string 联系人所在省,按照附录5.6国标省市区号录入
contact_city_code string 联系人所在市,按照附录5.6国标省市区号录入
contact_district_code string 联系人所在地区,按照附录5.6国标省市区号录入
license_type string 证件类型: 0-营业执照(非三证合一的旧营业执照); 1-三证合一;A-身份证; B-个体户;
company string 商家名称
short_name string 商家简称
license_address string 营业执照注册地址
license_no string 营业执照注册号,银行通道对私填写法人身份证号
license_range string 营业执照经营范围
license_img string 营业执照影印件,参照图片上传返回picurl参数
license_expire_dt string 证件到期日,时间戳,精确到秒
organization_no string 组织结构号码
organization_cert string 组织结构影印件,参照图片上传返回picurl参数
legal_name string 法人姓名
legal_cert string 法人身份证号码
identity_img string 法人身份证影印件,参照图片上传返回picurl参数
identity_img_back string 法人身份证影印件反面,参照图片上传返回picurl参数
certif_id_expire_dt string 法人身份证件到期日,时间戳,精确到秒
tel string 客服电话,5至15位纯数字。推荐400开头电话或11位有效手机号
business string 经营类目,参照附录
merchant_type string 商户类型 01:自然人 ;02:个体工商户; 03:企业商户;
bank_name string 开户银行名称
bank_branch string 开户银行支行
bank_truename string 银行开户人姓名
bank_account string 银行开户账号
contact_line string 开户银行联行号,参照附录
bank_province_code string 开户银行所在省,按照附录5.6国标省市区号录入
bank_city_code string 开户银行所在市,按照附录5.6国标省市区号录入
card_no string 开户银行持卡人证件号码
card_holder_address string 开户银行持卡人地址
acnt_type string 开户银行卡类型:1:对公;2:对私
acnt_artif_flag string 开户银行入账标识:0:非法人入账, 1:法人入账
bank_cert string 对公账户影印件/持卡人身份证,参照图片上传返回picurl参数
un_identity_img string 非法人身份证正面,参照图片上传返回picurl参数
un_identity_img_back string 非法人身份证背面,参照图片上传返回picurl参数
prove_img string 关系证明,参照图片上传返回picurl参数
open_img string 开户许可证,参照图片上传返回picurl参数
hand_identity_img string 手持身份证照,参照图片上传返回picurl参数
taxation_img string 税务登记证,参照图片上传返回picurl参数
shop_img string 门店招牌照,参照图片上传返回picurl参数
ndoor_scene string 门店内景照,参照图片上传返回picurl参数
cashier_img string 门店收银照,参照图片上传返回picurl参数
partner_type string 公众号相关信息:01:商户自有公众号; 03:商户没有公众号
wx_account string 联系人微信账号,网商通道申请结果会发送至该微信号通知确认
wx_appid string 微信公众号appid,填写的公众号其认证主体需与商户号经营主体一致,且需为服务号 且通过微信认证
wx_id string 微信服务号原始ID
web_url string 公司网站网址
channel string 报建渠道: 1=官方微信 3=银行通道 4=网商通道。多个用英文,逗号分隔 1,3,4

返回示例:

                                {
    "num": "MA2018031610000000",
    "result_code": "",
    "result_msg": "",
    "result_info": [
        {
            "channel": "1",
            "status": "0"
        }
    ],
    "version": "3.0",
    "charset": "UTF-8",
    "message": "SUCCESS",
    "status": "10000",
    "sign_type": "MD5",
    "sign": "ec7dc5b9a97fc084db2caecfc2dfde61"
}
                            

商户入驻结果查询(待完成)

在线测试 在线浏览

请求方式:POST

请求地址:http://zhaoyin.lfwin.com/bsapi/merchant/mer_query

商户入驻编辑(待完成)

在线测试 在线浏览

请求方式:POST

请求地址:http://zhaoyin.lfwin.com/bsapi/merchant/mer_upd

其他支付

现金订单列表

在线测试 在线浏览

请求方式:POST

请求地址:http://zhaoyin.lfwin.com/payapi/cash/order_list?test=1

Body参数名 类型 必需 描述 示例 e.g.
service string 接口名称 order.list
apikey string 商家APIKEY,唯一标识,由服务商提供 00014005
nonce_str string 随机字符串,长度不超过32位 123456
sign string 签名,参照签名算法 09b926011f6316b3614cf53dd76f51ec
orderid string 系统订单号,唯一值
order_time_s string 下单开始时间,时间戳,精确到秒
order_time_e string 下单结束时间,时间戳,精确到秒
page_no string 第几页,默认第1页
page_size string 每页条数,默认20条,最大200条
mch_orderid string 商户订单号,如果orderid跟mch_orderid同时存在,以orderid为准
order_time string 下单时间,时间戳,精确到秒,如果只传商户订单号,必须传下单时间
is_refund string 标识:2退款 1撤销 0普通订单(默认)

返回示例:

                                {
    "total_items": "3",
    "page_size": "2",
    "current_no": "1",
    "total_no": "2",
    "lists": [
        {
            "orderid": "201806141509170070078812",
            "paymoney": "0.02",
            "pri_paymoney": "0.02",
            "paystatus": "1",
            "paytime": "1528960157",
            "order_time": "0",
            "mch_orderid": "",
            "is_refund": "0",
            "company": "汕头市微赢家信息科技有限公司",
            "nickname": "微赢家",
            "shopname": "微赢家灵风分店",
            "remarks": "",
            "refundmoney": "0.00",
            "mid": "881",
            "cdid": "700",
            "m_paytype": "cash"
        },
        {
            "orderid": "201806141509350070082975",
            "paymoney": "0.02",
            "pri_paymoney": "0.02",
            "paystatus": "1",
            "paytime": "1528960175",
            "order_time": "0",
            "mch_orderid": "",
            "is_refund": "0",
            "company": "汕头市微赢家信息科技有限公司",
            "nickname": "微赢家",
            "shopname": "微赢家灵风分店",
            "remarks": "",
            "refundmoney": "0.00",
            "mid": "881",
            "cdid": "700",
            "m_paytype": "cash"
        }
    ],
    "version": "3.0",
    "charset": "UTF-8",
    "message": "SUCCESS",
    "status": "10000",
    "sign_type": "MD5",
    "sign": "0c57170958bd46292acf3f58c52fe816"
}
                            
参数名 描述 类型
total_items 总记录数 number
page_size 每页记录数 number
current_no 当前页码 number
total_no 总页码数目 number
lists 记录列表,array()数组类型,对应key参数如下 array
lists.orderid 系统订单号 number
lists.paymoney 下单支付金额,单位元 number
lists.pri_paymoney 实际支付金额,单位元 number
lists.paystatus 支付状态 1支付成功 2支付失败 0待支付 number
lists.order_time 下单时间,时间戳,精确到秒 number
lists.mch_orderid 商户订单号 string
lists.is_refund 标识:2退款 1撤销 0普通订单(默认) number
version 接口版本号,3.0 number
charset 接口字符编码,UTF-8 string
message 错误信息 string
status 错误状态 number
sign_type 签名方式,MD5 string
sign 签名字符串,参照签名方法 string
lists.paytime 支付时间,时间戳,精确到秒 string
lists.shopname 店铺名称 string
lists.nickname 商家昵称 string
lists.company 商家名称 string
lists.remarks 订单备注 string
lists.refundmoney 退款总金额,单位元 string
lists.mid 收款店员id string
lists.cdid 设备ID string
lists.m_paytype 支付类型 : cash 现金支付 string

现金支付退款

在线测试 在线浏览

请求方式:POST

请求地址:http://zhaoyin.lfwin.com/payapi/cash/refund_order

Body参数名 类型 必需 描述 示例 e.g.
service string 接口名称 refund.order
apikey string 商家APIKEY,唯一标识,由服务商提供 00014005
nonce_str string 随机字符串,长度不超过32位 123456
refundmoney string 退款金额,单位元 0.01
sign string 签名,参照签名算法 6991088eaea3c21c708f54a1757341a2
orderid string 系统订单号,唯一值 20180226151044007002709
auth_token string 授权码,联系技术索要
mch_orderid string 商户订单号,如果orderid跟mch_orderid同时存在,以orderid为准
order_time string 下单时间,时间戳,精确到秒,如果只传商户订单号,必须传下单时间
guid string 设备唯一标识
mid string 登录的收款店员id
auth_mid string 授权的店员id
reason string 退款原因

详细说明:

退款失败返回示例
{
    "version": "3.0",
    "charset": "UTF-8",
    "sign_type": "MD5",
    "status": 4910,
    "message": "订单已撤销或已退款"
}

返回示例:

                                {
    "service": "refund.order",
    "orderid": "20180226151118007007036",
    "refund_no": "20180226151118007007036rf157521",
    "is_refund": "2",
    "refundtime": "1519716187",
    "refundmoney": "0.01",
    "version": "3.0",
    "charset": "UTF-8",
    "message": "SUCCESS",
    "status": "10000",
    "sign_type": "MD5",
    "sign": "4524e576977bfb08ad3825c0fd8484ea"
}
                            
参数名 描述 类型
service 接口名称 string
orderid 系统订单号,唯一值 number
refund_no 退款通道流水号 string
is_refund 标识:2退款 1撤销 0普通订单(默认) number
refundtime 退款时间,时间戳,精确到秒 number
refundmoney 退款金额 number
version 接口版本号,3.0 number
charset 接口字符编码,UTF-8 string
message 错误信息 string
status 错误状态 number
sign_type 签名方式,MD5 string
sign 签名字符串,参照签名方法 string

现金退款查询

在线测试 在线浏览

请求方式:POST

请求地址:http://zhaoyin.lfwin.com/payapi/cash/query_refund?test=1

Body参数名 类型 必需 描述 示例 e.g.
service string 接口名称 query.refund
apikey string 商家APIKEY,唯一标识,由服务商提供 00014005
orderid string 原订单号 20180111161233007007257
nonce_str string 随机字符串,长度不超过32位 123456
sign string 签名,参照签名算法
refund_no string 退款订单号,不传退款订单号情况下查询原订单号已执行退款记录,传该值则不返回mid 20180111161233007007257rf
mch_orderid string 商户订单号,如果orderid跟mch_orderid同时存在,以orderid为准
order_time string 下单时间,时间戳,精确到秒,如果只传商户订单号,必须传下单时间
page_no string 第几页,默认第1页
page_size string 每页条数,默认20条,最大200条

返回示例:

                                {
    "total_items": "1",
    "page_size": "20",
    "current_no": "1",
    "total_no": "1",
    "lists": [
        {
            "orderid": "201804172107000070054649",
            "refund_no": "201804172107000070054649rf200391",
            "reason": "",
            "refundmoney": "0.01",
            "refundtime": "1523970773",
            "is_refund": "2",
            "mid": "881",
            "service": "mybank.wxpay.query_refund",
            "pri_paymoney": "0.00",
            "paymoney": ""
        }
    ],
    "version": "3.0",
    "charset": "UTF-8",
    "message": "SUCCESS",
    "status": "10000",
    "sign_type": "MD5",
    "sign": "253a417fbc0d67ac19f3468f971c56e6"
}
                            
参数名 描述 类型
total_items 总记录数 string
current_no 当前页码 string
total_no 总页码数目 string
page_size 每页记录数 string
lists 记录列表,array()数组类型,对应key参数如下 string
lists.service 接口名称 string
lists.orderid 系统订单号,唯一值 number
lists.refund_no 退款通道流水号 string
lists.reason 退款原因 string
lists.pri_paymoney 实际支付金额,单位元 number
lists.paymoney 下单支付金额,单位元 number
lists.refundmoney 本次退款金额,单位元 number
lists.refundtime 退款时间,时间戳,精确到秒 string
lists.mid 退款店员ID string
version 接口版本号,3.0 number
charset 接口字符编码,UTF-8 string
message 错误信息 string
status 错误状态 number
sign_type 签名方式,MD5 string
sign 签名字符串,参照签名方法 string
lists.is_refund 类型:1 撤销 2退款 string
lists.refund_status 退款状态:0待处理 1处理成功 2退款失败 string
lists.auth_mid 授权店员id string

现金支付查询

在线测试 在线浏览

请求方式:POST

请求地址:http://zhaoyin.lfwin.com/payapi/cash/query_order

Body参数名 类型 必需 描述 示例 e.g.
service string 接口名称 query.order
apikey string 系统订单号,唯一值 00014005
orderid string 商家APIKEY,唯一标识,由服务商提供
nonce_str string 随机字符串,长度不超过32位 123456
sign string 签名,参照签名算法
mch_orderid string 商户订单号,如果orderid跟mch_orderid同时存在,以orderid为准
order_time string 下单时间,时间戳,精确到秒,如果只传商户订单号,必须传下单时间

返回示例:

                                {
    "service": "query.order",
    "orderid": "20180226151044007002709",
    "paymoney": "0.01",
    "pri_paymoney": "0.00",
    "order_time": "1519629044",
    "paystatus": "1",
    "mch_orderid": "",
    "version": "3.0",
    "charset": "UTF-8",
    "message": "SUCCESS",
    "status": "10000",
    "sign_type": "MD5",
    "sign": "63441f5d019fa3ae7facad5ed4211f27"
}
                            
参数名 描述 类型
service 接口名称 string
orderid 系统订单号,唯一值 number
paymoney 下单支付金额,单位元 number
pri_paymoney 实际支付金额,单位元 number
order_time 下单时间。时间戳,单位秒 number
paystatus 支付状态:1 支付成功 ,0代付款,2付款失败 number
mch_orderid 商户外部订单号 string
version 接口版本号,3.0 number
charset 接口字符编码,UTF-8 string
message 错误信息 string
status 错误状态 number
sign_type 签名方式,MD5 string
sign 签名字符串,参照签名方法 string

现金订单支付

在线测试 在线浏览

请求方式:POST

请求地址:http://zhaoyin.lfwin.com/payapi/cash/pay_order

Body参数名 类型 必需 描述 示例 e.g.
service string 接口名称 pay.order
apikey string 商家APIKEY,唯一标识,由服务商提供 00014005
money string 支付金额,单位元,最小值0.01,表示0.01元 0.01
nonce_str string 随机字符串,长度不超过32位 123456
sign string 签名,参照签名算法 09b926011f6316b3614cf53dd76f51ec
auth_token string 授权码,联系技术索要
mch_orderid string 商家系统外部订单号,必须保证每次下单唯一,如果下单失败请调用查询接口
mid string 登录的收款店员id
guid string 设备唯一标识
remarks string 订单备注

返回示例:

                                {
    "service": "pay.order",
    "orderid": "20180226151302007001482",
    "pri_paymoney": "0.02",
    "paystatus": "1",
    "order_time": "1519629182",
    "mch_orderid": "",
    "version": "3.0",
    "charset": "UTF-8",
    "message": "SUCCESS",
    "status": "10000",
    "sign_type": "MD5",
    "sign": "2b80490c73f8caa6affa5af07f78bd0a"
}
                            
参数名 描述 类型
service 接口名称 string
orderid 系统订单号 number
pri_paymoney 商家优惠活动后,实际支付金额,单位元 number
paystatus 支付状态 1支付成功 2支付失败 0待支付 number
order_time 下单时间,时间戳,精确到秒。 number
mch_orderid 商户订单号 string
version 接口版本号,3.0 number
charset 接口字符编码,UTF-8 string
message 错误信息 string
status 错误状态 number
sign_type 签名方式,MD5 string
sign 签名字符串,参照签名方法 string

银联订单支付

在线测试 在线浏览

请求方式:POST

请求地址:http://zhaoyin.lfwin.com/payapi/bank/pay?test=1

Body参数名 类型 必需 描述 示例 e.g.
service string 接口名称 sunmi.pay
apikey string 商家APIKEY,唯一标识,由服务商提供
money string 支付金额,单位元,最小值0.01,表示0.01元 0.01
merchant_id string 银联支付商户号(欧米,商米,盒子,富友)
auth_token string 授权码,联系技术索要
nonce_str string 随机字符串,长度不超过32位
sign string 签名,参照签名算法
mid string 登录的收款店员id
sunmi_channel string 银联渠道
guid string 设备唯一编号
remarks string 订单备注
mch_orderid string 商户外部订单号

返回示例:

                                {
    "service": "sunmi.pay",
    "orderid": "20180226151302007001482",
    "pri_paymoney": "0.02",
    "paystatus": "0",
    "order_time": "1519629182",
    "version": "3.0",
    "charset": "UTF-8",
    "message": "SUCCESS",
    "status": "10000",
    "sign_type": "MD5",
    "sign": "2b80490c73f8caa6affa5af07f78bd0a"
}
                            
参数名 描述 类型
service 接口名称 string
orderid 系统订单号 number
pri_paymoney 商家优惠活动后,实际支付金额,单位元 number
paystatus 支付状态 1支付成功 2支付失败 0待支付 number
order_time 下单时间,时间戳,精确到秒。 number
version 接口版本号,3.0 number
charset 接口字符编码,UTF-8 string
message 错误信息 string
status 错误状态 number
sign_type 签名方式,MD5 string
sign 签名字符串,参照签名方法 string
mch_orderid 商户外部订单号 string

银联订单更新

在线测试 在线浏览

请求方式:POST

请求地址:http://zhaoyin.lfwin.com/payapi/bank/upd_order?test=1

Body参数名 类型 必需 描述 示例 e.g.
service string 接口名称 sunmi.upd
apikey string 商家APIKEY,唯一标识,由服务商提供
auth_token string 授权码,联系技术索要
orderid string 系统订单号
nonce_str string 随机字符串,长度不超过32位
sign string 签名,参照签名算法
reference_no string 参考号,用于退货
card_no string 卡号,除前六位和后四位之外其余位变星号处理
card_type string 卡类型 IC/NFC/MAG
terminal_id string 终端号
merchant_id string 商户号
merchant_name string 商户名称
trans_date string 交易日期
trans_time string 交易时间
result_msg string 结果信息描述
result_code string 支付结果代码
pay_result string 支付结果 0-代付款 1—成功; 3退款
voucher_no string 凭证号,用于交易撤销
qr_order_no string 扫码消费订单号,用于扫码消费退货
batch_no string 批次号
payment_type string 支付方式“0”:银行卡“1”:支付宝扫码(B扫C)“2”:支付宝二维码(C扫B)“3”:微信支付扫码(B扫C)“4”:微信支付二维码(C扫B)
mch_orderid string 商户外部订单号,orderid跟mch_orderid 同时存在,以orderid为准
参数名 描述 类型
service 接口名称 string
sign 签名字符串,参照签名方法 string
sign_type 签名方式,MD5 string
status 错误状态 string
message 错误信息 string
charset 接口字符编码,UTF-8 string
version 接口版本号,3.0 string
orderid 系统订单号 string
pay_result 支付结果 0-代付款 1—成功; 3退款 string
mch_orderid 商户外部订单号 string

银联盒子参数

在线测试 在线浏览

请求方式:POST

请求地址:http://zhaoyin.lfwin.com/payapi/bank/boxpay_config?test=1

Body参数名 类型 必需 描述 示例 e.g.
service string 接口名称 boxpay.config
auth_token string 授权码,联系技术索要
sign string 签名,参照签名算法
nonce_str string 随机字符串,长度不超过32位
apikey string 商家APIKEY,唯一标识,由服务商提供

返回示例:

                                {
    "service": "query.order",
    "box_mer_id": "20180226151044007002709",
    "app_code": "0.01",
    "md5_key": "0.00",
    "version": "3.0",
    "charset": "UTF-8",
    "message": "SUCCESS",
    "status": "10000",
    "sign_type": "MD5",
    "sign": "63441f5d019fa3ae7facad5ed4211f27"
}
                            
参数名 描述 类型
service 接口名称 string
box_mer_id 盒子商户号 number
app_code 盒子app号 number
md5_key 盒子秘钥 number
version 接口版本号,3.0 number
charset 接口字符编码,UTF-8 string
message 错误信息 string
status 错误状态 number
sign_type 签名方式,MD5 string
sign 签名字符串,参照签名方法 string

银联订单列表

在线测试 在线浏览

请求方式:POST

请求地址:http://zhaoyin.lfwin.com/payapi/bank/order_list?test=1

Body参数名 类型 必需 描述 示例 e.g.
service string 接口名称 sunmi.order
apikey string 商家APIKEY,唯一标识,由服务商提供 00014005
nonce_str string 随机字符串,长度不超过32位 123456
sign string 签名,参照签名算法
order_time_s string 下单开始时间,时间戳,精确到秒 1524672000
order_time_e string 下单结束时间,时间戳,精确到秒 1524758399
orderid string 系统订单号,唯一值
page_no string 第几页,默认第1页
page_size string 每页条数,默认20条,最大200条 10
mch_orderid string 商户外部订单号,orderid跟mch_orderid 同时存在,以orderid为准

详细说明:


返回示例:

                                {
    "total_items": "3",
    "page_size": "10",
    "current_no": "1",
    "total_no": "1",
    "lists": [
        {
            "orderid": "201804261522130070084876",
            "reference_no": "000351223980",
            "card_no": "6214830206864653",
            "card_type": "NFC",
            "terminal_id": "39103120",
            "merchant_id": "820392473720001",
            "merchant_name": "小酷",
            "payment_type": "0",
            "result_msg": "",
            "result_code": "0",
            "channel": "ssunmi.fw2.payment.allinpay",
            "paytime": "1524727362",
            "order_time": "1524727333",
            "trans_date": "0426",
            "trans_time": "184129",
            "voucher_no": "000008",
            "qr_order_no": "",
            "batch_no": "000001",
            "paystatus": "1",
            "is_refund": "2",
            "paymoney": "0.01"
        },
        {
            "orderid": "201804261520340070022845",
            "reference_no": "",
            "card_no": "",
            "card_type": "",
            "terminal_id": "",
            "merchant_id": "",
            "merchant_name": "",
            "payment_type": "0",
            "result_msg": "",
            "result_code": "",
            "channel": "ssunmi.fw2.payment.allinpay",
            "paytime": "0",
            "order_time": "1524727234",
            "trans_date": "",
            "trans_time": "",
            "voucher_no": "",
            "qr_order_no": "",
            "batch_no": "",
            "paymoney": "0.96"
        },
        {
            "orderid": "201804261515530070095673",
            "reference_no": "",
            "card_no": "",
            "card_type": "",
            "terminal_id": "",
            "merchant_id": "",
            "merchant_name": "",
            "payment_type": "0",
            "result_msg": "",
            "result_code": "",
            "channel": "ssunmi.fw2.payment.allinpay",
            "paytime": "0",
            "order_time": "1524726953",
            "trans_date": "",
            "trans_time": "",
            "voucher_no": "",
            "qr_order_no": "",
            "batch_no": "",
            "paymoney": "2"
        }
    ],
    "version": "3.0",
    "charset": "UTF-8",
    "message": "SUCCESS",
    "status": "10000",
    "sign_type": "MD5",
    "sign": "0a9aef9b61c3679d4881afab2a2280ed"
}
                            
参数名 描述 类型
total_items 总记录数 number
page_size 每页记录数 number
current_no 当前页码 number
total_no 总页码数目 number
lists 记录列表,array()数组类型,对应key参数如下 array
lists.orderid 系统订单号 number
lists.paytime 支付时间 number
lists.order_time 下单时间 number
lists.pri_paymoney 实际支付金额,单位元 number
version 接口版本号,3.0 number
charset 接口字符编码,UTF-8 string
message 错误信息 string
status 错误状态 number
sign_type 签名方式,MD5 string
sign 签名字符串,参照签名方法 string
lists.remarks 订单备注 string
lists.reference_no 参考号,用于退货 string
lists.card_no 卡号,除前六位和后四位之外其余位变星号处理 string
lists.card_type 卡类型 IC/NFC/MAG string
lists.terminal_id 终端号 string
lists.merchant_id 商户号 string
lists.is_refund 标识:2退款 1撤销 0普通订单 string
lists.paystatus 支付状态 1支付成功 2支付失败 0待支付 string
lists.merchant_name 商户名称 string
lists.trans_date 交易日期 string
lists.trans_time 交易时间 string
lists.result_msg 结果信息描述 string
lists.result_code 支付结果代码 string
lists.voucher_no 凭证号,用于交易撤销 string
lists.qr_order_no 扫码消费订单号,用于扫码消费退货 string
lists.batch_no 批次号 string
lists.payment_type 支付方式“0”:银行卡“1”:支付宝扫码(B扫C)“2”:支付宝二维码(C扫B)“3”:微信支付扫码(B扫C)“4”:微信支付二维码(C扫B) string
lists.icbc_num 工行6位数字 string
lists.remarks 订单备注 string
lists.mch_orderid 商户外部订单号 string

预授权订单列表

在线测试 在线浏览

请求方式:POST

请求地址:http://zhaoyin.lfwin.com/payapi/prepay/order_list?test=1

Body参数名 类型 必需 描述 示例 e.g.
service string 接口名称 order.list
apikey string 商家APIKEY,唯一标识,由服务商提供 00014005
nonce_str string 随机字符串,长度不超过32位 123456
sign string 签名,参照签名算法 09b926011f6316b3614cf53dd76f51ec
orderid string 系统订单号,唯一值
order_time_s string 下单开始时间,时间戳,精确到秒
order_time_e string 下单结束时间,时间戳,精确到秒
page_no string 第几页,默认第1页
page_size string 每页条数,默认20条,最大200条
mch_orderid string 商户订单号,如果orderid跟mch_orderid同时存在,以orderid为准
order_time string 下单时间,时间戳,精确到秒,如果只传商户订单号,必须传下单时间
paytype string 支付方式: 1条码 2扫码 2
bank_type string 支付通道: 3富友;
m_paytype string 支付类型 : wxpay 微信 ;
is_pre string 预授权状态,0 待执行,1已完成 ,2已撤销
paystatus string 支付状态: 1支付成功, 2支付失败, 0待支付
mchnt_order_no string 预授权请求流水号

详细说明:


返回示例:

                                {
    "total_items": "16",
    "page_size": "2",
    "current_no": "1",
    "total_no": "8",
    "lists": [
        {
            "orderid": "201809281602040070072885",
            "trade_no": "",
            "paymoney": "0.01",
            "pri_paymoney": "0.00",
            "paytime": "0",
            "company": "汕头市微赢家信息科技有限公司",
            "nickname": "微赢家",
            "shopname": "微赢家灵风分店",
            "buyer_account": "",
            "mid": "0",
            "remarks": "",
            "cdid": "700",
            "paystatus": "0",
            "order_time": "1538121724",
            "mch_orderid": "",
            "paytype": "2",
            "bank_type": "3",
            "m_paytype": "wxpay",
            "is_pre": "0",
            "pretime": "0",
            "mchnt_order_no": "",
            "service": "fuiou.wxpay.qrcode"
        },
        {
            "orderid": "201809281600550070084507",
            "trade_no": "",
            "paymoney": "0.01",
            "pri_paymoney": "0.00",
            "paytime": "0",
            "company": "汕头市微赢家信息科技有限公司",
            "nickname": "微赢家",
            "shopname": "微赢家灵风分店",
            "buyer_account": "",
            "mid": "0",
            "remarks": "",
            "cdid": "700",
            "paystatus": "0",
            "order_time": "1538121655",
            "mch_orderid": "",
            "paytype": "2",
            "bank_type": "3",
            "m_paytype": "wxpay",
            "is_pre": "0",
            "pretime": "0",
            "mchnt_order_no": "",
            "service": "fuiou.wxpay.qrcode"
        }
    ],
    "version": "3.0",
    "charset": "UTF-8",
    "message": "SUCCESS",
    "status": "10000",
    "sign_type": "MD5",
    "sign": "b01ed6b4856e070338d8fe4a50980cb0"
}
                            
参数名 描述 类型
total_items 总记录数 number
page_size 每页记录数 number
current_no 当前页码 number
total_no 总页码数目 number
lists 记录列表,array()数组类型,对应key参数如下 array
lists.orderid 系统订单号 number
lists.trade_no 通道流水号 string
lists.paymoney 下单支付金额,单位元 number
lists.pri_paymoney 预授权完成金额,单位元 number
lists.paytime 支付成功时间。时间戳,单位秒 number
list.shopname 门店名称 string
lists.paystatus 支付状态:1 支付成功 ,0代付款,2付款失败 number
lists.order_time 下单时间 number
lists.mch_orderid 商户订单号 string
lists.paytype 支付方式:1条码 2扫码 string
lists.bank_type 支付通道: 0官方 ; 3富友; 4网商 ;5间联1; 6乐刷 string
lists.m_paytype 支付类型 : alipay 支付宝 ; wxpay 微信 ; unpay 银联云闪付 ; bdpay 百度; best 天翼支付 string
lists.is_pre 预授权状态,0 待执行,1已完成 ,2已撤销 string
lists.pretime 预授权完成,撤销时间。时间戳,单位秒 string
lists.mchnt_order_no 预授权请求流水号 string
version 接口版本号,3.0 number
charset 接口字符编码,UTF-8 string
message 错误信息 string
status 错误状态 number
sign_type 签名方式,MD5 string
sign 签名字符串,参照签名方法 string
lists.buyer_account 支付账号 string
lists.mid 收款店员ID string
lists.remarks 订单备注 string
lists.cdid 设备ID string
lists.company 商家名称 string
lists.nickname 商家昵称 string
lists.auth_mid 执行授权撤销或完成的店员ID string
lists.service 该订单的支付service string

预授权扫码支付

在线测试 在线浏览

请求方式:POST

请求地址:http://zhaoyin.lfwin.com/payapi/prepay/qrcode?test=1

Body参数名 类型 必需 描述 示例 e.g.
service string 接口名称 fuiou.wxpay.qrcode
apikey string 商家APIKEY,唯一标识,由服务商提供 00014005
money string 支付金额,单位元,最小值0.01,表示0.01元 0.01
nonce_str string 随机字符串,长度不超过32位 123456
sign string 签名,参照签名算法
mch_orderid string 商家系统外部订单号,必须保证每次下单唯一,如果下单失败请调用查询接口
mid string 登录的收款店员id
remarks string 订单备注

详细说明:

预授权支付完成后,30天没有执行预授权完成或者撤销,这笔账会自动退款
场景说明
步骤 1: 商户发送报文至接口进行下单,实时返回下单后的预授权二维码址。
步骤 2:商户展示二维码给用户,用户使用微信、支付宝等扫码预授权。
注意: 下单成功之后开始查询。建议:查询间隔 5S 以上。如主动发起查询请在下单成功之后发起查询

返回示例:

                                {
    "service": "fuiou.wxpay.qrcode",
    "orderid": "201809281602040070072885",
    "qr_code": "weixin://wxpay/bizpayurl?pr=FLiqWSp",
    "paymoney": "0.01",
    "paystatus": "0",
    "order_time": "1538121724",
    "mch_orderid": "",
    "pri_paymoney": "0",
    "is_pre": "0",
    "pretime": "0",
    "code_url": "http://zhaoyin.lfwin.com/payapi/index/showqr/code/d2VpeGluOi8vd3hwYXkvYml6cGF5dXJsP3ByPUZMaXFXU3A%253D",
    "version": "3.0",
    "charset": "UTF-8",
    "message": "SUCCESS",
    "status": "10000",
    "sign_type": "MD5",
    "sign": "f1857118a631b436dc63f516f8072ddc"
}
                            
参数名 描述 类型
service 支付通道: fuiou.wxpay.qrcode 富友预授权微信扫码支付 string
orderid 系统订单号,唯一值 number
qr_code 支付二维码内容 string
paymoney 预授权支付金额,单位元 number
paystatus 支付状态:1 支付成功 ,0代付款,2付款失败 number
order_time 下单时间。时间戳,单位秒 number
mch_orderid 商户外部订单号 string
code_url 支付二维码在线地址 string
version 接口版本号,3.0 number
charset 接口字符编码,UTF-8 string
message 错误信息 string
status 错误状态 number
sign_type 签名方式,MD5 string
sign 签名字符串,参照签名方法 string
pri_paymoney 预授权完成金额,单位元 string
is_pre 预授权状态,0 待执行,1已完成 ,2已撤销 string
pretime 预授权完成,撤销时间。时间戳,单位秒 string

预授权条码支付

在线测试 在线浏览

请求方式:POST

请求地址:http://zhaoyin.lfwin.com/payapi/prepay/barcode?test=1

Body参数名 类型 必需 描述 示例 e.g.
service string 接口名称 fuiou.wxpay.barcode
apikey string 商家APIKEY,唯一标识,由服务商提供 00014005
money string 支付金额,单位元,最小值0.01,表示0.01元 0.01
dynamic_id string 支付条形码 286103991909766417
nonce_str string 随机字符串,长度不超过32位 123456
sign string 签名,参照签名算法
mch_orderid string 商家系统外部订单号,必须保证每次下单唯一,如果下单失败请调用查询接口
mid string 登录的收款店员id
remarks string 订单备注

详细说明:

预授权支付完成后,30天没有执行预授权完成或者撤销,这笔账会自动退款
场景说明
步骤 1: 用户和商户确认订单金额
步骤 2:用户向商户展示支付二维码(微信、支付宝等)
步骤 3:商户使用扫码枪,扫描用户二维码并提交到系统,并实时返回支付结果
注: 条码预授权存在需要用户输入支付密码的场景,是否需要输入支付密码,与
支付宝、微信的风控规则有关。此时需要商户主动发起查询来确定最好的订单状
态。 (建议: 交易发起 5S 以后开始查询。查询间隔 5S 以上)









返回示例:

                                {
    "service": "fuiou.wxpay.barcode",
    "orderid": "201809281558030070017083",
    "trade_no": "4200000180201809285004843205",
    "paymoney": "0.01",
    "buyer_account": "微信",
    "paytime": "1538121483",
    "paystatus": "1",
    "order_time": "1538121483",
     "pri_paymoney": "0",
    "is_pre": "0",
    "pretime": "0",
    "mch_orderid": "",
    "version": "3.0",
    "charset": "UTF-8",
    "message": "SUCCESS",
    "status": "10000",
    "sign_type": "MD5",
    "sign": "2a4fa1a2bc4a5bcdec0b954d04907ac6"
}
                            
参数名 描述 类型
service 支付通道 string
orderid 系统订单号,唯一值 number
trade_no 通道流水号 number
paymoney 下单支付金额,单位元 number
pri_paymoney 预授权完成金额,单位元 number
buyer_account 买家账号 string
paytime 支付成功时间。时间戳,单位秒 number
paystatus 支付状态:1 支付成功 ,0代付款,2付款失败 number
order_time 下单时间。时间戳,单位秒 number
mch_orderid 商户外部订单号 string
version 接口版本号,3.0 number
charset 接口字符编码,UTF-8 string
message 错误信息 string
status 错误状态 number
sign_type 签名方式,MD5 string
sign 签名字符串,参照签名方法 string
is_pre 预授权状态,0 待执行,1已完成 ,2已撤销 string
pretime 预授权完成,撤销时间。时间戳,单位秒 string

预授权支付状态轮询

在线测试 在线浏览

请求方式:POST

请求地址:http://zhaoyin.lfwin.com/payapi/prepay/query_order?test=1

Body参数名 类型 必需 描述 示例 e.g.
service string 接口名称 fuiou.wxpay.query_order
orderid string 系统订单号,唯一值 201807101612530070089833
apikey string 商家APIKEY,唯一标识,由服务商提供 00014005
sign string 签名,参照签名算法
nonce_str string 随机字符串,长度不超过32位 123456
mch_orderid string 商户订单号,如果orderid跟mch_orderid同时存在,以orderid为准 15181042584813748
order_time string 下单时间,时间戳,精确到秒,如果只传商户订单号,必须传下单时间 1518104258

详细说明:

本接口仅支持对预授权的支付状态进行查询
对预授权完成跟撤销结果信息查询,请使用预授权(撤销/完成)查询

返回示例:

                                {
    "service": "fuiou.wxpay.query_order",
    "orderid": "201809281558030070017083",
    "trade_no": "4200000180201809285004843205",
    "paystatus": "1",
    "paymoney": "0.01",
    "order_time": "1538121483",
    "paytime": "1538121483",
    "mch_orderid": "",
    "buyer_account": "微信",
    "pri_paymoney": "0.00",
    "is_pre": "0",
    "pretime": "0",
    "version": "3.0",
    "charset": "UTF-8",
    "message": "SUCCESS",
    "status": "10000",
    "sign_type": "MD5",
    "sign": "4c8de066cf2da066fc5b767cd0abf344"
}
                            
参数名 描述 类型
service 接口名称 string
orderid 系统订单号,唯一值 number
trade_no 通道流水号 number
paystatus 支付状态:1 支付成功 ,0代付款,2付款失败 number
paymoney 下单支付金额,单位元 number
pri_paymoney 预授权完成金额,单位元 string
order_time 下单时间。时间戳,单位秒 number
paytime 支付成功时间。时间戳,单位秒 number
mch_orderid 商户外部订单号 string
version 接口版本号,3.0 number
charset 接口字符编码,UTF-8 string
message 错误信息 string
status 错误状态 number
sign_type 签名方式,MD5 string
sign 签名字符串,参照签名方法 string
pretime 预授权完成,撤销时间。时间戳,单位秒 string
is_pre 预授权状态,0 待执行,1已完成 ,2已撤销 string

预授权(撤销/完成)查询

在线测试 在线浏览

请求方式:POST

请求地址:http://zhaoyin.lfwin.com/payapi/prepay/query_order_auth?test=1

Body参数名 类型 必需 描述 示例 e.g.
service string 接口名称 fuiou.wxpay.query_order_auth
apikey string 商家APIKEY,唯一标识,由服务商提供 00014005
sign string 签名,参照签名算法
nonce_str string 随机字符串,长度不超过32位 123456
orderid string 系统订单号,唯一值,orderid、mchnt_order_no、mch_orderid不能同时为空
mchnt_order_no string 预授权请求流水号,预授权撤销或完成接口返回,如果传值,则查询本次执行结果
mch_orderid string 商户订单号,如果orderid跟mch_orderid同时存在,以orderid为准
order_time string 下单时间,时间戳,精确到秒,如果只传商户订单号,必须传下单时间

详细说明:

本接口仅支持对预授权完成跟撤销状态进行查询
对预授权交易支付结果信息查询,请使用 预授权支付状态轮询

返回示例:

                                {
    "service": "fuiou.wxpay.query_order_auth",
    "orderid": "201809281558030070017083",
    "mchnt_order_no": "201809281627060070027059",
    "paymoney": "0.01",
    "pri_paymoney": "0.01",
    "paystatus": "1",
    "is_pre": "1",
    "pretime": "1538123226",
    "paytime": "1538121483",
    "order_time": "1538121483",
    "mch_orderid": "",
    "version": "3.0",
    "charset": "UTF-8",
    "message": "SUCCESS",
    "status": "10000",
    "sign_type": "MD5",
    "sign": "ced2ff44090619b61aa512498430a010"
}
                            
参数名 描述 类型
service 接口名称 string
orderid 系统订单号,唯一值 number
mchnt_order_no 预授权请求流水号 number
paystatus 支付状态:1 支付成功 ,0代付款,2付款失败 number
paymoney 预授权下单支付金额,单位元 number
pri_paymoney 预授权完成金额,单位元 string
order_time 下单时间。时间戳,单位秒 number
paytime 支付成功时间。时间戳,单位秒 number
mch_orderid 商户外部订单号 string
version 接口版本号,3.0 number
charset 接口字符编码,UTF-8 string
message 错误信息 string
status 错误状态 number
sign_type 签名方式,MD5 string
sign 签名字符串,参照签名方法 string
is_pre 预授权状态,0 待执行,1已完成 ,2已撤销 string
pretime 预授权完成,撤销时间。时间戳,单位秒 string
buyer_account 用户账号 string
auth_mid 执行预授权撤销店员id string

预授权撤销

在线测试 在线浏览

请求方式:POST

请求地址:http://zhaoyin.lfwin.com/payapi/prepay/cancel_order?test=1

Body参数名 类型 必需 描述 示例 e.g.
service string 接口名称 fuiou.wxpay.cancel_order
apikey string 商家APIKEY,唯一标识,由服务商提供 00014005
orderid string 系统订单号,唯一值 201809281433580070043961
nonce_str string 随机字符串,长度不超过32位 123456
sign string 签名,参照签名算法 2171ed542106e5a26eb0ae7d1f9a7a22
mch_orderid string 商户订单号,如果orderid跟mch_orderid同时存在,以orderid为准
order_time string 下单时间,时间戳,精确到秒,如果只传商户订单号,必须传下单时间
mid string 登录的撤销店员id

详细说明:

预授权撤销操作,支付的订单金额,原路返回消费者

返回示例:

                                {
    "service": "fuiou.wxpay.cancel_order",
    "orderid": "201809281555590070083144",
    "mchnt_order_no": "201809281624040070088809",
    "paymoney": "0.01",
    "pri_paymoney": "0.00",
    "paystatus": "1",
    "is_pre": "2",
    "pretime": "1538123044",
    "paytime": "1538121372",
    "order_time": "1538121359",
    "mch_orderid": "",
    "auth_mid": "",
    "buyer_account": "微信",
    "version": "3.0",
    "charset": "UTF-8",
    "message": "SUCCESS",
    "status": "10000",
    "sign_type": "MD5",
    "sign": "a445f24003faee0cf2cdc3b8def4db09"
}
                            
参数名 描述 类型
service 接口名称 string
orderid 系统订单号,唯一值 number
pri_paymoney 预授权订单完成的金额,单位元 string
paymoney 预授权订单支付金额,单位元 string
buyer_account 用户账号,支付宝或微信 string
version 接口版本号,3.0 number
charset 接口字符编码,UTF-8 string
message 错误信息 string
status 错误状态 number
sign_type 签名方式,MD5 string
sign 签名字符串,参照签名方法 string
is_pre 预授权状态,0 待执行,1已完成 ,2已撤销 string
pretime 预授权完成或撤销时间。时间戳,单位秒 string
mchnt_order_no 预授权完成或者撤销流水号 string
paystatus 支付状态:1 支付成功 ,0代付款,2付款失败 string
mch_orderid 商家外部订单号 string
order_time 预授权订单下单时间时间, 时间戳, 精确到秒 string
paytime 预授权订单支付时间, 时间戳, 精确到秒 string
auth_mid 执行预授权撤销店员id string

预授权完成

在线测试 在线浏览

请求方式:POST

请求地址:http://zhaoyin.lfwin.com/payapi/prepay/finish_order?test=1

Body参数名 类型 必需 描述 示例 e.g.
service string 接口名称 fuiou.wxpay.finish_order
apikey string 商家APIKEY,唯一标识,由服务商提供 00014005
orderid string 系统订单号,唯一值 20180112143625007009679
nonce_str string 随机字符串,长度不超过32位 123456
sign string 签名,参照签名算法 2171ed542106e5a26eb0ae7d1f9a7a22
money string 预授权完成金额,单位元,最小值0.01,表示0.01元
mch_orderid string 商户订单号,如果orderid跟mch_orderid同时存在,以orderid为准
order_time string 下单时间,时间戳,精确到秒,如果只传商户订单号,必须传下单时间
auth_mid string 执行预授权完成,店员id

详细说明:

预授权完成操作,支付的订单金额,执行完成预授权操作,订单金额打款至商家账户

返回示例:

                                {
    "service": "fuiou.wxpay.finish_order",
    "orderid": "201809281558030070017083",
    "mchnt_order_no": "201809281627060070027059",
    "paymoney": "0.01",
    "pri_paymoney": "0.01",
    "paystatus": "1",
    "is_pre": "1",
    "pretime": "1538123226",
    "paytime": "1538121483",
    "order_time": "1538121483",
    "mch_orderid": "",
    "auth_mid": "",
    "buyer_account": "微信",
    "version": "3.0",
    "charset": "UTF-8",
    "message": "SUCCESS",
    "status": "10000",
    "sign_type": "MD5",
    "sign": "f489f40a7b14cdb916370e5bc1597b07"
}
                            
参数名 描述 类型
service 接口名称 string
orderid 系统订单号,唯一值 number
pri_paymoney 预授权订单完成的金额,单位元 string
paymoney 预授权订单支付金额,单位元 string
buyer_account 用户账号,支付宝或微信 string
is_pre 预授权状态,0 待执行,1已完成 ,2已撤销 string
version 接口版本号,3.0 number
charset 接口字符编码,UTF-8 string
message 错误信息 string
status 错误状态 number
sign_type 签名方式,MD5 string
sign 签名字符串,参照签名方法 string
pretime 预授权完成或撤销时间。时间戳,单位秒 string
mchnt_order_no 预授权完成或者撤销流水号 string
paystatus 支付状态:1 支付成功 ,0代付款,2付款失败 string
mch_orderid 商家外部订单号 string
order_time 预授权订单下单时间时间, 时间戳, 精确到秒 string
paytime 预授权订单支付时间, 时间戳, 精确到秒 string
auth_mid 执行预授权撤销店员id string

统计相关

机具行为

在线测试 在线浏览

请求方式:POST

请求地址:http://zhaoyin.lfwin.com/bsapi/behav/soft?test=1

Body参数名 类型 必需 描述 示例 e.g.
service string 机具行为,枚举值 behav.soft.setup
type string 机具型号,联系技术约定机具型号枚举值 exe
nonce_str string 随机字符串,长度不超过32位 123456
sn string 机具唯一编码,例如电脑mac 123456
sign string 机具签名,联系技术约定机具型号签名所需参数
ver string 机具版本号 1.0
platform string 操作平台 ios

详细说明:

sign 签名说明

联系技术约定机具型号签名所需参数,比如约定 type=sl58 的签名参数 是  signkey=123456 ,signkey 并不等于商户加密秘钥;
那么sign 签名参照签名算法文档,先排序,后拼接md5加密signkey联系技术获取
实例:
sign =      md5(nonce_str=123456&service=behav.soft.off&sn=123&type=exe&ver=1.0&signkey=0811e63d91c2cc8a232d5ce16b5961xxx
最后
sign=81bce2cf7ffb2c46c6756cf7b3fd99de

请求的post即为
{
    "nonce_str": "123456",
    "service": "behav.soft.off",
    "sn": "123",
    "type: "exe",
    "ver: "1.0",
    "sign": "81bce2cf7ffb2c46c6756cf7b3fd99de",
}

返回示例:

                                {
    "service": "behav.soft.off",
    "ver": "",
    "type": "exe",
    "sn": "123",
    "version": "3.0",
    "charset": "UTF-8",
    "message": "SUCCESS",
    "status": "10000",
    "sign_type": "MD5",
    "sign": "13aba2d31294b1fbafec06e9c3ca6a59"
}
                            
参数名 描述 类型
service 机具行为,枚举值 string
ver 机具版本号 string
type 机具型号,联系技术约定机具型号枚举值 string
sn 机具唯一编码,例如电脑mac number
version 接口版本号,3.0 number
charset 接口字符编码,UTF-8 string
message 错误信息 string
status 错误状态 number
sign_type 签名方式,MD5 string
sign 签名字符串,参照签名方法 string

微信点餐行为

在线测试 在线浏览

请求方式:POST

请求地址:http://zhaoyin.lfwin.com/bsapi/behav/wxpay_order

Body参数名 类型 必需 描述 示例 e.g.
service string 接口名称 wxpay.order
apikey string 商家APIKEY,唯一标识,由服务商提供 00014005
nonce_str string 系统订单号,唯一值 123456
orderid string 系统订单号,唯一值,线下支付接口返回 201811101413410070098055
mch_orderid string 商户订单号,如果orderid跟mch_orderid同时存在,以orderid为准
order_time string 下单时间,时间戳,精确到秒,如果只传商户订单号,必须传下单时间
out_table_no string 桌位号,最大16位字符 T01
people_count string 消费人数 2
sub_openid string 消费者用户在sub_appid下的标识sub_openid ognpJ5BfHA6m9HN_MO-vDLH4yITM
sub_appid string 小程序/公众号appid,sub_appid跟sub_openid对应关系,并且appid跟微信支付商户号关联 wx0700ba769c455322
login_token string 登录票据,微信接口返回的登录票据 公众号,填写 access_token; 小程序,填写 session_key; 071oYFSN19sCH31AyNSN15QDSN1oYFSA
order_entry string 点餐入口,公众号:页面完整 URL,小程序:path 路径 http://www.example.com
dish_list string 菜品列表,详见 dish_list 对象列表,json字符串
sign string 签名,参照签名算法

详细说明:


dish_list 对象列表,json字符串 示例:
[{
"out_dish_no":"1",
"name":"
清汤锅底",
"price":6000,
"unit":"BY_SHARE",
"count":1,
"discount":100,
"type":"FAST_FOOD",
"priority":1,

"properties":
{"taste":"

","cuisine":"
","main_material":"
","ingredients":"
|辣椒||八角
","others":"有机|农家
"}
}]
  


   dish_list对象列表:

字段名

变量名

必填

类型

实例值

说明

商户菜品 ID

out_dish_no

String(16)

1

商户菜品 ID

菜品名称 name

name

String(128)

清汤锅底

菜品名称

菜品单价

price

Int

1

单位为分

菜品单位

unit

String(16)

BY_SHARE

BY_SHARE-按份
BY_WEIGHT-按重量

菜品数量

count

Float

1.5

菜品数量,保留小数点后 位有效数字

菜品折扣

discount

Int

100

菜品折扣,百分值,折填 80

菜品分类

type

String(32)

FAST_FOOD

菜品分类,如等。 参数
规定《菜品类型列表》

菜品优先级

priority

Int

1

当前菜品在服务商平台的顺序,值越小越靠前,取值(1~100

菜品属性

properties

object

 

详见 参数《菜品属性列表》



 菜品属性列表

字段名

变量名

属性值

 口味

taste 

辣 咸 甜 酸 香 苦 麻 鲜 

做法 

cuisine  

炒 蒸 烧 焖 炖 凉拌 烤 炸 煮 煎 火锅 烘焙 砂锅 卤 

主料 

main_material 

猪 牛 羊 鸡 鸭 蛋 其他肉类 鱼类 虾类 蟹类 贝类 其他水
产 茎叶类 根茎类 瓜果类 菌类 花朵类 豆类 豆制品 无杂粮
类 面类 小吃/甜饼 方便食品 鲜果类 干果类 药食两用 调味
品 油脂 糖/蜜饯 乳类 酒类 茶饮 

配料 

ingredients 

葱 姜 蒜 香菜 八角 香叶 花椒 

其他 

others 

农家 有机 进口 非转基因 纯天然 


菜品类型列表

字段名

变量名

 FAST_FOOD 

快餐 

DRINK 

饮品   

YOYO 

烘焙甜品 

BEIJING_CUISINE  

北京菜 

SICHUAN_CUISINE 

川菜  

DONGBEI_CUISINE 

东北菜 

SOUTHEAST_ASIAN_CUISINE 

东南亚菜 

SEAFOOD 

海鲜 

KOREAN_CUISINE 

韩国料理 

HUBEI_CUISINE 

湖北菜 

HOT_POT 

火锅 

JIANGZHE_CUISINE 

江浙菜 

SHANDONG_CUISINE 

鲁菜 

HALAL_FOOD 

清真菜 

JAPANESE_CUISINE 

日本菜 

BARBECUE 

烧烤 

NORTHWEST_CUISINE 

西北菜 

WESTERN_FOOD 

西餐 

HUNAN_CUISINE 

湘菜 

SNACK 

小吃 

XINJIANG_CUISINE 

新疆菜 

GUAGNDONG_CUISINE 

粤菜 

YUNNAN_CUISINE 

云南菜 

BUFFET 

自助餐 



返回示例:

                                错误返回:
{
    "version": "3.0",
    "charset": "UTF-8",
    "sign_type": "MD5",
    "status": "4000",
    "message": ":SYSTEM_ERROR,未知错误,sp_mchid,sub_mchid and sub_appid bind relation is invalid"
}
正确返回:
{
    "version": "3.0",
    "charset": "UTF-8",
    "message": "SUCCESS",
    "status": "10000",
    "sign_type": "MD5",
    "sign": ""
}

                            
参数名 描述 类型
version 接口版本号,3.0 string
charset 接口字符编码,UTF-8 string
message 错误信息 string
status 错误状态 string
sign_type 签名方式,MD5 string
sign 签名字符串,参照签名方法 string

接口DEMO

java语言

在线测试 在线浏览

请求方式:VIEW

请求地址:http://

详细说明:


返回示例:

                                HttpRequest.java 文件

import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStreamReader;
import java.io.PrintWriter;
import java.net.URL;
import java.net.URLConnection;
import java.util.List;
import java.util.Map;
 
public class HttpRequest {
  /**
   * 向指定URL发送GET方法的请求
   * 
   * @param url
   *      发送请求的URL
   * @param param
   *      请求参数,请求参数应该是 name1=value1&name2=value2 的形式。
   * @return URL 所代表远程资源的响应结果
   */
  public static String sendGet(String url, String param) {
    String result = "";
    BufferedReader in = null;
    try {
      String urlNameString = url + "?" + param;
      URL realUrl = new URL(urlNameString);
      // 打开和URL之间的连接
      URLConnection connection = realUrl.openConnection();
      // 设置通用的请求属性
      connection.setRequestProperty("accept", "*/*");
      connection.setRequestProperty("connection", "Keep-Alive");
      connection.setRequestProperty("user-agent",
          "Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1;SV1)");
      // 建立实际的连接
      connection.connect();
      // 获取所有响应头字段
      Map> map = connection.getHeaderFields();
      // 遍历所有的响应头字段
      for (String key : map.keySet()) {
        System.out.println(key + "--->" + map.get(key));
      }
      // 定义 BufferedReader输入流来读取URL的响应
      in = new BufferedReader(new InputStreamReader(
          connection.getInputStream()));
      String line;
      while ((line = in.readLine()) != null) {
        result += line;
      }
    } catch (Exception e) {
      System.out.println("发送GET请求出现异常!" + e);
      e.printStackTrace();
    }
    // 使用finally块来关闭输入流
    finally {
      try {
        if (in != null) {
          in.close();
        }
      } catch (Exception e2) {
        e2.printStackTrace();
      }
    }
    return result;
  }
 
  /**
   * 向指定 URL 发送POST方法的请求
   * 
   * @param url
   *      发送请求的 URL
   * @param param
   *      请求参数,请求参数应该是 name1=value1&name2=value2 的形式。
   * @return 所代表远程资源的响应结果
   */
  public static String sendPost(String url, String param) {
    PrintWriter out = null;
    BufferedReader in = null;
    String result = "";
    try {
      URL realUrl = new URL(url);
      // 打开和URL之间的连接
      URLConnection conn = realUrl.openConnection();
      // 设置通用的请求属性
      conn.setRequestProperty("accept", "*/*");
      conn.setRequestProperty("connection", "Keep-Alive");
      conn.setRequestProperty("user-agent",
          "Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1;SV1)");
      // 发送POST请求必须设置如下两行
      conn.setDoOutput(true);
      conn.setDoInput(true);
      // 获取URLConnection对象对应的输出流
      out = new PrintWriter(conn.getOutputStream());
      // 发送请求参数
      out.print(param);
      // flush输出流的缓冲
      out.flush();
      // 定义BufferedReader输入流来读取URL的响应
      in = new BufferedReader(
          new InputStreamReader(conn.getInputStream()));
      String line;
      while ((line = in.readLine()) != null) {
        result += line;
      }
    } catch (Exception e) {
      System.out.println("发送 POST 请求出现异常!"+e);
      e.printStackTrace();
    }
    //使用finally块来关闭输出流、输入流
    finally{
      try{
        if(out!=null){
          out.close();
        }
        if(in!=null){
          in.close();
        }
      }
      catch(IOException ex){
        ex.printStackTrace();
      }
    }
    return result;
  }  
}
--------------------------------------------------------------------------------------------------------------------------------------------------------------------------
HelloJava.java文件

public class HelloJava {

	public static void main(String[] args) {

		
		//发送 POST 请求
	    String sr=HttpRequest.sendPost("http://zhaoyin.lfwin.com/payapi/pay/qrcode", "service=pay.wxpay.qrcode&apikey=00014005&mch_orderid=0001400520180328153131000082&nonce_str=20180328153131&money=0.01&sign=672a56c450cabb60875989d3c25dbe82");
	    System.out.println(sr);

		 
	}


}





                            

php语言

在线测试 在线浏览

请求方式:VIEW

请求地址:http://

返回示例:

                                function curlGet($url,$data = ''){
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_FAILONERROR, false);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
    curl_setopt($ch, CURLOPT_POST, true);
    if(is_array($data)){
        $data=http_build_query($data);
    }
    curl_setopt($ch, CURLOPT_POSTFIELDS,$data);
    $headers = array('content-type: application/x-www-form-urlencoded;');
    curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
    $reponse = curl_exec($ch); curl_close($ch);
    return $reponse;
}
function paySign($params,$signkey){
        ksort($params);
        reset($params);
        $signPars='';
        foreach($params as $k => $v) {
            if(is_array($v)){
                $v=json_encode($v);
            }
            if("sign" != $k) {
                $signPars .= $k . "=" . $v . "&";
            }

        }
        $signPars .= "signkey=".$signkey;

        return md5($signPars);
    }
$url="http://zhaoyin.lfwin.com/payapi/pay/qrcode";

$data=array(
        "service"=>"pay.wxpay.qrcode",
         "apikey"=>"00014005",
         "nonce_str"=>"20180328153131",
          "money"=>"0.01",
    
    );
    $signkey='punr8ucu';
    $data["sign"]=paySign($data,$signkey);
    
   $return=curlGet($url,$data);
   var_dump(json_decode($return,true));





                            

C语言

在线测试 在线浏览

请求方式:VIEW

请求地址:http://

详细说明:

int   iRet, ilen;
char  szBuffer[1024], szData[200], szMd5Value[32+1];
char  szTerminalSN[40], szDeviceType[20], szInstKey[40];
char  sContent[1024];
char  *psData;
unsigned int  uiLength = 0;

//
memset(szTerminalSN,0,sizeof(szTerminalSN));
PubReadPopsecuSN(szTerminalSN);
strcpy(szInstKey,"xxxxxxxxxxxx");
strcpy(szDeviceType,"sl58");

memset((char*)sContent,0,sizeof(sContent));
uiLength = 0;
// 1. 计算MD5结果
psData = sContent;
sprintf(psData,"sn=%s&",szTerminalSN);  // 
psData += strlen(psData);
sprintf(psData,"type=%s&",szDeviceType);
psData += strlen(psData);
sprintf(psData,"signkey=%s",szInstKey);  // 
psData += strlen(psData);
memset(szData,0,sizeof(szData));
memset(szMd5Value,0,sizeof(szMd5Value));
PubGetMd5(sContent,strlen(sContent),szData);
PubBcdToAsc(szData,16,szMd5Value);
PubStringToLower(szMd5Value);

// 2. 凭凑报文体json格式
memset(szBuffer,0,sizeof(szBuffer));
psData = szBuffer;
sprintf(psData,"{\"sn\":\"%s\",",szTerminalSN); 
psData += strlen(psData);
sprintf(psData,"\"type\":\"%s\",",szDeviceType);
psData += strlen(psData);
sprintf(psData,"\"sign\":\"%s\"}\r\n",szMd5Value); 
psData += strlen(psData);
ilen = strlen(szBuffer);

//3. 凭凑http报文
memset((char*)sContent,0,sizeof(sContent));
uiLength = 0;
sprintf(psData,"POST /payapi/trans/sn HTTP/1.1\r\n");
psData += strlen(psData);
strcpy(psData,"cache-control: no-cache\r\n");  // 
psData += strlen(psData);
strcpy(psData,"Content-Type: application/json\r\n");  // 
psData += strlen(psData);
strcpy(psData,"Connection: Keep-Alive\r\n");  // 
psData += strlen(psData);
strcpy(psData,"User-Agent: Apache-HttpClient/4.1.1 (java 1.5)\r\n");  // 
psData += strlen(psData);
sprintf(psData,"Host:%s\r\n", "zhaoyin.lfwin.com");  // 
psData += strlen(psData);
sprintf(psData,"Content-Length:%d\r\n",ilen);  //
psData += strlen(psData);
strcpy(psData,"Accept: */*\r\n\r\n");  // 
psData += strlen(psData);
strcpy(psData,szBuffer);
psData += strlen(psData);
uiLength = strlen(sContent);

iRet = SendMessageToHost(sContent, uiLength);

签名校对

在线测试 在线浏览

请求方式:POST

请求地址:http://zhaoyin.lfwin.com/home/index/check_sign

Body参数名 类型 必需 描述 示例 e.g.
service string 接口参数 fuiou.wxpay.jspay
apikey string 接口参数 00014005
money string 接口参数 0.02
nonce_str string 接口参数 123456
sign string 接口参数 858c5cd6abecc39370d1e8776d3975fc

详细说明:

把要请求接口的参数键值对填入模拟请求,参数键值对可以自己添加
可以前往http://www.atool.org/httptest.php 参照接口文档要提交的参数,模拟请求该接口获取签名过程

返回示例:

                                {
    "请求待签名字符串,自然排序,并且末尾拼接加密key": "apikey=00014005&money=0.02&nonce_str=123456&service=fuiou.wxpay.jspay&signkey=punr8ucu",
    "md5小写32位待签名字符串": "md5(apikey=00014005&money=0.02&nonce_str=123456&service=fuiou.wxpay.jspay&signkey=punr8ucu)",
    "请求签名sign": "858c5cd6abecc39370d1e8776d3975fc",
    "请求参数": {
        "apikey": "00014005",
        "money": "0.02",
        "nonce_str": "123456",
        "service": "fuiou.wxpay.jspay",
        "sign": "858c5cd6abecc39370d1e8776d3975fc"
    },
    "--------------------------------------------------------": "--------------华丽分割线-----------------------------------------------",
    "返回示例(异步通知):": {
        "orderid": "201806051631000070051786",
        "trade_no": "4200000114201806054944938146",
        "paystatus": "1",
        "paymoney": "0.02",
        "pri_paymoney": "0.02",
        "order_time": "1528187460",
        "paytime": "1528187512",
        "mch_orderid": "",
        "notify_url": "http://www.clm177.com/notify.php",
        "sign": "2a96a4b0e1d6960b16bd5f470a698ee9"
    },
    "待验签字符串,自然排序,并且末尾拼接加密key:": "orderid=201806051631000070051786&trade_no=4200000114201806054944938146&paystatus=1&paymoney=0.02&pri_paymoney=0.02&order_time=1528187460&paytime=1528187512&mch_orderid=¬ify_url=http://www.clm177.com/notify.php&signkey=punr8ucu",
    "md5小写32位验签字符串:": " md5(orderid=201806051631000070051786&trade_no=4200000114201806054944938146&paystatus=1&paymoney=0.02&pri_paymoney=0.02&order_time=1528187460&paytime=1528187512&mch_orderid=¬ify_url=http://www.clm177.com/notify.php&signkey=punr8ucu)",
    "生成验签sign:": "2a96a4b0e1d6960b16bd5f470a698ee9",
    "验签:": "2a96a4b0e1d6960b16bd5f470a698ee9 是否跟返回示例中的sign相等2a96a4b0e1d6960b16bd5f470a698ee9"
}
                            

全局状态码

在线测试 在线浏览

请求方式:VIEW

请求地址:http://

详细说明:

接口返回状态码status如下,也可点击文档中  状态码 查看: