爱刷卡包API接口文档
1.商家url:
|
${merchant_url}(商户url描述示例http://xxxx.com) |
2.请求方式:
|
application/json post请求 |
3.加密方式: |
请求参数字符串链接排序,A-Z排序加卡密匙MD5加密 备注:密匙放置在请求Request Header
signature(卡密匙):a22641417fbd87b76b25bbcaabc82731 MD5签名字符串示例 待MD5签名字符串: appkey=0781F0CD5CA28464AD147F02AD8D09E4& cardNumber=1608 509641502919&mouble=13811111211&3bb92c78 cbe89c571e3ac7fb61cdfeffMD5签名后字符串:a22641 417fbd87b76b25bbcaabc82731 |
基础接口:
1. 申请卡接口:此接口是用于用户申请卡,商户返回卡号和卡有效期。
接口调用请求说明 |
http请求方式: POST ${merchant_url}/aishua/api /1.0/appliedClaca |
参数说明 : 参数 appkey Mouble 返回数据 数据示例: {"ver":"1.0.0000","ret":true,"errmsg":"", "errcode":0, "data":{"validityPeriod":"2018-06-30
00:00:00 ","cardNumber":"34474107662425769"}} |
说明 调用接口凭证 用户手机号 |
返回说明:
参数名 |
描述 |
Ver |
版本 |
Ret |
成功/失败 |
errmsg, |
异常错误描述 |
errcode |
异常错误编号 |
data |
数据 |
validityPeriod |
有效期至 |
cardNumber |
卡号 |
2. 复制卡接口
:
接口调用请求说明 http请求方式: POST ${merchant_url}/aishua/api/1.0/copyClaca |
参数说明:
参数 |
说明 |
appkey |
调用接口凭证 |
mouble |
用户手机号 |
cardnumber |
卡号 |
返回数据
数据示例: {"ver":"1.0.0000","ret":true,"errmsg":"","errcode":0,"data": {"validityPeriod":"2018-06-30
00:00: 00","cardNumber":"34474107662425769"}} |
返回说明:
参数名 |
描述 |
Ver |
版本 |
Ret |
成功/失败 |
errmsg, |
异常错误描述 |
errcode |
异常错误编号 |
data |
数据 |
validityPeriod |
有效期至 |
cardNumber |
卡号 |
3. 消费接口:
接口调用请求说明 http请求方式: POST ${merchant_url}/aishua/api/1.0/consumption |
参数说明:
参数 |
说明 |
appkey |
调用接口凭证 |
mouble |
用户手机号 |
cardnumber |
卡号 |
consumptionTime |
消费时间 |
deviceIdentification; |
设备标识 |
返回数据
数据示例: {"ver":"1.0.0000","ret":true,"errmsg":"","errcode":0,"data":null} |
返回说明:
参数名 |
描述 |
Ver |
版本 |
Ret,. |
成功/失败 |
errmsg, |
异常错误描述 |
errcode |
异常错误编号 |
data |
数据 |
异常错误编号errcode
-1.未知异常 |
-2.安全校验错误 |
-3.该手机号已被注册 |
-4.卡片已存在 |
-5.卡过期/失效 |
-6.该卡不存在 |
-7.该手机号未注册 |
SDKdemo下载:HTTP://XXXXXXXXXXXXXX |