创建先用后付订单

更新时间:2024.06.18

前置条件:无

# 接口说明

支持商户:
【普通商户】
请求方式:
【POST】/v3/payscore/servicepayondeliveryorder
请求域名:
【主域名】
https://api.mch.weixin.qq.com
使用该域名将访问就近的接入点
【备域名】
https://api2.mch.weixin.qq.com
使用该域名将访问异地的接入点 ,指引点击查看

# 请求参数

    Header HTTP头参数
  • Authorization 必填 string
    请参考 签名认证 生成认证信息
  • Accept 必填 string
    请设置为 application/json
  • Content-Type 必填 string
    请设置为 application/json
    Body 包体参数
  • out_order_no 必填 string(32)
    【商户服务订单号】 商户系统内部服务订单号,要求32个字符内,只能是数字、大小写字母_-|* 且在同一个商户号下唯一。需要开发者特别注意,该参数不可用于申请退款接口中的 out_trade_no 参数。
  • appid 必填 string(32)
    【公众账号ID】 是微信开放平台和微信公众平台为开发者的应用程序(APP、小程序、公众号)提供的一个唯一标识。 开发者需要先在微信开放平台或微信公众平台中申请ID,然后在商户平台中绑定,详见直连商户与AppID账号关联管理。完结订单和取消订单需要和创单传入的appid保持一致。
  • service_id 必填 string(32)
    【服务ID】 商户支付分服务的唯一标识,由32位数字组成。支付分产品权限审核通过后,微信支付运营会向商户提供该ID。
  • service_introduction 必填 string(20)
    【服务信息】 用于介绍本订单所提供的服务 ,长度不能超过20个字符(汉字、数字、字母、特殊符号都按照1个字符计算)。
  • post_payments 选填 array[Payment]
    【后付费项目】 用于展示订单后付费项目明细,商户需要按照所属行业规程传参,详见post_payments(后付费项目)字段传参说明
    • 属性
  • post_discounts 选填 array[ServiceOrderCoupon]
    【商户优惠】 用于展示订单优惠项目明细,最多30条,完结订单时传的收款总金额需满足计算条件(收款总金额=后付费项目amount和-优惠项目amount和)
    • 属性
  • time_range 必填 object
    【服务时间段】 用于描述订单的服务开始和结束时间。
    • 属性
  • location 选填 object
    【服务位置】 用于描述用户使用服务的地理位置
    • 属性
  • risk_fund 必填 object
    【服务风险金】 本笔订单的风险金额描述
    • 属性
  • attach 选填 string(256)
    【商户数据包】 商户在创建订单时传入的自定义数据包,用户不可见。用于存放订单的商户自定义数据,需要先进行urlencode编码,总长度不超过256字符。确认订单回调和支付成功回调时会回传该字段给商户。
  • notify_url 必填 string(255)
    【商户回调地址】 商户接收确认订单回调通知支付成功回调通知的地址,创单时传入,需按照notify-url填写注意事项规范填写。
  • openid 选填 string(128)
    【用户标识】 微信用户在商户对应appid下的唯一标识
  • need_user_confirm 选填 boolean
    【是否需要用户确认】 固定传true或者不传(不传默认是true)。
  • mchid 选填 string(32)
    【商户号】 直连商户号:平台商必填
  • shopping_info 必填 object
    【先用后付购物详情】 先用后付订单的购物详情信息,必填
    • 属性

请求示例

POST

# 应答参数

    200OK
  • appid 必填 string(32)
    【公众账号ID】 调用接口提交的公众账号ID
  • mchid 必填 string(32)
    【商户号】 调用接口提交的商户号
  • out_order_no 必填 string(32)
    【商户服务订单号】 调用接口提交的商户服务订单号
  • service_id 必填 string(32)
    【服务ID】 调用该接口提交的服务ID
  • service_introduction 必填 string(20)
    【服务信息】 服务信息,用于介绍本订单所提供的服务
  • state 必填 string(32)
    【服务订单状态】 表示当前单据状态. CREATED:商户已创建服务订单; GOING: 服务订单进行中 FINISHED: 服务订单完成; REVOKED: 商户取消服务订单; EXPIRED:服务订单已失效,"商户已创建服务订单"状态超过1小时未变动,则订单失效
  • state_description 选填 string
    【订单状态说明】 对服务订单"进行中"状态的附加说明:USER_CONFIRM: 用户确认;MCH_COMPLETE:商户完结;
  • post_payments 选填 array[object]
    【后付费项目】
    • 属性
  • post_discounts 选填 array[object]
    【后付费商户优惠】
    • 属性
  • risk_fund 选填 object
    【服务风险金】
    • 属性
  • time_range 选填 object
    【服务时间段】 服务使用的开始时间和结束时间
    • 属性
  • location 选填 object
    【服务位置】 服务使用的开始位置和结束位置
    • 属性
  • attach 选填 string(256)
    【商户数据包】 商户数据包,可存放本订单所需信息,需要先urlencode后传入,总长度不大于256字符,超出报错处理。
  • notify_url 选填 string(256)
    【商户回调地址】 商户接收用户确认订单或扣款成功回调通知的地址
  • order_id 必填 string(64)
    【微信支付服务订单号】 微信支付服务订单号 每个微信支付服务订单号与商户号下对应的商户服务订单号一一对应
  • package 必填 string(300)
    【跳转微信侧小程序订单数据】 用于跳转到微信侧小程序订单数据,跳转到微信侧小程序传入
  • shopping_info 选填 object
    【先用后付购物详情】
    • 属性

应答示例

200 OK

# 错误码

# 公共错误码

状态码 错误码 描述 解决方案
400 PARAM_ERROR 参数错误 请根据错误提示正确传入参数
400 INVALID_REQUEST HTTP 请求不符合微信支付 APIv3 接口规则 请参阅 接口规则
401 SIGN_ERROR 验证不通过 请参阅 签名常见问题
500 SYSTEM_ERROR 系统异常,请稍后重试 请稍后重试

# 业务错误码

状态码 错误码 描述 解决方案
400 INVALID_ORDER_STATE 单据状态错误 确认操作是否符合流程
400 INVALID_REQUEST 请求参数符合参数格式,但不符合业务规则 请确认相同单号是否使用了不同的参数
400 ORDER_CANCELED 单据已取消 当前状态无需操作
400 ORDER_DONE 订单已完成 当前状态无需操作
403 NO_AUTH 商户无权限 请确认商户及对应服务信息,确认是否有相关权限
404 ORDER_NOT_ EXIST 订单不存在 确认入参,传入正确单据
429 FREQUENCY_LIMITED 频率超限 请求量不要超过接口调用频率限制
500 SYSTEM_ERROR 系统错误 5开头的状态码都为系统问题,请使用相同参数稍后重新调用
反馈
咨询
目录