创建订单接口

更新时间:2024.12.27

在用户确认要付款时,小程序应通过本接口告知微信支付付款金额、收付款方账号等信息,并使用本接口返回的confirm_token通过小程序JSAPI拉起支付流程

注意

说明:云调用是微信开放平台提供的基于云函数使用小程序开放接口的能力,可使用云调用替代HTTPS形式调用微信开放平台服务端API。

# 接口说明

支持商户: 【普通服务商】

请求方式: 【POST】

请求URL: "https://api.weixin.qq.com/wxa/business/f2f/createorderinfo"

# 请求参数

    Header HTTP头参数
  • Authorization 必填 string
    请参考 签名认证 生成认证信息
  • Accept 必填 string
    请设置为 application/json
  • Content-Type 必填 string
    请设置为 application/json
    Query 查询参数
  • access_token 必填 string(512)
    【接口调用凭证】
    1、调用接口的凭证,获取方式参见《auth.getAccessToken》文档https://developers.weixin.qq.com/miniprogram/dev/api-backend/open-api/access-token/auth.getAccessToken.html
    2、HTTPS方式调用时,该参数必填;云调用时无此参数。
    Body 包体参数
  • payer_openid 必填 string(64)
    【付款方OpenID】
    发起付款的用户,在本小程序AppID下的OpenID
  • payee_openid 必填 string(64)
    【收款方OpenID】
    付款方在小程序中选购商品或服务对应的用户,在本小程序AppID下的OpenID
  • out_request_no 必填 string(32)
    【请求号】
    1、该请求号及其对应的付款方收款方OpenID、支付金额将用于创建唯一支付订单。
    2、请求号为一次支付的唯一幂等ID,可使用小程序内部单号。要求此参数由数字、大小写字母_-|*@组成。
  • amount 必填 integer
    【支付金额】
    小程序提交给微信支付的订单需支付金额
  • discount_amount 选填 integer
    【支付前优惠的金额】
    支付前优惠的金额,单位分,当下单助手小程序希望指定支付前优惠和支付中优惠不能同享时,应在创建订单时告知支付前优惠金额
  • attach 选填 string(127)
    【附加数据】
    1、小程序订单的附加数据,原样返回创建订单时小程序传入的附加数据,可作为自定义参数使用。
    2、非必填参数,小程序可选择是否要使用

请求示例

POST

# 应答参数

    200OK
  • confirm_token 必填 string(128)
    【创建订单凭证】
    用于后续在小程序中拉起面对面支付
  • errcode 必填 int64
    【错误码】
    成功时为0,其它错误码含义详见下方错误码列表
  • errmsg 必填 string(128)
    【错误信息】
    错误原因的简要描述

应答示例

200 OK

# 错误码

# 公共错误码

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

# 业务错误码

状态码 错误码 描述 解决方案
200 269215744 参数错误 根据错误提示,传入正确参数
200 269215758 系统错误 请使用相同参数稍后重新调用
200 269215751 该笔订单已被支付 请勿重复创建订单
200 269215752 请求号已被使用,请使用新的请求号 保证out_request_no唯一
200 269215767 该订单已关闭,请重新发起一笔订单 该订单已关闭,请重新发起一笔订单
反馈
咨询
目录

微信支付文档中心已升级,你当前所查看的是旧文档中心的内容,旧文档中心将于 2025年 3 月 31日 下线,请移步 [新文档中心] 查看相应的内容