小程序台卡技术方案 2018-09-05
2018-09-06 本文已影响0人
弡_Qin
1 常规功能
进入小程序（支付宝、微信规则一致）
小程序进入机制是在管理后台配置规则，（例：https://apis.lcsw.cn/mini/minipay），只要二维码链接符合配置规则就可以跳转到小程序。
获取用户信息
进入小程序后，会进行授权获取用户唯一标识user_id(微信为openid和uuionid)，并根据台卡信息通过接口获取商户信息及用户信息。
1.如果开通会员则包含会员（会员id，会员名称，及会员激活状态）。
2.如果是新用户则根据用户open_id和授权或得到的用户名服务端生成会员信息同同商户信息一并返回。
小程序进入流程.jpg
商户发起支付
使用台卡的支付流程逻辑
2 会员功能
会员激活.jpg
会员支付.jpg
会员激活:
- URL：
/miniprogram/100/member/activate - Method：
POST
请求参数
| 参数名称 | 类型 | 长度 | 必填 | 说明 |
|---|---|---|---|---|
| merchant_no | String | 15 | Y | 商户号 |
| terminal_no | String | 8 | Y | 终端号 |
| terminal_trace | String | 32 | Y | 终端流水号 |
| open_id | String | 16 | N | 获取微信授权用户id、支付宝用户id |
| user_name | String | 30 | Y | 用户名 |
| user_phone | String | 30 | Y | 手机号 |
| user_ birthday | String | 8 | Y | 生日 |
| auth_code | String | 4 | Y | 验证码 |
| key_sign | String | 32 | Y | 传参字典序后，拼接令牌(access_token)再MD5加密 |
返回参数
| 参数名称 | 类型 | 长度 | 必填 | 说明 |
|---|---|---|---|---|
| return_code | String | 2 | Y | 业务响应码，01成功、02失败 |
| return_msg | String | 128 | Y | 业务响应描述 |
| result_code | String | 2 | Y | 业务处理响应码，01成功、02失败 |
| terminal_trace | String | 32 | Y | 请求流水号 |
| user_memberId | String | 8 | Y | 会员id |
| card_num | String | 11 | Y | 卡号 |
| is_activate | String | 2 | Y | 是否激活 0未激活，1已激活，2未设置密码 |
| key_sign | String | 32 | Y | 传参字典序后，拼接令牌(access_token)再MD5加密 |
获取商户优惠信息
- URL：
/miniprogram/100/member/activityinfo - Method：
POST
请求参数
| 参数名称 | 类型 | 长度 | 必填 | 说明 |
|---|---|---|---|---|
| activity_type | String | 4 | Y | 1充值优惠，2满减优惠 |
| user_memberId | String | 8 | Y | 会员id |
| card_num | String | 11 | Y | 卡号 |
| merchant_no | String | 15 | Y | 商户号 |
返回参数
| 参数名称 | 说明 |
|---|---|
| list | 商户充值优惠列表 |
list_json对应参数
| 参数名称 | 说明 |
|---|---|
| money | 充值金额 |
| bonus | 赠送金额 |
| id | 优惠信息id |
设置会员密码
- URL：
/miniprogram/100/member/updatepassword - Method：
POST
请求参数
| 参数名称 | 类型 | 长度 | 必填 | 说明 |
|---|---|---|---|---|
| merchant_no | String | 15 | Y | 商户号 |
| terminal_no | String | 8 | Y | 终端号 |
| terminal_trace | String | 32 | Y | 终端流水号 |
| open_id | String | 16 | N | 获取微信授权用户id、支付宝用户id |
| user_memberId | String | 30 | Y | 会员id |
| card_num | String | 11 | Y | 卡号 |
| password | String | 32 | Y | 设置密码 |
| key_sign | String | 32 | Y | 传参字典序后，拼接令牌(access_token)再MD5加密 |
返回参数
| 参数名称 | 类型 | 长度 | 必填 | 说明 |
|---|---|---|---|---|
| return_code | String | 2 | Y | 业务响应码，01成功、02失败 |
| return_msg | String | 128 | Y | 业务响应描述 |
| result_code | String | 2 | Y | 业务处理响应码，01成功、02失败 |
| terminal_trace | String | 32 | Y | 请求流水号 |
| key_sign | String | 32 | Y | 传参字典序后，拼接令牌(access_token)再MD5加密 |
修改会员密码
- URL：
/miniprogram/100/member/changepassword - Method：
POST
请求参数
| 参数名称 | 类型 | 长度 | 必填 | 说明 |
|---|---|---|---|---|
| open_id | String | 16 | N | 获取微信授权用户id、支付宝用户id |
| user_memberId | String | 30 | Y | 会员id |
| card_num | String | 11 | Y | 卡号 |
| auth_code | String | 11 | Y | 验证码 |
| password | String | 32 | Y | 设置密码 |
| key_sign | String | 32 | Y | 传参字典序后，拼接令牌(access_token)再MD5加密 |
返回参数
| 参数名称 | 类型 | 长度 | 必填 | 说明 |
|---|---|---|---|---|
| return_code | String | 2 | Y | 业务响应码，01成功、02失败 |
| return_msg | String | 128 | Y | 业务响应描述 |
| result_code | String | 2 | Y | 业务处理响应码，01成功、02失败 |
| terminal_trace | String | 32 | Y | 请求流水号 |
| key_sign | String | 32 | Y | 传参字典序后，拼接令牌(access_token)再MD5加密 |
会员充值
- URL：
/miniprogram/100/member/recharge - Method：
POST
请求参数
| 参数名称 | 类型 | 长度 | 必填 | 说明 |
|---|---|---|---|---|
| merchant_no | String | 15 | Y | 商户号 |
| terminal_no | String | 8 | Y | 终端号 |
| terminal_trace | String | 32 | Y | 终端流水号 |
| terminal_time | String | 14 | Y | 终端交易时间，yyyyMMddHHmmss，全局统一时间格式 |
| open_id | String | 16 | N | 获取微信授权用户id、支付宝用户id |
| user_memberId | String | 30 | Y | 会员id |
| card_num | String | 11 | Y | 卡号 |
| recharge_money | String | 10 | Y | 充值金额 |
| key_sign | String | 32 | Y | 传参字典序后，拼接令牌(access_token)再MD5加密 |
返回参数
| 参数名称 | 类型 | 长度 | 必填 | 说明 |
|---|---|---|---|---|
| return_code | String | 2 | Y | 业务响应码，01成功、02失败 |
| return_msg | String | 128 | Y | 业务响应描述 |
| result_code | String | 2 | Y | 业务处理响应码，01成功、02失败 |
| terminal_trace | String | 32 | Y | 请求流水号 |
| is_activate | String | 2 | Y | 是否激活 0未激活，1已激活，2未设置密码 |
| total_money | String | 10 | Y | 总金额 |
| key_sign | String | 32 | Y | 传参字典序后，拼接令牌(access_token)再MD5加密 |
会员信息查询
- URL：
/miniprogram/100/member/member_info - Method：
POST
请求参数
| 参数名称 | 类型 | 长度 | 必填 | 说明 |
|---|---|---|---|---|
| merchant_no | String | 15 | Y | 商户号 |
| terminal_no | String | 8 | Y | 终端号 |
| terminal_trace | String | 32 | Y | 终端流水号 |
| terminal_time | String | 14 | Y | 终端交易时间，yyyyMMddHHmmss，全局统一时间格式 |
| open_id | String | 16 | N | 获取微信授权用户id、支付宝用户id |
| user_memberId | String | 30 | Y | 会员id |
| key_sign | String | 32 | Y | 传参字典序后，拼接令牌(access_token)再MD5加密 |
返回参数
| 参数名称 | 类型 | 长度 | 必填 | 说明 |
|---|---|---|---|---|
| return_code | String | 2 | Y | 业务响应码，01成功、02失败 |
| return_msg | String | 128 | Y | 业务响应描述 |
| result_code | String | 2 | Y | 业务处理响应码，01成功、02失败 |
| terminal_trace | String | 32 | Y | 请求流水号 |
| is_activate | String | 2 | Y | 是否激活 0未激活，1已激活，2未设置密码 |
| total_money | String | 10 | Y | 总金额 |
| user_name | String | 30 | Y | 会员名称 |
| card_num | String | 11 | Y | 卡号 |
| key_sign | String | 32 | Y | 传参字典序后，拼接令牌(access_token)再MD5加密 |
会员卡消费记录
- URL：
/miniprogram/100/member/tradedetail_all - Method：
POST
请求参数
| 参数名称 | 类型 | 长度 | 必填 | 说明 |
|---|---|---|---|---|
| merchant_no | String | 15 | Y | 商户号 |
| terminal_no | String | 8 | Y | 终端号 |
| terminal_trace | String | 32 | Y | 终端流水号 |
| page_id | String | 11 | Y | 初始值为0 |
| user_memberId | String | 30 | Y | 会员id |
| card_num | String | 11 | Y | 卡号 |
| key_sign | String | 32 | Y | 传参字典序后，拼接令牌(access_token)再MD5加密 |
返回参数
| 参数名称 | 类型 | 长度 | 必填 | 说明 |
|---|---|---|---|---|
| return_code | String | 2 | Y | 业务响应码，01成功、02失败 |
| return_msg | String | 128 | Y | 业务响应描述 |
| result_code | String | 2 | Y | 业务处理响应码，01成功、02失败 |
| terminal_trace | String | 32 | Y | 请求流水号 |
| list_json | String | - | Y | 分页记录JSON字符串，并用于签名验证 |
| current_pageid | String | 11 | Y | 页码：初始值为0 |
| total_page | String | 11 | Y | 总页数 |
| total_size | String | 11 | Y | 总数据条数 |
| key_sign | String | 32 | Y | 传参字典序后，拼接令牌(access_token)再MD5加密 |
list_json对应参数
| 参数名称 | 类型 | 长度 | 必填 | 说明 |
|---|---|---|---|---|
| id | String | 8 | Y | id |
| pay_status_code | String | 3 | Y | 交易状态 |
| out_trade_no | String | 32 | Y | 交易订购单号 |
| total_fee | String | 32 | Y | 交易金额 |
| balance | String | 32 | Y | 余额 |
| settle_time | String | 13 | Y | 结算处理时间：yyyy-MM-dd HH:mm:ss |
会员卡充值记录
- URL：
/miniprogram/100/member/rechargedetail_all - Method：
POST
请求参数
| 参数名称 | 类型 | 长度 | 必填 | 说明 |
|---|---|---|---|---|
| merchant_no | String | 15 | Y | 商户号 |
| terminal_no | String | 8 | Y | 终端号 |
| terminal_trace | String | 32 | Y | 终端流水号 |
| page_id | String | 11 | Y | 初始值为0 |
| user_memberId | String | 30 | Y | 会员id |
| card_num | String | 11 | Y | 卡号 |
| key_sign | String | 32 | Y | 传参字典序后，拼接令牌(access_token)再MD5加密 |
返回参数
| 参数名称 | 类型 | 长度 | 必填 | 说明 |
|---|---|---|---|---|
| return_code | String | 2 | Y | 业务响应码，01成功、02失败 |
| return_msg | String | 128 | Y | 业务响应描述 |
| result_code | String | 2 | Y | 业务处理响应码，01成功、02失败 |
| terminal_trace | String | 32 | Y | 请求流水号 |
| list_json | String | - | Y | 分页记录JSON字符串，并用于签名验证 |
| current_pageid | String | 11 | Y | 页码：初始值为0 |
| total_page | String | 11 | Y | 总页数 |
| total_size | String | 11 | Y | 总数据条数 |
| key_sign | String | 32 | Y | 传参字典序后，拼接令牌(access_token)再MD5加密 |
list_json对应参数
| 参数名称 | 类型 | 长度 | 必填 | 说明 |
|---|---|---|---|---|
| id | String | 8 | Y | id |
| pay_status_code | String | 3 | Y | 交易状态 |
| out_trade_no | String | 32 | Y | 交易订购单号 |
| channel_trade_no | String | 32 | Y | 交易订购 |
| total_fee | String | 32 | Y | 交易金额 |
| balance | String | 32 | Y | 余额 |
| settle_time | String | 13 | Y | 结算处理时间：yyyy-MM-dd HH:mm:ss |
会员支付
- URL：
/miniprogram/100/member/minipay - Method：
POST
请求参数
| 参数名称 | 类型 | 长度 | 必填 | 说明 |
|---|---|---|---|---|
| merchant_no | String | 15 | Y | 商户号 |
| terminal_no | String | 8 | Y | 终端号 |
| terminal_trace | String | 32 | Y | 终端流水号 |
| terminal_time | String | 14 | Y | 终端交易时间，yyyyMMddHHmmss，全局统一时间格式 |
| open_id | String | 16 | N | 获取微信授权用户id、支付宝用户id |
| user_memberId | String | 30 | Y | 会员id |
| card_num | String | 11 | Y | 卡号 |
| password | String | 32 | Y | 密码 |
| activity_id | String | 32 | N | 会员活动id |
| order_body | String | 128 | N | 订单描述 |
| notify_url | String | 256 | N | 外部系统通知地址 |
| key_sign | String | 32 | Y | 传参字典序后，拼接令牌(access_token)再MD5加密 |
返回参数
| 参数名称 | 类型 | 长度 | 必填 | 说明 |
|---|---|---|---|---|
| total_fee | String | 10 | N | 金额，单位分 |
| balance | String | 10 | N | 结余金额 |
| out_trade_no | String | 3 | N | 唯一订单号 |
修改手机号
- URL：
/miniprogram/100/member/updatephone - Method：
POST
请求参数
| 参数名称 | 类型 | 长度 | 必填 | 说明 |
|---|---|---|---|---|
| merchant_no | String | 15 | Y | 商户号 |
| terminal_no | String | 8 | Y | 终端号 |
| terminal_trace | String | 32 | Y | 终端流水号 |
| open_id | String | 16 | N | 获取微信授权用户id、支付宝用户id |
| user_memberId | String | 30 | Y | 会员id |
| card_num | String | 11 | Y | 卡号 |
| account | String | 30 | Y | 手机号或者邮箱 |
| new_account | String | 30 | Y | 新手机号或者邮箱 |
| auth_code | String | 32 | Y | 验证码 ,md5加密 |
| key_sign | String | 32 | Y | 传参字典序后，拼接令牌(access_token)再MD5加密 |
返回参数
| 参数名称 | 类型 | 长度 | 必填 | 说明 |
|---|---|---|---|---|
| return_code | String | 2 | Y | 业务响应码，01成功、02失败 |
| return_msg | String | 128 | Y | 业务响应描述 |
| result_code | String | 2 | Y | 业务处理响应码，01成功、02失败 |
| terminal_trace | String | 32 | Y | 请求流水号 |
| key_sign | String | 32 | Y | 传参字典序后，拼接令牌(access_token)再MD5加密 |
发送短信验证
| 参数名称 | 说明 |
|---|---|
| iphone | 手机号 |
3 微信卡包会员卡
调用会员卡组件
开发者可以在小程序内调用该接口拉起会员开卡组件，方便用户快速填写会员注册信息并领卡。 该接口拉起开卡组件无须提前将开卡组件和发起小程序绑定至同一个公众号，开发者直接调用即可。
