支付宝统一下单接口
接口名称
openapi.payment.Alipay.H5
请求方式
POST
请求头
application/json; charset=utf-8
请求业务参数
参数 | 类型 | 是否必填 | 最大长度 | 描述 |
---|---|---|---|---|
merchant_order_sn | string | 是 | 32 | 第三方商户的订单号,确保唯一,前后不允许带空格 |
total_fee | float | 是 | 10 | 订单金额(元) |
buyer_id | string | 是 | 64 | 支付宝用户ID,2088开头(获取buyer_id可参考:https://docs.alipay.com/fw/api/105942) |
store_id | int | 否 | 10 | 门店ID,当存在多个门店时,此字段必填 |
cashier_id | int | 否 | 10 | 收银员ID |
body | string | 否 | 128 | 对交易或商品的描述(微信上body值显示在商品,支付宝上body值显示在商品说明) |
call_back_url | string | 否 | 256 | 支付成功后异步通知链接 |
attach | string | 否 | 127 | 附加字段 |
timeout_express | string | 否 | 14 | 订单失效时间 格式为yyyyMMddHHmmss,如2009年12月27日9点10分10秒表示为20091227091010。 建议:最短失效时间间隔大于1分钟 大于当前下单时间 |
detail | string | 否 | 6000 | 商品详细描述,Json格式,对于使用单品优惠的商户,该字段必须按照规范上传,详见“单品优惠参数说明” |
以下为单品优惠活动detail字段列表说明:
变量名 | 类型 | 是否必填 | 描述 |
---|---|---|---|
goods_detail | String | 是 | 单品信息,使用Json数组格式提交,见下文说明 |
以下为单品优惠活动goods_detail字段说明:
变量名 | 类型 | 是否必填 | 描述 |
---|---|---|---|
goods_id | String(32) | 是 | 商品编码 |
goods_name | String(256) | 是 | 商品名称 |
quantity | int | 是 | 商品数量 |
price | Integer | 是 | 商品单价,单位为分 |
- 请求示例:
{
"biz_content": "{\"attach\":\"\订\单:123456\",\"store_id\":4178,\"merchant_order_sn\":\"201712201513777188104\",\"total_fee\":0.01,\"buyer_id\":\"2088102172333941\"}",
"method": "openapi.payment.Alipay.H5",
"format": "json",
"sign_method": "md5",
"sign": "8825AC6F016773810E10354804ADE000",
"app_id": "20170601202131300809",
"nonce": "201712201513777188215nonce",
"version": "1.0"
}
成功响应参数
参数 | 类型 | 是否必填 | 最大长度 | 描述 |
---|---|---|---|---|
order_sn | string | 是 | 32 | 付呗订单号 |
prepay_id | string | 是 | 64 | 支付宝预支付订单号 |
store_id | int | 是 | 16 | 付呗系统的门店id |
cashier_id | int | 否 | 16 | 付呗系统的收银员id |
user_id | string | 否 | 32 | 微信顾客支付授权的“open_id”或者支付宝顾客的“buyer_user_id” |
user_logon_id | string | 否 | 32 | 支付宝顾客的账号 |
- 响应示例:
{
"result_message": "成功",
"data": {
"order_sn": "20171220213948990272",
"prepay_id": "2017122021001004940200330192",
"store_id":123,
"cashier_id":0,
"user_id":"",
"user_logon_id":""
},
"result_code": 200
}
失败响应参数
参数 | 类型 | 是否必填 | 最大长度 | 描述 |
---|---|---|---|---|
result_message | string | 是 | 不定 | 付呗平台错误信息 |
result_code | int | 是 | 3 | 付呗错误码 |
sub_code | string | 否 | 不定 | 平台方错误码 |