订单创建
开发环境
http://dev-cn.your-api-server.com
开发环境
http://dev-cn.your-api-server.com
POST
/v3/alipay/open/mini/order/create
公共错误码
业务错误码
| 状态码 | 错误码 | 错误描述 | 解决方案 |
|---|---|---|---|
| 400 | SYSTEM_ERROR | 系统繁忙 | 服务器异常 可能发生了网络或者系统异常，导致服务调用失败，商户可以用同样的请求发起重试 |
| 400 | INVALID_PARAMETER | 参数有误 | 请根据接口返回的参数非法的具体错误信息，修改参数后进行重试 |
| 400 | ACCESS_FORBIDDEN | 无权限调用 | 请确认当前调用应用是否签约“当面付”以及“JSAPI支付”产品 |
| 400 | ADDON_RENT_INFO_NOT_ALLOW | 续租信息不允许传入 | 非订单修改接口不允许传入续租信息 |
| 400 | BUSINESS_PARAMS_NOT_NEED | 支付业务参数无需 填写 | 支付业务参数无需填写 |
| 400 | BUYER_ID_IS_NULL | 订单购买人为空 | 检查请求参数，修改后重新发起请求 |
| 400 | DELIVERY_TYPE_INVALIDATE | 订单物流类型必须为VIRTUAL | 请确认订单为虚拟商品时，订单物流类型不为空且deliver_type为VIRTUAL |
| 400 | INITIAL_RENT_PRICE_INVALID | 首期租金非法 | 首期租金非法 ，修改后重新发起请求 |
| 400 | INSTALLMENT_PERIOD_NUM_INVALID | 分期参数无效 | 请根据接口返回的错误信息，检查请求参数，修改后重新发起请求 |
| 400 | INSTALLMENT_PERIOD_NUM_IS_NULL | 参数有误，分期参数为空 | 请根据接口返回的错误信息，检查请求参数，修改后重新发起请求 |
| 400 | INSTALLMENT_TYPE_INVALID | 分期类型不正确 | 请根据接口返回的错误信息，检查请求参数，修改后重新发起请求 |
| 400 | MERCHANT_BIZ_TYPE_INVALIDATE | 订单模板类型错误 | 请传入正确的订单模板 |
| 400 | MINI_SOURCE_ID_INVALID | sourceId非法 | sourceId非法,请重新进行获取 |
| 400 | MRCH_ORDER_ERROR | 订单处理错误状态异常 | 请填写正确的参数 |
| 400 | ORDER_DETAIL_IS_NULL | 订单详细信息为空 | 请传入order_detail字段 |
| 400 | ORDER_PRICE_INFO_IS_NULL | 订单价格信息为空 | 请传入订单价格信息 |
| 400 | ORDER_PRICE_IS_NULL | 订单金额为空 | 请传入订单总金额 |
| 400 | OUT_ORDER_ID_IS_NULL | 商户订单号为空 | 请传入商户订单号 |
| 400 | PARAM_IS_NULL | 参数为空 | 请传入参数 |
| 400 | PARSE_JSON_ERROR | 参数json解析失败 | 参数json解析失败，请检查json字段 |
| 400 | PATH_IS_NULL | 商家小程序对应的订单详情页路径地址为空 | 商家小程序对应的订单详情页路径地址为空，请填写 |
| 400 | PERIOD_REAL_RENT_PRICE_INVALID | 每期租金非法 | 每期租金非法，修改后重新发起请求 |
| 400 | RECEIVER_INFO_INVALID | 收货信息非法 | 请确认订单是实物电商时，收货信息（姓名、地址与电话号码）是否合法 |
| 400 | RENT_INFO_BUYOUT_PRICE_INVALID | 租赁商品买断价无效 | 请检查商品买断价是否合法 |
| 400 | RENT_INFO_IS_NULL | 租赁信息为空 | 租赁信息为空，修改后重新发起请求 |
| 400 | RENT_INFO_NOT_ALLOW | 非租赁商品不允许传租赁信息 | 非租赁商品不允许传租赁信息 |
| 400 | RENT_ITEM_QUANTITY_INVALID | 租赁商品数量违法 | 租赁商品数量违法，只允许唯一 |
| 400 | SELLER_ID_IS_NULL | 收款账号为空 | 商家收款账号PID或者sellerId传入正确的值 |
| 400 | SELLER_ID_NOT_NEED | 本地商品无需填写卖家支付宝用户ID | 请确认订单是本地商品时，入参无需填写卖家支付宝用户ID |
| 400 | SUBJECT_INVALIDATE | 订单标题包含特殊字符 | 请确认订单标题不包含特殊字符 |
| 400 | SUB_GOODS_SIZE_MAX_COUNT | 商品明细超长 | 请检查商品明细是否超过了150条 |
| 400 | TIME_EXPIRE_INVALIDATE | 订单超时时间-当前时间已超过允许支付的时间 | 请传入正确的订单超时时间 |
| 400 | TIME_OUT_EXPRESS_NOT_NEED | 超时时间无需填写 | 超时时间无需填写 |
| 400 | TITLE_IS_NULL | 订单标题为空 | 请传入订单标题 |
| 400 | TOTAL_AMOUNT_IS_NULL | 订单总金额为空 | 请检查传入订单金额 |
| 400 | TRADE_PRODUCT_CODE_NOT_OPEN | 未开通JSAPI产品码 | 请开通JSAPI产品码 |
| 400 | VIRTUAL_ITEM_ONLY_ONE | 每笔订单只支持一个商品类型 | 请确认订单为虚拟商品时，订单信息中的商品信息只支持传入一个商品类型 |
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://dev-cn.your-api-server.com/v3/alipay/open/mini/order/create' \
--header 'authorization: ALIPAY-SHA256withRSA app_id=$appid,timestamp=$now,nonce=$uuid,expired_seconds=600,sign=$sign' \
--header 'alipay-request-id: $requestid' \
--header 'Content-Type: application/json' \
--data-raw '{
"buyer_id":"2088102146225135",
"delivery_detail":{
"delivery_type":"VIRTUAL"
},
"merchant_biz_type":"VIRTUAL_RECHARGE",
"order_detail":{
"item_infos":[
{
"goods_id":"1234567",
"goods_name":"商品名称1",
"item_cnt":"5",
"sale_price":"88.88"
}
],
"price_info":{
"order_price":"88.88"
}
},
"out_order_id":"6823789339978248",
"path":"/pages/index/index?orderId=10190608609185",
"source_id":"MjAfSVNfTlVMA==",
"title":"虚拟商品"
}'响应示例响应示例
{
"order_id": "2015042321001004720200028594",
"out_order_id": "20150423001001"
}请求参数
Header 参数
authorization
string
必需
示例值:
ALIPAY-SHA256withRSA app_id=$appid,timestamp=$now,nonce=$uuid,expired_seconds=600,sign=$sign
alipay-request-id
string
必需
示例值:
$requestid
Content-Type
string
必需
示例值:
application/json
Body 参数application/json