数据模型说明

应用ID。获取方式请参见AppID管理及关联。

说明： 服务商模式接入，切换到商户应用/元服务拉起收银台时，需要把app_id改成商户相应的appId，并在平台类商户/服务商预下单接口通过subAppId字段同步传递。

商户号。获取商户号请参见查询商户号信息。

说明： 请传递直连、平台/服务商商户号，需要和获取预支付ID商户号保持一致。

随机字符串。最小长度1，最大长度32，传递非取值范围内的值会导致请求异常。推荐随机数生成算法。

每笔订单都需重新生成。

指定三方支付方式。

- L：linkUrl

- S：scheme

客户端凭据。

拉起通用收银台接口requestPayment、cashierPicker响应中获取。

沙盒环境标识。是否使用沙盒环境进行调试，使用沙盒环境调试时必填。

- true：是

- false：否（默认）

referer链接。跳转微信支付时，如传入了referer并且referer有效，则优先使用。

说明： 传递的referer链接有效性校验：

- 域名不为空且必须是HTTPS协议。

- 只保留协议和域名（若传入https://xxx.com/search?xxx=123&yyy=456，则只保留https://xx.com）。

- 最小长度1，最大长度2048。

指定收银台展示的支付方式列表。多个支付方式通过竖线 “|” 分隔，支付方式为在申请产品开通与配置中提供的支付方式。

说明： 例如商户配置3个支付方式（微信支付wechat_pay、支付宝ali_pay、支付宝沙盒ali_pay_sandbox），开发者可传入：

1. wechat_pay|ali_pay（收银台展示微信支付、支付宝）

2. wechat_pay|ali_pay_sandbox（收银台展示微信支付、支付宝沙盒）

备选支付方式。

AP: alternative Payment Type

商户号。获取商户号参见查询商户号信息。

说明： 请传递直连、平台/服务商商户号，和商户证书ID（authId）归属商户号保持一致。

请求Body参数签名，根据签名规则排序拼接后签名。

说明：

GET请求方式请对请求uri进行签名，如请求url为https://www.xxxxxx.com/api/v2/aggr/transactions/merc-orders/202xxx?mercNo=1015xxx ，则签名内容为/api/v2/aggr/transactions/merc-orders/202xxx?mercNo=1015xxx

开发者加密公钥证书Id（获取方式请参见上传开发者公钥）。接口涉及敏感参数（接口字段中说明）请求场景必传，否则无须传递。

开发者指定华为侧使用对应的开发者加密公钥进行响应字段加密返回，开发者使用对应的私钥进行解密。

华为加密公钥证书Id（获取方式请参见下载华为公钥）。接口涉及响应敏感参数（接口字段中说明）场景必传，否则无须传递。

开发者使用对应的华为加密公钥进行API接口请求中隐私字段加密，华为侧使用对应的私钥进行解密。

营销活动类型。

- PROMOTION：营销活动

- COUPON：优惠券

- VOUCHER：支付满减券

- CONSVOUCHER：消费金

活动状态。

- PROMO_FAILED：营销处理失败

- PROMO_UNKNOW：营销状态未知

- PROMO_SUCCESS：营销成功

证件类型。最大长度为2。

01：身份证（默认）

02：军官证

03：护照

04：户口簿

05：士兵证

06：港澳来往内地通行证

07：台湾同胞来往内地通行证

08：临时身份证

09：外国人居留证

10：警官证

15：港澳居民居住证

16：台湾居民居住证

99：其他

证件号。用于校验同名认证支付交易。

隐私字段，需参考敏感信息处理进行加密传递。

最大长度128。

用户真实姓名。用于校验同名认证支付交易。

隐私字段，需参考敏感信息处理进行加密传递。

最大长度256。

文本类型。最大长度为2。

01：身份证号、姓名、证件类型填写全文（默认）

02：身份证填写后六位，姓名、证件类型全文

订单创建与订单完成时IP是否一致。

- true：一致

- false：不一致

子单收款子商户号。

说明：

1. 子商户号必须是子单关联的主订单中传递商户号的子商户。

2. 子订单的商户号不能相同，同一子商户的订单可合并到一个子订单，不用拆分。

交易币种单位，最大长度为3。

CNY （默认，当前仅支持该币种单位）

分账类型。

- NO_ALLOCATION：不分账（默认）。

- DELAY_ORDER_ALLOCATION：延时分账。

注意： 使用该字段需联系开发者的商户对接人协助申请开通分账能力。分账相关操作参见分账交易管理。

订单状态。

- TRX_SUCCESS：交易成功

- TRX_FAILED：交易失败

- TRX_APPLY：交易处理中

交易币种单位，最大长度为3。

CNY （默认，当前仅支持该币种单位）

支付方式。

- WECHAT_MICROPAY：微信小程序支付

- AGMT：快捷

- ACCT：账户余额

- HUAWEIPAY：华为pay

是否为用户推荐平台券。

- true（默认）：platCoupons可指定推荐的平台券；若不指定，则由华为支付默认逻辑处理。

- false：platCoupons字段不生效。

券因子，jsonStr格式，可参见sceneParams。

如平台券有订单金额限制示例：{"tradeOrderAmount": 200}

系统类型枚举，可取值：

- HMOS: HarmonyOS操作系统

