订单支付
接口用途
用户展示付款码由店员使用扫码设备读取付款码信息上送
接口地址
/payment/tradePay
请求参数
| 参数名 |
说明 | 类型 | 是否必填 | 备注 | |
| bizContent | traceNo | 交易流水号 | String(32) | 是 | 同一商户全局唯一，用于标识唯一交易 |
| paymentChannelId | 支付渠道ID | String(32) | 否 | 当收款方需要指定支付渠道时填值(由易百分配) | |
| merOrderNo | 商户订单号 | String(32) | 是 | 同一商户全局唯一，用于关联收银机订单号 | |
| orderAmount | 订单原始金额 | Number | 否 | 单位分，收银前端原始点单金额 | |
| totalAmount | 待支付总金额 | Number | 是 | 单位分，收银前端已优惠过剩下要支付的金额 | |
| deviceNo | 设备号 | String(32) | 是 | 收银机具终端编号 | |
| storeId | 商户门店编号 | String(32) | 是 | 商户门店编号 | |
| storeName | 商户门店名称 | String(256) | 是 | 商户门店名称 | |
| returnOptions | 返回选项 | String[](300) | 否 | 需与易百技术约定后启用 | |
| goodsTag | 订单优惠标记 | String(32) | 否 | 特殊活动标记，需与易百技术约定后启用 | |
| authCode | 付款码 | String(32) | 是 | ||
| subject | 订单标题 | String(256) | 是 | ||
| orderTime | 订单创建时间 | String(19) | 是 | yyyy-MM-dd HH:mm:ss | |
| notifyUrl | 支付回调地址 | String(200) | 否 | ||
| goodsDetailList | 订单商品明细 | List | 否 | ||
| |__ gid | 商品编号 | String(32) | 是 | ||
| |__ gname | 商品名称 | String(256) | 是 | ||
| |__ quantity | 商品数量 | Number | 是 | ||
| |__ price | 商品价格 | Number | 是 | 单位分 | |
| |__ category | 商品类目 | String(32) | 是 | ||
请求示例
"bizContent": {
"traceNo": "20240710112246541_11130101",
"merOrderNo": "0007525202407100000835",
"totalAmount": 3300,
"deviceNo": "83520001",
"storeId": "111301",
"goodsTag": "",
"authCode": "132951513806421759",
"subject": "中-冰美式",
"notifyUrl": "",
"goodsDetailList": [
{
"gid": "010403",
"gname": "中-冰美式",
"quantity": 1,
"price": 3300,
"category": "2"
}
]
}返回参数
| 参数名 |
说明 | 类型 | 是否必填 | 备注 | |
| data |
payChannel | 支付渠道 | String(32) | 是 | wxpay微信；alipay支付宝；dongfu东福随心兑 |
| transactionNo | 易百交易号 | String(32) | 是 | ||
| paymentNo | 收单机构交易号 | String(40) | 否 | ||
| traceNo | 交易流水号 | String(32) | 是 | 按请求原样下发 | |
| transTime | 交易时间 | String(19) | 是 | yyyy-MM-dd HH:mm:ss | |
| account | 支付账号 | String(40) | 否 | ||
| openId | 用户唯一标识 | String(128) | 否 | ||
| totalAmount | 交易总金额 | Number | 是 | 单位分，按请求原样下发 | |
| receiptAmount | 实收金额 | Number | 是 | 单位分 | |
| mdiscountAmount | 商家优惠金额 | Number | 否 | 单位分 | |
| discountAmount | 平台优惠金额 | Number | 否 | 单位分 | |
| payAmount | 用户付款金额 | Number | 是 | 单位分 | |
| invoiceAmount | 给用户可开发票金额 | Number | 是 | 单位分 | |
| storeName | 交易门店名称 | String(200) | 是 | ||
| voucherDetailList | 交易支付所用优惠券信息 | List | 否 | ||
| |__ activityId | 活动ID或券模板ID | String(32) | 否 | ||
| |__ id | 券ID | String(32) | 是 | ||
| |__ name | 券名称 | String(64) | 是 | ||
| |__ type | 券类型 | String(32) | 是 | ||
| |__ amount | 券面额 | Number | 是 | 单位分 | |
| |__ merchantContribute | 商家出资 | Number | 否 | 单位分 | |
| |__ otherContribute | 其他出资方 | Number | 否 | 单位分 | |
| |__ purchaseBuyerContribute | 用户购买实付金额 | Number | 否 | 单位分 | |
| |__ purchaseMerchantContribute | 用户购买商家优惠金额 | Number | 否 | 单位分 | |
| |__ purchaseAntContribute | 用户购买平台优惠金额 | Number | 否 | 单位分 | |
返回示例
{
"data": {
"payChannel": "wxpay",
"transactionNo": "",
"paymentNo": "4200002227202407102297768192",
"traceNo": "20240710112246541_11130101",
"transTime": "2024-07-10 11:28:54",
"account": "",
"openId": "o2Jh6jtk9v28kSk2GUuyqhtdzUTs",
"totalAmount": 3300,
"receiptAmount": 3300,
"mdiscountAmount": 0,
"discountAmount": 0,
"payAmount": 3300,
"invoiceAmount": 3300,
"storeName": "xxx昆山首创奥特莱斯店"
}
}
No Comments