美文网首页
小程序台卡技术方案 2018-09-05

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

作者: 弡_Qin | 来源:发表于2018-09-06 17:12 被阅读0次

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

    调用会员卡组件

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

    相关文章

      网友评论

          本文标题:小程序台卡技术方案 2018-09-05

          本文链接:https://www.haomeiwen.com/subject/apyawftx.html