格式化
transactionReference 格式
transactionReference必须是独特生成的识别码- 如果提供了重复
transactionReference，Try (https://try.access.worldpay.com/) 环境将返回一个失败请求错误 - 最多 64 个字符。我们建议您的
transactionReference包含 9-20 个字符，以方便后续处理 - 这样可保护您不受收单机构影响，后者会截断
transactionReference
transactionReference 支持的格式、结构和限制：
有效字符：
- A-Z
- a-z
- 0-9
- 连字符
- - 下划线
_ - 斜线
/ - 感叹号
! - 艾特符
@ - 英镑、数字符号、升音或井号
# - 美元
$ - 百分比
% - 圆括号
() - 星号
* - 等号
= - 句号
. - 冒号
: - 分号
; - 问号
? - 方括号
[] - 花括号
{} - 波浪号
~ - 加号
+
reference 格式
- 该格式适用于部分结算和部分退款请求的
reference参数 reference必须介于 1-128 个字符之间
有效字符：
- A-Z
- a-z
- 0-9
- 连字符
-
商户落款格式
narrative 对象可帮助您的客户在其对账单中更好地识别您。
商户落款 line1
line1 用于提供有关商户的基本详情。
注释：line1是必需的，必须纳入您的请求中。
line1 支持的格式、结构和限制：
- 这必须是一致的标识符
- 字符限制为 24 个字符（Payouts v1 版为 25 个字符）
- 不保证银行会在客户的对账单上显示该信息
- 有效字符：
- A-Z
- a-z（这些字母在对账单中显示为大写）
- 0-9
- 连字符
- - 句号
. - 逗号
, - 空格
商户落款 line2
line2 用于有关支付或商户的其他上下文，例如订单号或商户电话号码。
注释：line2并非必需。
line2 支持的格式、结构和限制：
- 自由格式
- 字符限制为 24 个字符
- 有效字符：
- A-Z
- a-z（这些字母在对账单中显示为大写）
- 0-9
- 连字符
- - 句号
. - 逗号
, - 空格
narrative （仅限 Payouts API）
narrative 支持的格式、结构和限制：
- 自由格式
- 字符限制为 24 个字符
- 有效字符：
- A-Z
支付服务商格式
pfId- 您从 Mastercard、Visa 和 Amex 收到的支付服务商 ID。
重要信息：请确保您将正确的 pfId 添加到正确的品牌中。
isoId- Mastercard 提供的独立销售机构 (ISO) ID。如果交易涉及到 ISO，则您必须发送此信息。subMerchant- 您的子商户详情包括以下信息：
| 参数 | 描述 |
|---|---|
subMerchant.city | 子商户所在城市。 有效字符：
最多 13 个字符。 |
subMerchant.name | 您的子商户公司名称。 有效字符：
最多 25 个字符。 |
subMerchant.state | 有效字符：
必须为 2 个字符。 |
subMerchant.postalCode | 有效字符：
最多 10 个字符。 |
subMerchant.merchantId | 有效字符：
最多 7 位数。 |
subMerchant.countryCode | 有关更多信息，请参见 |
subMerchant.street | 有效字符：
最多 50 个字符。 |
subMerchant.taxId | 有效字符：
最多 20 个字符。 |
subMerchant.subEmailAddress | 有效字符：
最多 40 个字符。 |
subMerchant.subTelephone | 有效字符：
最多 20 个字符。 |
