# 创建交易(/trade/create)
该接口为平台商户通过此接口将交易信息上送到蝉鸣，成功后该接口会根据传入参数生成支付链接返回给平台商户端，商户端可做重定向处理后进行支付流程
| 参数名 | 字段名 | 格式 | 必填 | 说明 |
|---|---|---|---|---|
| mid | 商户id | Long(20) | 是 | 商户进件成功后由蝉鸣分配的商户唯一ID |
| ouid | 平台商户用户uid | String(32) | 是 | 平台商户端交易用户的唯一ID，该ID代表后续所有操作的唯一用户同一个真实用户（身份证号或者其他唯一逻辑）传入相同的ouid，否则视为不同用户，可能影响后续支付流程 |
| outTradeNo | 平台商户交易号 | String(32) | 是 | 平台商户端交易的唯一编号，用来和蝉鸣交易关联 |
| subject | 交易标题 | String(50) | 是 | |
| body | 交易信息 | String(64) | 是 | |
| tradeAmount | 交易金额 | Money(8,2) | 是 | 单位 元 |
| channelCode | 交易渠道code | String(5) | 是 | KFQ: 卡分期 600-50000元可用，WX 微信支付 ，ALI 支付宝支付，BTFQ 白条分期 最小10元，JD 京东支付，K12 k12支付方式 |
| expireTime | 交易有效时间 | Integer(4) | 是 | 1～1440之间,不传默认为30 单位 分钟 |
| attach | 额外信息 | String(128) | 否 | 回调时会原样返回 |
| openId | 第三方用户id | String(128) | 否 | 微信openId或者支付宝userId，payMode=UNIFIED时必传，SUBSCRIPTION或者H5模式不传 |
| payMode | 支付模式 | String(20) | 否 | SUBSCRIPTION 公众号支付 默认；MINI_PROGRAM 小程序支付方式，BAR条码支付模式，H5 h5支付模式，UNIFIED 统一下单模式，ZD账单模式 |
| deviceIp | 设备ip地址 | String(20) | 特殊 | openId传入时必传 |
| stageNum | 分期数 | 3,6,9,12,24 | 否 | 分期数 |
| authCode | 授权码 | String(128) | 否 | 传入则为条码支付 |
| industryInfo | 行业信息 | String | 否 | channelCode=K12时必填，详细信息见行业参数列表 |
| notifyUrl | 交易状态通知地址 | String(256) | 是 | 交易结果通知地址 |
| returnUrl | 页面回跳地址 | String(256) | 是 | 前端回跳地址 |
行业参数 （k12）-- 支付通官方通道需要其他通道不需要
| 参数名 | 字段名 | 格式 | 必填 | 说明 |
|---|---|---|---|---|
| userMobile | 家长手机号 | String(11) | 特殊 | 用户手机号，用于在k12标记一个用户，和学生身份证以及学生学号三个必填其一 |
| studentIdCard | 学生身份证 | String(20) | 特殊 | 用于标记一个学生，和家长手机号以及学生学号三个必填其一 |
| studentNumber | 学生学号 | String(20) | 特殊 | 用于标记一个学生，和家长手机号以及学生身份证三个必填其一 |
| chargeType | 收费类型 | String(1) | 否 | N 为必选项，M为可选项 默认为N |
| studentName | 学生姓名 | String(16) | 必填 | 张三 |
| gradeClassName | 年级班级 | String(32) | 必填 | 三年级2班 |
| chargeItems | 缴费项目 | ChargeItem | 否 | 详细字段见缴费项 |
行业参数（k12）缴费项目参数-- 支付通官方通道需要其他通道不需要
| 参数名 | 字段名 | 格式 | 必填 | 说明 |
|---|---|---|---|---|
| itemName | 项目名称 | String(32) | 是 | 伙食费 |
| itemPrice | 项目费用 | String(10) | 是 10.00 单位元 | |
| itemMandatory | 是否必选 | String(1) | 否 | 空或者N为非必填，Y表示必填 |
| itemMaximum | 选项可支持数量 | String(1) | 否 | 1-9 数字，如果为空则表示9 |
| itemSerialNumber | 序列号 | String(2) | 特殊 | 如果为chargeType=M，则此选项必填，从1开始递增的序列号，支付后通过passBackParams 返回 |
汇付斗供
| 参数名 | 字段名 | 格式 | 必填 | 说明 |
|---|---|---|---|---|
| sourceCode | 汇付斗供必填:HF_DG | String(30) | 特殊 | 必填 |
| splitBunch | 分账对象 | Object数组 | 否 | 需要分账时必填 （最多支持7个分账方） |
splitBunch对象
| 参数名 | 字段名 | 格式 | 必填 | 说明 |
|---|---|---|---|---|
| amount | 分账金额 | String(30) | 必填 | 单位元 示例：1000.85 |
| hmMerchantId | 商户mid | String(64) | 必填 | 商户mid |
直付通官方通道
| 参数名 | 字段名 | 格式 | 必填 | 说明 |
|---|---|---|---|---|
| sourceCode | 直付通官方必填:ZFTGF | String(30) | 特殊 | 直付通官方必填 |
| payMode | H5,UNIFIED | String(30) | 特殊 | H5返回支付url；UNIFIED返回Extend信息中支付HTML |
富友通道
| 参数名 | 字段名 | 格式 | 必填 | 说明 |
|---|---|---|---|---|
| sourceCode | 富友通道必填:FY | String(30) | 特殊 | 富友通道必填 |
| payMode | H5 | String(30) | 特殊 | H5返回支付url |
花呗分期
| 参数名 | 字段名 | 格式 | 必填 | 说明 |
|---|---|---|---|---|
| payScene | 费率场景，1.消贴，2.商贴 | String(30) | 特殊 | 花呗分期默认消贴 |
民生中投通道
| 参数名 | 字段名 | 格式 | 必填 | 说明 |
|---|---|---|---|---|
| sourceCode | 民生中投通道必填:CMBCBANK | String(30) | 特殊 | 民生中投通道必填 |
| payMode | H5 | String(30) | 特殊 | H5返回支付url |
| splitBunch | 手续费对象 | Object数组 | 否 | 手续费数组，业务方需要记录手续费时，由业务方计算 |
| extend | 中投活动信息 | Object数组 | 否 | 中投活动信息，业务方需要记录手续费时，由业务方组装 |
splitBunch对象
| 参数名 | 字段名 | 格式 | 必填 | 说明 |
|---|---|---|---|---|
| amount | 到账金额 | String(30) | 特殊 | splitBunch组装时民生中投通道必填 1.签约手续费-活动补贴费率 = 学校费率 2.交易金额*学校费率=手续费 3.到账金额=交易金额-手续费 |
| hmMerchantId | mid | String(64) | 特殊 | 商户mid |
extend对象
| 参数名 | 字段名 | 格式 | 必填 | 说明 |
|---|---|---|---|---|
| activityCode | 活动编号 | String(64) | 特殊 | splitBunch组装时民生中投通道必填 |
| payType | 支付类型 | String(64) | 特殊 | 微信：WEIXIN， 支付宝：ALI |
| subsidyRatio | 活动费率 | String(64) | 特殊 | 活动费率 |
微企付通道
| 参数名 | 字段名 | 格式 | 必填 | 说明 |
|---|---|---|---|---|
| sourceCode | 微企付通道必填:ENTPAY | String(30) | 特殊 | 微企付通道必填 |
| splitBunch | 分账对象 | Object数组 | 是 | 分账数组，微企付通道必填 |
splitBunch对象
| 参数名 | 字段名 | 格式 | 必填 | 说明 |
|---|---|---|---|---|
| amount | 到账金额 | String(30) | 是 | 分账账户到账金额 |
| entId | 分账账户id | String(64) | 是 | 分账账户id |
| entName | 分账账户名称 | String(64) | 是 | 分账账户名称 |
返回结果
| 参数名 | 字段名 | 格式 | 必填 | 说明 |
|---|---|---|---|---|
| payUrl | 支付链接 | String | 是 | 支付url，H5，SUBSCRIPTION支付会返回支付url，打开URL支付即可 |
| extend | 交易额外信息 | Object | 否 | UNIFIED、ZD、BAR模式会返回相关信息，根据信息，唤起支付宝或者微信收银台 |
Extend信息详情
| 参数名 | 字段名 | 格式 | 必填 | 说明 |
|---|---|---|---|---|
| tradeNo | 交易编号 | String(64) | 是 | 校益宝平台交易编号 |
| payId | 支付id | String(64) | 特殊 | 支付id |
| payInfo | 支付信息 | String | 特殊 | 支付额外信息 |
| payStatus | 支付状态 | String | succ、fail、paying、closed cancel | |
| payOutTradeNo | 外部支付交易号 | String(64) | 特殊 | 支付成功时返回 |
| totalAmount | 总金额 | String | 特殊 | 交易总金额 单位 分 |
| currency | 币种 | String | CNY | |
| gmtPayment | 支付时间 | String | 特殊 | 支付成功时返回 |
| bankType | 银行类型 | String(10) | 特殊 | 支付成功时返回 |
| isSubscribe | 是否关注公众号 | String(1) | 特殊 | 支付成功时返回 Y 关注 N未关注 |
| payChannelOrderNo | 支付订单号 | String(64) | 特殊 | 支付成功时返回 |
| merchantOrderNo | 商户订单号 | String(64) | 特殊 | 商户订单号。该订单号与支付宝、微信支付客户端账单详情显示的商户订单号一致，通过该订单后可发起扫码退款或查询交易。 |
| couponFee | 现金券金额 | 现金券金额。仅微信返回，现金券支付金额<=订单总金额，订单总金额-现金券金额为现金支付金额。 | ||
| buyerLogonId | 买家支付宝登录账号 | String | 否 | 被扫支付或者传入openid的支付会返回额外信息如下 |
| buyerUserId | 买家支付宝用户id | 买家支付宝用户id | ||
| credit | 借贷标识 | 可选值：credit：信用卡 pcredit：花呗（仅支付宝）debit：借记卡 balance：余额 unknown：未知 | ||
| receiptAmount | 实收金额 | 实收金额，商户实际入账的金额（扣手续费之前）。仅支付宝返回 | ||
| buyerPayAmount | 用户实付金额，建议打印在小票上避免退款时出现纠纷。仅支付宝返回 | |||
| invoiceAmount | 开票金额 | 开票金额 |