麒麟付接口文档
测试账户
123472
pa2guxwbibjg8jdmvvny1ezuvmy2eilv
创建支付订单
1 请求地址
2 请求方式：HTTP post / get
4 请求参数:
| 字段名称 | 字段说明 | 类型 | 必填 | 备注 |
|---|---|---|---|---|
| version | 版本号 | string | Y | 固定值 1.0 |
| customerid | 商户号 | int | Y | 例:10000 |
| sdorderno | 商户订单号不超过20 | string | Y | 201758985234234234 |
| total_fee | 付款金额 | float | Y | 1.00 |
| paytype | 支付类型 | string | Y | 详细看附录1 |
| bankcode | 银行编号 | string | Y | 网银直连不可为空，其他支付方式可为空详见附录2 |
| notifyurl | 异步通知 | string | Y | 服务器通知 |
| returnurl | 同步 | string | Y | 浏览器跳转 |
| remark | 附加参数 | string | N | 按参数返回 不可超过30字 |
| sign | 加密字符 | string | Y | MD5加密 看下面5加密方法 |
5 MD5加密方法:
{value}要替换成接收到的值，{apikey}要替换成平台分配的接入密钥，可在商户后台获取
version={value}&customerid={value}&total_fee={value}&sdorderno={value}¬ifyurl={value}&returnurl={value}&apikey
使用md5签名上面拼接的字符串即可生成小写的32位密文
MD5加密实例:
version=1.0&customerid=10886&total_fee=1.00&sdorderno=201715451541212¬ifyurl=http://www.maxinji.com/demo/notifyurl.php&returnurl=http://www.maxinji.com/demo/returnurl.php&1b5745912dd5295f1be2631e0a9b8ed6017ddde1
附录1:paytype 参数值说明
| 支付方式名称 | 支付编号 |
|---|---|
| 支付宝扫码 | alipay |
| 微信扫码 | weixin |
| 支付宝wap | alipaywap |
| 微信wap | wxh5 |
| 在线网银 | bank |
| 快捷支付 | kuaijie |
附录2:
当paytype为bank时，bankcode为以下银行取值
| 支付方式名称 | 支付编号 |
|---|---|
| 中国工商银行 | ICBC |
| 中国农业银行 | ABC |
| 中国银行 | BOCSH |
| 建设银行 | CCB |
| 招商银行 | CMB |
| 浦发银行 | SPDB |
| 广发银行 | GDB |
| 交通银行 | BOCOM |
| 邮政储蓄银行 | PSBC |
| 中信银行 | CNCB |
| 民生银行 | CMBC |
| 光大银行 | CEB |
| 华夏银行 | HXB |
| 兴业银行 | CIB |
| 上海银行 | BOS |
| 上海农商 | SRCB |
| 平安银行 | PAB |
| 北京银行 | BCCB |
异步通知回调
1 通知方式：post
2 参数说明:
| 参数 | 参数说明 | 类型 | 备注 |
|---|---|---|---|
| status | 订单状态 | int(1) | 1成功 0失败 |
| customerid | 商户编号 | int(8) | |
| sdpayno | 平台订单号 | varchar(20) | |
| sdorderno | 商户订单号 | varchar(20) | |
| total_fee | 交易金额 | decimal(10,2) | 最多两位小数 |
| paytype | 支付类型 | varchar(20) | |
| remark | 订单备注说明 | varchar(50) | 原样返回 |
| sign | md5验证签名 | varchar(32) | 参照签名方法 |
3 md5签名方法:
{value}要替换成接收到的值，{apikey}要替换成平台分配的接入密钥，可在商户后台获取
customerid={value}&status={value}&sdpayno={value}&sdorderno={value}&total_fee={value}&paytype={value}&{apikey}
使用md5签名上面拼接的字符串即可生成小写的32位密文
4收到通知回复
异步通知会在用户付款后立刻通知商户网站 商户收到消息后需要输出相关字符 我们服务器就不会在发送通知为检测到 success 我们服务器会 在第一次 30秒 第二次 5分钟 第三次 10分钟 后通知
success 代表成功 收到后不会再次发送通知
同步通知跳转
1 通知方式：get
2 参数说明:
| 参数 | 参数说明 | 类型 | 备注 |
|---|---|---|---|
| status | 订单状态 | int(1) | 1成功 0失败 |
| customerid | 商户编号 | int(8) | |
| sdpayno | 平台订单号 | varchar(20) | |
| sdorderno | 商户订单号 | varchar(20) | |
| total_fee | 交易金额 | decimal(10,2) | 最多两位小数 |
| paytype | 支付类型 | varchar(20) | |
| remark | 订单备注说明 | varchar(50) | 原样返回 |
| sign | md5验证签名 | varchar(32) | 参照签名方法 |
3 md5签名方法:
{value}要替换成接收到的值，{apikey}要替换成平台分配的接入密钥，可在商户后台获取
customerid={value}&status={value}&sdpayno={value}&sdorderno={value}&total_fee={value}&paytype={value}&{apikey}