小程序台卡技术方案 2018-09-05

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 微信卡包会员卡

调用会员卡组件

开发者可以在小程序内调用该接口拉起会员开卡组件，方便用户快速填写会员注册信息并领卡。 该接口拉起开卡组件无须提前将开卡组件和发起小程序绑定至同一个公众号，开发者直接调用即可。

最后编辑于 ：
©著作权归作者所有,转载或内容合作请联系作者
  • 人面猴
    序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
    沈念sama阅读 204,921评论 6赞 478
  • 死咒
    序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
    沈念sama阅读 87,635评论 2赞 381
  • 救了他两次的神仙让他今天三更去死
    文/潘晓璐 我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
    开封第一讲书人阅读 151,393评论 0赞 338
  • 道士缉凶录：失踪的卖姜人
    文/不坏的土叔 我叫张陵，是天一观的道长。 经常有香客问我，道长，这世上最难降的妖魔是什么？ 我笑而不...
    开封第一讲书人阅读 54,836评论 1赞 277
  • 港岛之恋（遗憾婚礼）
    正文 为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
    茶点故事阅读 63,833评论 5赞 368
  • 恶毒庶女顶嫁案：这布局不是一般人想出来的
    文/花漫 我一把揭开白布。 她就那样静静地躺着，像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上，一...
    开封第一讲书人阅读 48,685评论 1赞 281
  • 城市分裂传说
    那天，我揣着相机与录音，去河边找鬼。 笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。 我是一名探鬼主播，决...
    沈念sama阅读 38,043评论 3赞 399
  • 双鸳鸯连环套：你想象不到人心有多黑
    文/苍兰香墨 我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
    开封第一讲书人阅读 36,694评论 0赞 258
  • 万荣杀人案实录
    序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
    沈念sama阅读 42,671评论 1赞 300
  • 护林员之死
    正文 独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,670评论 2赞 321
  • 白月光启示录
    正文 我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,779评论 1赞 332
  • 活死人
    序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
    沈念sama阅读 33,424评论 4赞 321
  • 日本核电站爆炸内幕
    正文 年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
    茶点故事阅读 39,027评论 3赞 307
  • 男人毒药：我在死后第九天来索命
    文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,984评论 0赞 19
  • 一桩弑父案，背后竟有这般阴谋
    文/苍兰香墨 我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,214评论 1赞 260
  • 情欲美人皮
    我被黑心中介骗来泰国打工， 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。 一个月前我还...
    沈念sama阅读 45,108评论 2赞 351
  • 代替公主和亲
    正文 我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
    茶点故事阅读 42,517评论 2赞 343

推荐阅读更多精彩内容

  • Spring Cloud
    Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具（例如配置管理，服务发现，断路器，智...
    卡卡罗2017阅读 134,597评论 18赞 139
  • 她
    她 ，她，她 她从长满青苔的墨台上走来 一手一个天真，一脚一对朴实 粉红手链里面交叉了她对人性的认识 不曾走进诱惑...
    世界名画在行走阅读 240评论 1赞 3
  • 鲤鱼跳龙门
    【鲤鱼跳龙门】 活鱼，都是逆流而上！ 只有死鱼，才会随波逐流！ ❤️为心中梦想加油[拳头] 通过自己的努力与坚持改...
    美印安然阅读 317评论 0赞 0
  • 测试
    测试
    鱼寻水阅读 141评论 0赞 0
  • 无法长大
    既然无法长大，就不要学着别人去挣扎。
    9b39b0d5701b阅读 197评论 1赞 0