# 支付时序图

支付时序图

# 接口列表

接口名 资源路径 请求方式 是否必接 描述 备注
下单接口 orderSync POST 创建支付订单
支付结果回调通知接口 由业务方提供 POST 通知业务方订单状态信息

# 服务端相关接口

TIP

  1. 服务端对接时,数据需要加解密,密钥需要平台方管理员配置。

  2. 加密算法使用AES/ECB/PKCS5Padding,不指定iv

  3. 对接之前请提前联系平台方管理换进行支付参数配置,否则会提示下单失败。

# 1.下单接口

接口描述:提交同步订单相关信息

请求方式:post application/json

生产请求URL: https://smartapp.51y5.net/swamp/orderSync

入参:

字段 类型 说明
app_key string 小程序appKey
data string 订单信息加密json

响应结果:

字段 类型 说明
result_code string "0" 处理成功,其他异常
error_msg string 错误信息

订单信息:

字段 类型 是否必需 说明
app_id string 宿主环境的appId,
可以通过wuji.getSystemInfo host 字段获取查询对应关系
request_id string 是请求id,业务方保证唯一
out_trade_id string 是外部支付订单,业务方生成
products List<product> 商品列表
brand_model string 统计区分用,格式:品牌_[型号]
可以通过wuji.getSystemInfo 获取

product商品信息:

字段 类型 是否必需 说明
channel_goods_price string 商品单价(单位分)
channel_goods_sum string 商品数量
channel_goods_code string 商品代码
channel_goods_subject string 商品名称
channel_goods_desc string 商品描述
channel_goods_img string 商品图片
right_type string 权益类型
right_price string 权益值

# host 和 appId 对应关系

const { host } = wuji.getSystemInfoSync();
if(host === 'wifikeycore') {
  // 钥匙主版
  appId = 'A0008'
} else if(host === 'wifikey') {
  // 钥匙极速版
  appId = 'A0016'
} else  {
  // 小游戏调试器,默认A0008
  appId = 'A0008'
}

# 2.支付结果回调通知接口

业务方提供post application/json 的回调地址

服务端会在支付状态变更时,根据配置的回调地址通知到业务方(有重试机制,业务方保证幂等)

参数:

字段 类型 说明
data string 加密密文

解密信息:

字段 类型 说明
outTradeId string 外部订单
wkTradeId string 支付订单
status int 支付状态1 成功成功-1 支付失败
payAmount int 单位(分)

响应结果:

字段 类型 说明
result_code string "0" 通知成功
Last Updated: 2021-01-28