Skip to main content

预支付接口

基本信息

接口名称:预支付接口状  态:已完成
接口路径:POST /paas/micro/cashier/prePay更新时间:2025-03-17 23:27:50
Mock地址:https://apimock.e-buychina.com/mock/587/paas/micro/cashier/prePay

请求参数

Headers:

参数名称参数值是否必填
Content-Typeapplication/json

Body:

参数名称类型必填默认值备注其他信息
uuidstring请求序列号最大长度:50
最小长度:1
Mock:@now('yyyyMMdd')-@string('lower',32)
appIdstring请求AppId最大长度:50
最小长度:1
Mock:@natural
actionstring请求action最大长度:50
最小长度:1
Mock:prePay
timestampnumber请求时间戳Mock:@timestamp
langstring语言最大长度:50
最小长度:1
Mock:zh_CN
signTypestring签名算法,固定sha256最大长度:10
最小长度:1
Mock:sha256
signstring签名最大长度:500
最小长度:1
Mock:@string
contentobject请求报文
  useScenestring终端使用场最大长度:32
最小长度:1
Mock:@string(1, 32)
  storeInfoobject门店信息
    deviceNostring设备号最大长度:32
最小长度:5
Mock:@natural(5, 32)
    shopNostring门店号最大长度:32
最小长度:5
Mock:@natural(5, 32)
    areaCodestring门店行政区划码最大长度:6
最小长度:6
Mock:@string(6,6)
    namestring门店名称最大长度:20
最小长度:4
Mock:@word(4, 20)
  orderIdstring业务订单号,每个对接账号唯一。建议:YYYYMMDD+商户号+店号+随机最大长度:64
最小长度:1
Mock:@natural(1, 32)
  orderTitlestring订单标题最大长度:20
最小长度:5
Mock:@title(5, 20)
  orderDescstring订单描述,可以用作区分订单来源、订单类别最大长度:2000
Mock:@csentence
  goodsDetailarray商品信息
    goodsIdstring商品ID,外部编号最大长度:32
最小长度:32
Mock:@natural
    goodsCodestring商品编码,内部编号最大长度:32
Mock:@natural
    goodsNamestring商品名称最大长度:50
最小长度:5
Mock:@word(5, 50)
    goodsNumnumber数量Mock:@integer(1, 100)
    priceSalenumber售价,单位元Mock:@float(0, 10000, 0, 2)
    specstring产品规格最大长度:5
最小长度:1
Mock:@word(1, 5)
    categorystring产品品类最大长度:10
最小长度:1
Mock:@word(1, 10)
    unitsstring单位最大长度:2
最小长度:1
Mock:@word(1,2)
    incentiveFlagstring优惠标识 (枚举)最大长度:10
Mock:@word
  extendInfoobject附加信息
    originalDatastring异步通知时原样返回最大长度:200
Mock:@string
  totalAmountnumber单位元,去除其他支付后金额剩余待支付金额,电子钱包和卡支付会用到Mock:100
  oriOrderAmountnumber单位元,订单原始总金额Mock:110
  incentiveAmountnumber单位元,可参与优惠的金额Mock:10
  currencystring币种最大长度:5
最小长度:3
Mock:CNY
  payMethodarray支付方式
    assetTypestring资产类型,枚举。preAuth预授权,cash电子钱包,points积分必填。coupon优惠券,cashcard现金卡。储值卡、优惠券非必填最大长度:20
最小长度:1
Mock:@string
    pointsnumberassetType是points,此必填。使用积分数Mock:@string
    cardCouponsstringassetType是coupon、cashcard,此必填。卡或者券码列表,格式:"cardCoupon01|secret01" '|'分隔。secret01 是卡密或码密。最大长度:255
Mock:@string
    payWaystringassetType是cash,此必填。电子钱包支付必填,枚举渠道标识,枚举值。格式为:支付渠道,例如:WECHAT、ALIPAY、FOMOPAY 等最大长度:10
Mock:@string
    amountnumber消费金额。支付
积分
卡 消费金额必填
Mock:@integer
    goodsIdstring资产指定适用产品id最大长度:50
Mock:@string
    thirdUserIdstring用户idMock:@string
    useLimitstring资产使用限制规则码Mock:@string

返回数据

参数名称类型必填默认值备注其他信息
uuidstring请求序列号最大长度:50
最小长度:1
Mock:@now('yyyyMMdd')-@string('lower',32)
successboolean交易成功与否Mock:@boolean
actionstring交易类型最大长度:50
最小长度:1
Mock:prePay
timestampnumber返回时间戳Mock:@timestamp
errorCodestring错误码最大长度:50
Mock:@word
errorMessagestring错误描述最大长度:50
Mock:@csentence
signTypestring签名类型最大长度:20
Mock:sha256
signstring签名值最大长度:500
Mock:@natural
contentobject返回报文
  outTradeNostring外部订单号最大长度:128
最小长度:32
Mock:@natural(32, 128)
  paidAmountstring支付成功总金额。totalAmount - paidAmount > 0 表示用户需要另外支付金额最大长度:10
最小长度:1
Mock:@string
  userPaidstring用户实付总金额最大长度:10
最小长度:1
Mock:@string
  merchantAmountstring商户实收金额最大长度:10
最小长度:1
Mock:@string
  cardPaidobjectcashcard 支付结果
    paidAmountstring此资产支付成功金额最大长度:10
最小长度:1
Mock:@string
    tenderCodestring商户收入映射码最大长度:20
    discountCodestring商户优惠映射码最大长度:20
    merchantAmountstring商户实收金额最大长度:10
最小长度:1
    userAmountstring用户实付金额最大长度:10
最小长度:1
    cardResultarray卡使用结果
  couponPaidobjectcoupon支付结果
    paidAmountstring此资产支付成功金额最大长度:10
最小长度:1
Mock:@string
    tenderCodestring商户收入映射码最大长度:20
Mock:@string
    discountCodestring商户优惠映射码最大长度:20
Mock:@string
    merchantAmountstring商户实收金额最大长度:10
最小长度:1
Mock:@string
    userAmountstring用户实付金额最大长度:10
最小长度:1
Mock:@string
    couponResultarray券使用结果
  pointsPaidobject积分支付结果
    paidAmountstring此资产支付成功金额最大长度:10
最小长度:1
Mock:@string
    pointsCountstring使用积分数最大长度:10
最小长度:1
Mock:@string
    tenderCodestring商户收入映射码最大长度:20
Mock:@string
    discountCodestring商户优惠映射码最大长度:20
Mock:@string
    merchantAmountstring商户实收金额最大长度:10
最小长度:1
Mock:@string
  cashPaidobject电子钱包用户支付结果
    paidAmountstring此资产支付成功金额Mock:@string
    userAmountstring用户实付金额Mock:@string
    merchantAmountstring商户实收金额Mock:@string
    tenderCodestring商户收入映射码
    discountCodestring商户优惠映射码

备注

变更历史

变更日期变更内容
2023-03-30
2022-03-04
2022-03-04
2022-02-11
2022-02-11
2022-02-11
api-id=35405