千应网络接口SDK文档

千应网络

第一章 文档描述

1、文档说明:

本文档用于指导千应商户实现与千应支付接口的顺利对接。请技术人员详读本文档。

2、阅读对象:

商户开发人员。
湖南千应网络技术有限公司 相关技术人员。

第二章 支付接口定义

1、上行接口(商户系统发起请求)

1、接入URL:https://www.qianyingnet.com/pay (接口地址)

2、接入方式:GET / POST(推荐)

3、请求协议参数:

参数含义 参数名 可空 加签名 说明
银行类型 type N Y 支付宝通道:101 微信通道:102
金额 m N Y 单位元(人民币),正整数(不能带小数,最小支付金额为1)
商户订单号 orderid N Y 商户系统订单号,该订单号将作为千应接口的返回数据。该值需在商户系统内唯一
下行异步通知地址 callbackurl N Y 下行异步通知过程的返回地址,必须是有效网址,且不带参数
下行同步跳转地址(成功) gotrue Y N 下行同步通知过程的返回地址(在支付完成后千应接口将会跳转到的商户 系统连接地址)。该参数必须指定,并且网址是可以访问的! 注:若提交值无该参数,或者该参数值为空,则在支付完成后,用户将停留在千应接口系统提示支付成功的页面。
下行同步通知地址(失败) gofalse Y N 下行同步通知过程的返回地址(在支付失败后千应接口将会跳转到的商户系统连接地址)。该参数必须指定,并且网址是可以访问的!
编码 charset Y N 编码 (建议UTF-8)
备注消息 token Y N 备注信息,下行中会原样返回。若该值包含中文,请注意编码
MD5签名 sign N - 32位小写MD5签名值 假设商户Id为1080 加密结果为 928f7bcdcd08869cc44c1bf24e7abec6则表示MD5加密正常。
钥匙 key 商户签名
请求提交示例(支付宝):

https://www.qianyingnet.com/pay?uid=2&type=101&m=1&orderid=aea31a79b73446bbbc1ad6c4f19d99bb&callbackurl=http://localhost:13508/pay/callback1&sign=79AC1F9AF712A6D913CCF82B555FE86A&gofalse=/web/recharge&gotrue=/web/index&charset=utf-8&token=%E5%95%86%E6%88%B7%E4%BD%99%E9%A2%9D%E5%85%85%E5%80%BC&ts=21227843


请求提示示例(微信):

https://www.qianyingnet.com/pay?uid=2&type=102&m=1&orderid=aea31a79b73446bbbc1ad6c4f19d99bb&callbackurl=http://localhost:13508/pay/callback1&sign=79AC1F9AF712A6D913CCF82B555FE86A&gofalse=/web/recharge&gotrue=/web/index&charset=utf-8&token=%E5%95%86%E6%88%B7%E4%BD%99%E9%A2%9D%E5%85%85%E5%80%BC&ts=21227843

2、下行通知接口(千应网发起请求)

1、接入URL:过程1中请求参数callbackurl值

2、接入方式:GET方式

3、请求协议参数:

表2 下行过程请求协议参数说明
参数名 参数 加入签名 说明
商户订单号 oid Y 上行过程中商户系统传入的唯一订单号。
订单结果 下行异步通知操作结果状态 status Y 订单状态 0未付款;1付款成功; 2超时未付款失效;3已删除;4异常; 5下发成功,订单正常完成;6补单; 7由于网关掉线等导致的失效(这种情况要尽量避免,因为极可能掉单);8退款
订单金额 m Y 订单实际支付金额,单位元
MD5签名 sign - 32位小写MD5签名值,请注意编码
千应订单号 oidMy N 此次订单过程中千应接口系统内的订单Id
收款交易号 oidPay N 收款方的订单号(例如支付宝交易号)
千应订单时间 time N 此次订单过程中千应接口系统内的订单结束时间。
备注消息 token N 备注信息,上行中token原样返回
订单结果说明 msg N 订单结果说明
MD5签名 无参数 本表中orderid到m的顺序加商户密钥。具体MD5签名源串及格式如下: oid={0}&status={1}&m={2}{key} 其中,key为商户签名。

第三章 测试

商户登录地址:https://www.qianyingnet.com/
测试用户名:请自行注册
编码测试,请参照最新Demo程序(含.NET【C#】 / PHP /JSP 版本)