创建订单接口
更新时间:2024.12.27在用户确认要付款时,小程序应通过本接口告知微信支付付款金额、收付款方账号等信息,并使用本接口返回的confirm_token通过小程序JSAPI拉起支付流程
注意
说明:云调用是微信开放平台提供的基于云函数使用小程序开放接口的能力,可使用云调用替代HTTPS形式调用微信开放平台服务端API。
# 接口说明
支持商户: 【普通服务商】
请求方式: 【POST】
请求URL: "https://api.weixin.qq.com/wxa/business/f2f/createorderinfo"
# 请求参数
- Authorization 必填请参考 签名认证
生成认证信息 - Accept 必填请设置为
application/json
- Content-Type 必填请设置为
application/json
Header HTTP头参数
- access_token 必填【接口调用凭证】
1、调用接口的凭证,获取方式参见《auth.getAccessToken》文档 https://developers.weixin.qq.com/miniprogram/dev/api-backend/open-api/access-token/auth.getAccessToken.html
。
2、HTTPS方式调用时,该参数必填;云调用时无此参数。
Query 查询参数
- payer_openid 必填【付款方OpenID】
发起付款的用户,在本小程序AppID下的OpenID - payee_openid 必填【收款方OpenID】
付款方在小程序中选购商品或服务对应的用户,在本小程序AppID下的OpenID - out_request_no 必填【请求号】
1、该请求号及其对应的付款方收款方OpenID、支付金额将用于创建唯一支付订单。
2、请求号为一次支付的唯一幂等ID,可使用小程序内部单号。要求此参数由数字、大小写字母_-|*@组成。 - amount 必填【支付金额】
小程序提交给微信支付的订单需支付金额 - discount_amount 选填【支付前优惠的金额】
支付前优惠的金额,单位分,当下单助手小程序希望指定支付前优惠和支付中优惠不能同享时,应在创建订单时告知支付前优惠金额 - attach 选填【附加数据】
1、小程序订单的附加数据,原样返回创建订单时小程序传入的附加数据,可作为自定义参数使用。
2、非必填参数,小程序可选择是否要使用
Body 包体参数
请求示例
POST
# 应答参数
- confirm_token 必填【创建订单凭证】
用于后续在小程序中拉起面对面支付 - errcode 必填【错误码】
成功时为0,其它错误码含义详见下方错误码列表 - errmsg 必填【错误信息】
错误原因的简要描述
200OK
应答示例
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 | 该订单已关闭,请重新发起一笔订单 | 该订单已关闭,请重新发起一笔订单 |
文档是否有帮助