创建订单
更新时间:2024.09.19在用户确认要付款时,小程序应通过本接口告知微信支付付款金额、收付款方账号等信息,并使用本接口返回的confirm_token通过小程序JSAPI拉起支付流程
|
接口说明
支持商户: 【普通商户】
请求方式: 【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、非必填参数,小程序可选择是否要使用
请求示例
应答参数
|
confirm_token
必填 string(128)
【创建订单凭证】
用于后续在小程序中拉起面对面支付
errcode
必填 int64
【错误码】
成功时为0,其它错误码含义详见下方错误码列表
errmsg
必填 string(128)
【错误信息】
错误原因的简要描述
应答示例
错误码
公共错误码
状态码 | 错误码 | 描述 | 解决方案 |
---|---|---|---|
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 | 该订单已关闭,请重新发起一笔订单 | 该订单已关闭,请重新发起一笔订单 |