创建订单

更新时间:2024.09.19

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

注意

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

接口说明

支持商户: 【普通商户】

请求方式: 【POST】

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

请求参数

heder 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、非必填参数,小程序可选择是否要使用

请求示例

1curl -X POST \
2  https://api.mch.weixin.qq.com/v3/f2fminiprogram/orderinfo/create?access_token=ACCESS_TOKEN \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" \
5  -H "Content-Type: application/json" \
6  -d '{
7    "payer_openid" : "onqOjjmo8wmTOOtSKwXtGjg9Gb58",
8    "payee_openid" : "onqOjjmo8wmTOOtSKwXtGjg9Gb58",
9    "out_request_no" : "12345678901234567890",
10    "amount" : 1,
11    "discount_amount" : 100,
12    "attach" : "attach info:xxx"
13  }'

应答参数

200 OK

confirm_token 必填 string(128)

【创建订单凭证】
用于后续在小程序中拉起面对面支付


errcode 必填 int64

【错误码】
成功时为0,其它错误码含义详见下方错误码列表


errmsg 必填 string(128)

【错误信息】
错误原因的简要描述

应答示例

1{
2  "confirm_token" : "AAR9o3oBAAABAAAAAACcVFuxWuzKgy90C7CfXiAAAAAnBTsSQzkr56J5EMO7tdtVJMDN0H0hoskk0/wgPrsYjC5OhHIRGOsBg6q2Zq0vei6/4C87U2LN88+mnlguzO9/DKb6CYbzY0g="
3}

错误码

公共错误码

状态码

错误码

描述

解决方案

400

PARAM_ERROR

参数错误

请根据错误提示正确传入参数

400

INVALID_REQUEST

HTTP 请求不符合微信支付 APIv3 接口规则

请参阅 接口规则

401

SIGN_ERROR

验证不通过

请参阅 签名常见问题

500

SYSTEM_ERROR

系统异常,请稍后重试

请稍后重试

业务错误码

状态码

错误码

描述

解决方案

200

269215744

参数错误

根据错误提示,传入正确参数

200

269215758

系统错误

请使用相同参数稍后重新调用

200

269215751

该笔订单已被支付

请勿重复创建订单

200

269215752

请求号已被使用,请使用新的请求号

保证out_request_no唯一

200

269215767

该订单已关闭,请重新发起一笔订单

该订单已关闭,请重新发起一笔订单

 

 

反馈
咨询
目录
置顶