金融魔方红包SDK.docx

《金融魔方红包SDK.docx》由会员上传分享，免费在线阅读，更多相关内容在教育资源-天天文库。

1、1.文档概述本文档针对商户使用接口模式接入魔方科技红包功能进行了详细的描述，商户端程序如需要进行开发可以此文档为依据。2.适用范围通过接口模式接入魔方科技红包功能的合作商户。3.调用方式接口采用http/https连接方式进行通讯。4.IP限制允许对接口的请求IP进行限制。商户在开通时可以向魔方科技提供一个或者多个固定IP用于做交易和查询。5.超时时间设定商户接收魔方科技接口应答的超时时间不得少于60s。6.单位说明接口中所有交易金额和手续费的货币种类均为人民币，并采用“分”为单位。7.域长度计算说明所有参数的长度均以字节为单位，每个中文汉字占三个字节，每个英文字母、字符或

2、数字占一个字节。8.时间说明涉及到时间类型，如果是日期类型格式默认yyyy-MM-dd，如果是时间类型格式默认yyyy-MM-ddHH:mm:ss9.加密说明涉及到密码加密时，都需要用到秘钥进行加密，参考附件密码加密方法。10.签名说明1)以md5作为签名算法2)签名算法分两步：1.参数按照字段名的ASCII码从小到大排序后；2.将包含密钥的数据串进行MD5摘要计算，签名结果中的字母统一采用大写形式3)假设通信密钥为3EDA7B432E238BAD1208BADC65E39B01，则签名sign为：sign=MD5(key1:value1

3、key2:value2

4、secke

5、y:3EDA7B432E238BAD1208BADC65E39B01).toUpperCase11.请求参数所有接口请求时需传递sign（签名字符串）和parterId（分配的商户id）获得用户令牌url：/api/v1/wallets/findUserToken.shtml请求类型:post参数：custuid：商户用户idparterId：商户idnickName:昵称avatar:头像,非必填返回值：respstat：0000成功，其他失败respmsg：失败时提示信息userToken：用户令牌变更用户信息url：/api/v1/wallets/updateInfo

6、.shtml请求类型:post参数：parterId：商户iduserToken：用户令牌nickName:昵称avatar:头像,非必填返回值：respstat：0000成功，其他失败respmsg：失败时提示信息实名认证接口url：/api/v1/wallets/certify.shtml请求类型:post参数：parterId：商户iduserToken：用户令牌realName:真实姓名identityNo:身份证返回值：respstat：0000成功，其他失败respmsg：失败时提示信息绑定银行卡接口（实名及绑卡同步，验证通过后台自动发送手机验证码)url：/a

7、pi/v1/wallets/bindBankcardFullinfo.shtml请求类型:post参数：parterId：商户iduserToken：用户令牌realName:真实姓名identityNo:身份证bankNo:所属银行bankCardNo:银行卡mobileNo:手机号返回值：respstat：0000成功，其他失败respmsg：失败时提示信息mobileToken：当respstat=0000时，返回手机号信息令牌再次绑卡（绑定多张银行卡、验证通过后台自动发送手机验证码)url：/api/v1/wallets/bindBankcard.shtml请求类型

8、:post参数：parterId：商户iduserToken：用户令牌bankNo:所属银行bankCardNo:银行卡mobileNo:手机号返回值：respstat：0000成功，其他失败respmsg：失败时提示信息mobileToken：当respstat=0000时，返回手机号信息令牌验证银行手机验证码url：/api/v1/wallets/bindBankcardVailCode.shtml请求类型:post参数：parterId：商户iduserToken：用户令牌mobileToken：银行手机验证码信息令牌返回值：respstat：0000成功，其他失败r

9、espmsg：失败时提示信息充值接口url：/api/v1/wallets/recharge.shtml请求类型:post参数：parterId：商户iduserToken：用户令牌bankCardNo：用户银行卡amount：充值金额，单位分aesTranPwd：基于分配的秘钥，aes加密后传递返回值：respstat：0000成功，其他失败respmsg：失败时提示信息赎回取现接口url：/api/v1/wallets/redeem.shtml请求类型:post参数：parterId：商户iduserToken