支付模板预设变量说明

本节详细介绍支付模板中可用的预设变量，包括其类型、用途及典型示例，帮助开发者高效、安全地进行模板开发。

变量语法规范

模板变量统一采用 ${.变量名} 语法，其中：

${ }：变量包裹符号，固定格式。

.：变量作用域起始标识。

变量名：具体变量名称。

变量名	类型	说明	示例值
templateAssets	string	当前主题静态资源目录	`/templates/pay/default/assets`
templateRoot	string	当前主题根目录	`/templates/pay/default`
domain	string	当前访问域名	`pay.xarr.cn`
baseUrl	string	请求基础网址（含协议）	`https://pay.xarr.cn`

orderInfo 为订单核心信息对象，字段如下：

字段	类型	说明	示例值
order_id	string	订单唯一 ID	`202406010001`
uid	int	用户 ID	`10001`
status	int	订单状态码（见下表）	`2`
status_text	string	订单状态文本	`支付完成`
trade_amount	int	交易金额（分）——用户需支付金额	`1000`
trade_amount_text	string	交易金额（元）	`10.00`
actual_amount	int	实际支付金额（分）	`1000`
actual_account	string	外部收款账号	`alipay@xxx`
actual_account_type	string	外部收款账号类型	`支付宝`
amount	int	订单金额（分）	`1000`
itime	int	创建时间戳（秒）	`1717219200`
utime	int	更新时间戳（秒）	`1717219300`
pay_time	int	支付时间戳（秒）	`1717219400`
expire_time	int	过期时间戳（秒）	`1717220000`
pay_type	string	支付方式标识	`alipay`
pay_type_info	object	支付方式详细信息（见下表）
subject	string	订单标题	`商品购买`
out_order_id	string	外部订单号	`EXT20240601`
account_id	int	账户 ID	`20001`
channel_code	string	通道代码	`ALI_QR`
api_type	string	API 类型	`native`
third_open_id	string	第三方 OpenID	`openid_xxx`
return_uri	string	支付完成后返回 URI 请不要在页面直接展示,否则可能会出现盗刷问题	`/order/return`
plugin_name	string	支付插件名称	`alipay_plugin`

变量名	类型	说明	示例值
contact	string	联系方式（如 QQ）	`123456`
server_time	int	服务器时间戳（秒）	`1717219500`

所有变量均由后端统一注入，模板中无需自行声明。

建议优先使用 trade_amount_text（元）进行金额展示，避免分/元混淆。

变量如为对象，访问其属性请用点号（如 ${.orderInfo.status_text}）。

若需扩展变量，请联系后端开发团队，避免直接在模板中硬编码。