爱刷卡包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