[金融魔方红包SDK.docxVIP

1.文档概述本文档针对商户使用接口模式接入魔方科技红包功能进行了详细的描述，商户端程序如需要进行开发可以此文档为依据。2.适用范围通过接口模式接入魔方科技红包功能的合作商户。3.调用方式接口采用http/https连接方式进行通讯。4.IP限制允许对接口的请求IP进行限制。商户在开通时可以向魔方科技提供一个或者多个固定IP用于做交易和查询。5.超时时间设定商户接收魔方科技接口应答的超时时间不得少于60s。6.单位说明接口中所有交易金额和手续费的货币种类均为人民币，并采用“分”为单位。7.域长度计算说明所有参数的长度均以字节为单位，每个中文汉字占三个字节，每个英文字母、字符或数字占一个字节。8.时间说明涉及到时间类型，如果是日期类型格式默认yyyy-MM-dd，如果是时间类型格式默认yyyy-MM-dd HH:mm:ss9.加密说明涉及到密码加密时，都需要用到秘钥进行加密，参考附件密码加密方法。10.签名说明1) 以md5作为签名算法2) 签名算法分两步：1. 参数按照字段名的ASCII码从小到大排序后；2. 将包含密钥的数据串进行MD5摘要计算，签名结果中的字母统一采用大写形式3) 假设通信密钥为3EDA7B432E238BAD1208BADC65E39B01，则签名sign为：sign=MD5(key1:value1|key2:value2|seckey:3EDA7B432E238BAD1208BADC65E39B01).toUpperCase 11.请求参数所有接口请求时需传递sign（签名字符串）和parterId（分配的商户id）获得用户令牌url：/api/v1/wallets/findUserToken.shtml请求类型:post参数： custuid：商户用户id parterId：商户id nickName:昵称 avatar:头像,非必填返回值： respstat：0000成功，其他失败 respmsg：失败时提示信息 userToken：用户令牌变更用户信息url：/api/v1/wallets/updateInfo.shtml请求类型:post参数： parterId：商户id userToken：用户令牌 nickName:昵称 avatar:头像,非必填返回值： respstat：0000成功，其他失败 respmsg：失败时提示信息实名认证接口url：/api/v1/wallets/certify.shtml请求类型:post参数： parterId：商户id userToken：用户令牌 realName:真实姓名 identityNo:身份证返回值： respstat：0000成功，其他失败 respmsg：失败时提示信息绑定银行卡接口（实名及绑卡同步，验证通过后台自动发送手机验证码)url：/api/v1/wallets/bindBankcardFullinfo.shtml请求类型:post参数： parterId：商户id userToken：用户令牌 realName:真实姓名 identityNo:身份证 bankNo:所属银行 bankCardNo:银行卡 mobileNo:手机号返回值： respstat：0000成功，其他失败 respmsg：失败时提示信息 mobileToken：当respstat=0000时，返回手机号信息令牌再次绑卡（绑定多张银行卡、验证通过后台自动发送手机验证码)url：/api/v1/wallets/bindBankcard.shtml请求类型:post参数： parterId：商户id userToken：用户令牌 bankNo:所属银行 bankCardNo:银行卡 mobileNo:手机号返回值： respstat：0000成功，其他失败 respmsg：失败时提示信息 mobileToken：当respstat=0000时，返回手机号信息令牌验证银行手机验证码url：/api/v1/wallets/bindBankcardVailCode.shtml请求类型:post参数： parterId：商户id userToken：用户令牌 mobileToken：银行手机验证码信息令牌返回值： respstat：0000成功，其他失败 respmsg：失败时提示信息充值接口url：/api/v1/wallets/recharge.shtml请求类型:post参数： parterId：商户id