券批次类型，可选取值：

- NORMAL：固定面额满减券批次类型。

批次总限额，最大可发放券个数限制，最大值为1000000。

特殊规则：取值范围 0 ≤ value ≤ 1000000。

说明：新建批次时，如果couponCodeMode为MERCHANT_UPLOAD，需要设置为0。

用户限额，用户可领券数，最大值为100。

说明：新建批次时，如果couponCodeMode为HWPAY_MODE或者MERCHANT_API，要求用户限额小于等于批次总限额。

日限额，单天发放上限券数，最大值为1000000。

特殊规则：取值范围 1 ≤ value ≤ 1000000

说明：新建批次时，如果couponCodeMode为HWPAY_MODE或者MERCHANT_API，要求日限额小于等于批次总限额。

投放商家券的位置。

PLATFORM_PUSH：平台流量

MERC_SELF_CHANNEL：商家自有流量

自然人防刷即同证件号下的所有账户合并计算的限领次数。

- true：是

- false：否（默认）

说明：限领次数指的是参数字段“用户最大领取个数”填写的值，当前版本暂不支持。

是否开启可疑账号拦截。

- true：是

- false：否（默认）

说明：如果选择“是”，则需要在发券消息中上报终端用户的设备信息，详情请查看发放优惠券接口。

核销方式。

- FASTAPP：应用/元服务

消费门槛，单位：分。

特殊规则：取值范围 1 ≤ value ≤ 10000000。

是否开启可疑账号拦截（如黑灰产账号）。

- true：是

- false：否（默认）

说明：不填默认“否”，如果选择“是”，则需要在发券消息中上报终端用户的设备信息，详情请查看发券接口。

固定面额满减券使用规则。

说明：当优惠券类型（couponType）为满减券（NORMAL）时，该参数必传。

折扣券使用规则。

说明：当优惠券类型（couponType）为折扣券（DISCOUNT）时，该参数必传。

换购券使用规则。

说明：当优惠券类型（couponType）为换购券（EXCHANGE）时，该参数必传。

核销方式。

- FASTAPP：应用/元服务

批次类型。

- NORMAL：固定面额满减券批次

- DISCOUNT：折扣券批次

- EXCHANGE：换购券批次

商家券状态。

- SENDED：可用

- USED：已核销

- EXPIRED：已过期

- DEACTIVATED：已失效

批次当前状态。

- DEACTIVATED：已停用

- ACTIVATED：已激活

- EXPIRED：已过期

批次归属商户号。注：

- 普通直连模式，该参数为直连商户号。

- 服务商模式，该参数为特约商户号。

- 平台商户模式，该参数为平台子商户号。

优惠券类型。

- NORMAL：满减券

- DISCOUNT：折扣券

- EXCHANGE：换购券

商户发放时接口指定券code。商户上传自定义code，发券时系统随机选取上传的券code。

- HWPAY_MODE：自动分配券code，商户不需要预存code。

- MERCHANT_API：调用发券接口时需指定券code。

- MERCHANT_UPLOAD：需要调用上传预存code接口上传code，调用发券接口时无需指定code。

开始时间，格式为yyyy-MM-dd'T'HH:mm:ss.SSSZ，yyyy-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss.SSS表示时分秒，Z为对应的时区。例如：2023-03-28T17:50:12.000+0800表示，北京时间2023年3月28日 17点50分12秒。

注意：要使用必须传准确的UTC时间。

结束时间，格式为yyyy-MM-dd'T'HH:mm:ss.SSSZ，yyyy-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss.SSS表示时分秒，Z为对应的时区。例如：2023-03-28T17:50:12.000+0800表示，北京时间2023年3月28日 17点50分12秒。

注意：要使用必须传准确的UTC时间。

单品换购价，单位：分。

特殊规则：取值范围 0 ≤ value ≤ 10000000。

消费门槛，单位：分。

特殊规则：取值范围 1 ≤ value ≤ 10000000。

事件通知APPID，最大长度为32。用于回调通知时，计算返回操作用户的openid（比如领券用户），商家私域发券时可以不填写。华为流量场景发券时如果不填写，则不通知商家发券结果。

说明：华为流量场景发券必须填写，并且填写完成之后不建议更改，因为更改后会导致openid发生变化。

消费门槛，单位：分。

特殊规则：取值范围 1 ≤ value ≤ 10000000。

批次开始时间，长度为28，格式为yyyy-MM-dd'T'HH:mm:ss.SSSZ，yyyy-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss.SSS表示时分秒，Z为对应的时区。例如：2023-03-28T17:50:12.000+0800表示，北京时间2023年3月28日 17点50分12秒。

说明：

- 要使用必须传准确的UTC时间。

- 商家券有效期最长为1年。

批次结束时间，长度为28，格式为yyyy-MM-dd'T'HH:mm:ss.SSSZ，yyyy-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss.SSS表示时分秒，Z为对应的时区。例如：2023-03-28T17:50:12.000+0800表示，北京时间2023年3月28日 17点50分12秒。

说明：

- 要使用必须传准确的UTC时间。

- 商家券有效期最长为1年。

- 这个有效期也会影响用户收到的优惠券的有效期，由于券在卡包中展示时是精确到日期，建议endTime需要配置到截止日期的23:59:59。