#Interface: CreateOrderParams

#Properties

#amount

amount: string

金额（元）字符串，最多两位小数。务必以服务端价格为准，绝不信任前端传值。

---

#attach?

optional attach?: string

≤128 字符，webhook 原样带回（如内部用户 ID）。

---

#channel?

optional channel?: "alipay" | "chinaums"

支付渠道：缺省或 'alipay'＝支付宝；'chinaums'＝银商，形态由 pay_mode 决定： 'qrcode'＝聚合码（一张码微信/支付宝/云闪付都能扫，pay_url 是二维码内容，前端渲染 成码图、不能 iframe）；'redirect'＝公众号支付（微信/支付宝/云闪付 App 内打开的 H5 页面把用户 302 到 pay_url，银商收银台唤起支付，商户无需自有公众号）。

---

#expire_minutes?

optional expire_minutes?: number

未支付自动关单时限（分钟），默认 15，范围 2 到 1440；到期时刻同步下发到渠道，过期后旧码、旧链接在渠道也付不了。

---

#notify_url?

optional notify_url?: string

这张单的回调地址，http/https，最长 512 字符，三种 webhook 事件都发到它。 只有商户后台「接入配置」把回调方式切成「按单指定」才能传，而且必传，值要和白名单里登记的地址 一字不差（大小写、末尾斜杠都算）；默认的「统一地址」模式下传了报 42202。

---

#out_trade_no

out_trade_no: string

商户订单号：1-64 位字母/数字/下划线，商户侧唯一，也是入账幂等键。

---

#pay_mode

pay_mode: "qrcode" | "redirect"

qrcode=返回可展示的收款地址（支付宝可 iframe / 银商渲染成码图）；redirect=整页跳转地址。

---

#qrcode_width?

optional qrcode_width?: number

qrcode 模式下二维码宽度（px），默认 200，仅支付宝生效。

---

#return_url?

optional return_url?: string

redirect 模式支付完成后的回跳地址（http/https，≤255 字符）。 仅作页面回跳展示，入账一律以 webhook / 查单为准。

---

#subject

subject: string

订单标题，不可含 / = & 特殊字符。