API开发文档

API开发文档简介
本文阅读对象:使用M1支付金融服务集团商户自服务系统的技术架构师、研发工程师、系统运维工程师。通过本文档,商户可了解 M1支付 接入的技术、接入的产品业务、接入的流程、接入规范等信息,以便于商户顺利完成接入工作。
API接口申请方式
M1支付开户在 https://www.m1m1.cn 官方进行开户,开户邀请码可联系(客服QQ:82248126)获取。
如果确定要使用M1支付的在线支付功能,商家需遵守国家法律法规规定,经营内容合法合规,审核通过了,就可以正常支付。
API协议接入规则
传输方式:HTTP
请求方式:POST
签名算法:MD5
字符编码:UTF-8
API发起付款接口
URL网关提交地址:http://(隐藏)/gateway.aspx 请登录后台查看
请求参数说明
字段名变量名是否可空加入签名描述
商户IDparterM1支付所创建的商户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 为M1支付商户签名密钥。
API支付通知接口
通知类型:服务器异步通知(callbackurl)
请求方式:GET
当订单支付成功后 M1支付 会立即向你的服务器发起回调通知
字段名变量名加入签名描述
商户订单号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 为M1支付商户签名密钥。
商户收到通知参数,在校验通过后需要给M1支付接口返回一个字符串 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
微信公众号wechatgzh
京东扫码jdcode
京东H5jdwap
QQ扫码qqcode
QQH5qqwap
云闪付扫码bankcode
云闪付H5bankwap
网银快捷支付bankpay
百度钱包baidu
中国工商银行ICBC
中国农业银行ABC
中国银行BOC
建设银行CCB
招商银行CMB
浦发银行SPDB
广发银行GDB
邮政储蓄银行PSBC
中信银行ECITIC
民生银行CMBC
光大银行CEBB
华夏银行HXB
兴业银行CIB
平安银行SPABANK
交通银行BCOM
北京银行BOB
上海银行SHB
Demo下载
支持语言: PHP,ASP,JAVA,ASP.NET
传输方式:为保证交易安全性,建议采用HTTPS传输
编写语言下载地址
PHP下载地址
JAVA点击下载
C#点击下载
ASP点击下载
onlineServer