支付宝统一下单接口

接口名称

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 不定 平台方错误码

results matching ""

    No results matching ""