API开发文档

API开发文档简介
本文阅读对象:使用云龙支付金融服务集团商户自服务系统的技术架构师、研发工程师、系统运维工程师。通过本文档,商户可了解 云龙支付 接入的技术、接入的产品业务、接入的流程、接入规范等信息,以便于商户顺利完成接入工作。
API接口申请方式
如果确定要使用云龙支付的在线支付功能,商家需遵守国家法律法规规定,经营内容合法合规,审核通过了,就可以正常支付。
API协议接入规则
传输方式:HTTP
请求方式:POST
签名算法:MD5
字符编码:UTF-8
API发起付款接口
URL网关提交地址:http://(隐藏)/gateway.aspx 请登录后台查看
请求参数说明
字段名变量名是否可空加入签名描述
商户IDparter云龙支付所创建的商户ID
支付方式type查看银行支付编码
订单金额value精确到小数点后两位,例如10.28
商户订单号orderid商户系统订单号,该值需在商户系统内唯一
异步通知callbackurl支付成功后回调地址
同步通知hrefbackurl支付成功后前台跳转地址,可为空
用户IPpayerIp用户支付IP地址,例如127.0.0.1
备注消息attach备注信息,原样返回
MD5签名sign32位小写MD5签名值,GB2312编码
MD5签名方法
MD5拼接:
$md5String="parter={$parter}&type={$type}&value={$value}&orderid={$orderid}&callbackurl={$callbackurl}$key";
$sign=md5($md5String);
上行为PHP语言方法拼接,其他语言可能不同,key 为云龙支付商户签名密钥。
API支付通知接口
通知类型:服务器异步通知(callbackurl)
请求方式:GET
当订单支付成功后 云龙支付 会立即向你的服务器发起回调通知
字段名变量名加入签名描述
商户订单号orderid支付成功后商户系统传入的orderid
订单结果opstate0:支付成功 -1 请求参数无效 -2 签名错误
订单金额ovalue订单实际支付金额,单位(元)
MD5签名sign32位小写MD5签名值,GB2312编码
订单号sysorderid此次订单过程中接口系统内的订单Id
订单时间systime订单结束时间:如2014/02/15 18:42:28
备注信息attach提交支付的attach原样返回
订单结果说明msg订单结果说明
MD5签名方法
MD5拼接:
$signStr="orderid={$orderid}&opstate={$opstate}&ovalue={$ovalue}$key";
$mysign=md5($signStr);
上行为PHP语言方法拼接,其他语言可能不同,key 为云龙支付商户签名密钥。
商户收到通知参数,在校验通过后需要给云龙支付接口返回一个字符串 opstate=0 的结果,不要添加其他任何字符串,否则会重复通知5次。
API订单查询接口
URL网关订单查询地址:http://(隐藏)/Query.do?Order=order
请求方式:GET
注意: Order 里面的 order 为回调接口系统内的 sysorderid 订单Id
接口返回:
{"status": "not_exist"}订单不存在!
{"status": "new"}新订单,未支付!
{"status": "success"}订单已支付!
API银行支付编码
银行名称银行编码
支付宝扫码alipay
支付宝H5alipaywap
微信扫码wechat
微信H5wechatwap
银行卡转银行卡bankzbank
Demo下载
支持语言: PHP,ASP,JAVA,ASP.NET
传输方式:为保证交易安全性,建议采用HTTPS传输
编写语言下载地址
PHP下载地址
JAVA点击下载
C#点击下载
ASP点击下载
onlineServer