创建订单

描述

创建支付订单。

路径

/optimus/core/order/placeOrder

入参说明（JSON 格式）

入参整体结构

参数 参数名称 类型 是否必传 描述 示例
appid 应用id String Y 固定值 见测试参数
mallID 商城信息 Object Y 固定值 见测试参数
seller 商户信息 Object Y 固定值 见测试参数
checkoutItemsId 结算项id String Y 前置操作获取
buyer 买家信息 Object Y 固定值 见测试参数
requestId 下单请求id String Y 不超过40位 ${AppCode}+id AppCode会提供
subject 标题 String Y 不超过64 微信支付完成 通知的商品标题
scenes 场景信息 List\ N
tags 业务标签 List\ N T9 的订单传 mis
riskControl 风控字段 Object N 风控字段 见下方 riskControl 字段明细
invoice 发票信息 Object N

入参字段结构

mallID 字段明细

参数 参数名称 类型 是否必传 描述 示例
mallSn 商城id String Y 固定值 见测试参数
signature 商城密码 String Y 固定值 见测试参数

seller 字段明细

参数 参数名称 类型 是否必传 描述 示例
merchantId 商户Id String Y 固定值 见测试参数
merchantUserId 商户userId String Y 固定值 见测试参数
role 角色 String Y 固定值 见测试参数

buyer 字段明细

参数 参数名称 类型 是否必传 描述 示例
buyerId 买家id String Y 固定值 见测试参数 merchantUserId

invoice 字段明细

参数 参数名称 类型 是否必传 描述 示例
buyerType 抬头类型 Byte Y 0 个人 1 企业 0
buyerName 抬头名称 String Y 发票抬头 李四
buyerRegisterNo 税号 String N
buyerAddress 地址 String N
buyerBankName 银行名称 String N
buyerBankAccount 银行账户 String N
buyerPhone 电话 String N
receiveType 接受方式 Byte N
receivePhone 接受手机号 String N
receiveEmail 接受邮箱 String N
invoiceBizType 发票类型 Byte N 1 普票 2 专票（只有开通了专票能力才能使用专票） 1
isSkipInvoice 是否跳过开票 Boolean N true 则跳过开票

scenes 字段明细

参数 参数名称 类型 是否必传 描述 示例
moduleSn 模块编号 String Y 固定值 需要和实际对应
content 场景数据 String Y json数据 序列化json 
[
    {
        "type": "textarea",
        "fieldName": "备注",
        "isFieldRequired": false,
        "tag": "common",
        "form": "basic",
        "label": "basic",
        "body": {
            "type": "textarea",
            "content": "备注文本",
            "isRequired": false,
            "readonly": true
        },
        "compType": "textarea"
    }
]

riskControl 字段明细

参数 参数名称 类型 是否必传 描述 示例
ipCheck ip校验 Object N 见ipCheck字段明细
idCheck id校验 Object N 见idCheck字段明细

ipCheck 字段明细

参数 参数名称 类型 是否必传 描述 示例
mode 风控IP校验模式 Object Y 枚举值 FULL_MATCH：ip完全匹配 ，CITY_MATCH：ip同城匹配 FULL_MATCH
orderClientIp 下单客户端IP Object Y 指定用户下单ip 113.61.50.249

idCheck 字段明细

参数 参数名称 类型 是否必传 描述 示例
allowedIdsByPayTool 允许的付款用户标识 Map Y 支付工具和用户标识列表的映射 见下方 
{
    "ipCheck": {
        "mode": "FULL_MATCH",
        "orderClientIp": "113.61.50.249"
    },
    "idCheck": {
        "allowedIdsByPayTool": {
            "2": ["291221212", "281191111"],
            "3": ["asdf1212_2asdfa", "fdtsfv21_asdfa!asdf"]
        }
    }
}
  • 支付工具枚举：1 - 储值卡，2 - 支付宝，3 - 微信

出参说明（JSON 格式）

出参整体结构

参数 参数名称 类型 描述 示例
success 请求状态 Boolean true：成功；false：失败 TRUE
code 状态码 String 0000：成功；其他为异常码 "0000"
msg 状态描述 String 请求结果的描述信息 "处理成功"
data 订单数据 Object 结果数据

出参字段结构

data 字段明细

参数 参数名称 类型 是否必传 描述 示例
orderSn 订单编号 String Y 订单编号
orderSignature 订单签名 String Y 订单密码
acquiring 收单信息 Object N 收单信息 用于拉起收银台

acquiring 字段明细

参数 参数名称 类型 是否必传 描述 示例
acquiringSn 收单号 String Y
signature 收单秘钥 String Y

注意 acquiring 如果不存在，说明创建收单失败，无法发起支付。

可能原因：终端被禁用、收款权限关闭等，需要排查。

示例

{
    "appid": "2025082700005615",
    "seller": {
        "merchantId": "fd567f94-9a44-4ae5-879f-9acc919d0f89",
        "merchantUserId": "42c556cc-1509-4de0-bfc3-dfbcb48eae57",
        "role": "super_admin"
    },
    "mallID": {
        "mallSn": "2026032016163406527",
        "signature": "qCbBQ9l99yCXdpuao945"
    },
    "buyer": {
        "buyerId": "53c8cb52-4ad3-11ed-952b-7cd30a5a1e6c"
    },
    "checkoutItemsId": "BXUo2Dzlm399p6PGgwc3TACRf2xoQWMvZ9qWetDqudg=",
    "requestId": "DWTY90126131909560"
}

results matching ""

    No results matching ""