--- title: "收银台会话/session" method: POST path: "/checkout/session" tags: ["check-out-controller"] --- # 收银台会话/session `POST /checkout/session` ## Request body - PaymentRequest — 支付请求信息，包含用于处理支付请求的详细信息。 - `amount` Amount, required — 金额信息。 - `currency` string, required — 三字符的[ISO4217货币代码，https://www.iso.org/iso-4217-currency-codes.html]。 - `value` integer, required — 以自然数表示的 amount 值。默认情况下，此参数的值以最小货币单位为单位。例如，如果货币为 USD，金额为 1.00 USD，则此参数的值设置为 100;或者，如果货币为 JPY 且金额为 ¥1，则将此参数的值设置为 1。 - `paymentMethod` PaymentMethod, required — 支付方式信息，包含有关支付方式的详细信息。 - `type` string, required — 支付方式。 - `bankAccountNumber` string — 银行账号。 - `bankAccountType` string — 银行账户类型。 - `bankLocationId` string — 银行位置ID。 - `billingAddress` string — 账单地址。 - `checkoutAttemptId` string — 结账方式 ID。 - `clickAndCollect` string — 点击提货。 - `cupsecureplusSmscode` string — CupSecurePlus 短信代码。 - `cvc` string — 卡验证代码。 - `deliveryAddress` string — 送货地址。 - `encryptedBankAccountNumber` string — 加密的银行账号。 - `encryptedBankLocationId` string — 加密的银行位置ID。 - `expiryMonth` string — 过期月份。 - `expiryYear` string — 过期年份。 - `firstName` string — 名。 - `fundingSource` 'credit' | 'debit' — 资金来源。 - `holderName` string — 持卡人姓名。 - `iban` string — 国际银行账户号码。 - `issuer` string — 发行人。 - `lastName` string — 姓。 - `openid` string — OpenID。 - `orderID` string — 订单ID。 - `payCardNetwork` string — 支付卡网络。 - `paySessionId` string — 支付会话ID。 - `payToken` string — 支付令牌。 - `payeePreferred` string — 收款人偏好。 - `payerID` string — 付款人ID。 - `payerSelected` string — 付款人选择。 - `personalDetails` string — 个人详细信息。 - `recurringDetailReference` string — 定期支付详细信息参考。 - `shopperEmail` string — 购物者电子邮件。 - `shopperNotificationReference` string — 购物者通知参考。 - `storedPaymentMethodId` string — 存储的支付方式ID。 - `subType` string — 子类型。 - `telephoneNumber` string — 电话号码。 - `transactionId` string — 交易ID。 - `virtualPaymentAddress` string — 虚拟支付地址。 - `reference` string, required — 唯一标识支付的参考。此参考用于您与支付状态的所有通信中。我们建议每笔支付使用唯一值；但这不是必需的。如果需要为交易提供多个参考，请用连字符（"-"）分隔。最大长度：80 个字符。 - `returnUrl` string, required — 在重定向情况下返回的 URL。格式取决于通道。对于 Web，请包含协议 `http://` 或 `https://`。您还可以包含自己的附加查询参数，例如购物者 ID 或订单参考编号。示例：`https://your-company.com/checkout?shopperOrder=12xy` * 对于 iOS，请使用您的应用程序的自定义 URL。要了解更多关于设置自定义 URL 方案的信息，请参阅 [Apple 开发者文档](https://developer.apple.com/documentation/uikit/inter-process_communication/allowing_apps_and_websites_to_link_to_your_content/defining_a_custom_url_scheme_for_your_app)。示例：`my-app://` * 对于 Android，请使用由应用程序中的活动处理的自定义 URL。您可以使用 [intent filter](https://developer.android.com/guide/components/intents-filters) 配置它。示例：`my-app://your.package.name` - `merchantAccount` string — 商户帐户标识符，用于处理交易。 - `accountInfo` AccountInfo — 账户信息。 - `accountAgeIndicator` 'notApplicable' | 'thisTransaction' | 'lessThan30Days' | 'from30To60Days' | 'moreThan60Days' — 指示自该购物者账户在商家的环境中创建以来的时间长度。允许值：notApplicable、thisTransaction、lessThan30Days、from30To60Days、moreThan60Days - `accountChangeDate` string, date-time — 购物者账户上次更改的日期。 - `accountChangeIndicator` 'thisTransaction' | 'lessThan30Days' | 'from30To60Days' | 'moreThan60Days' — 指示自购物者账户上次更新以来的时间长度。允许值：thisTransaction、lessThan30Days、from30To60Days、moreThan60Days - `accountCreationDate` string, date-time — 购物者账户创建的日期。 - `accountType` 'notApplicable' | 'credit' | 'debit' — 指示账户类型。例如，用于多账户卡产品。允许值：notApplicable、credit、debit - `addCardAttemptsDay` integer — 购物者在过去一天中尝试将卡添加到其账户的尝试次数。 - `deliveryAddressUsageDate` string, date-time — 首次使用选定送货地址的日期。 - `deliveryAddressUsageIndicator` 'thisTransaction' | 'lessThan30Days' | 'from30To60Days' | 'moreThan60Days' — 指示自首次使用此送货地址以来的时间长度。允许值：thisTransaction、lessThan30Days、from30To60Days、moreThan60Days - `homePhone` string — 购物者的家庭电话号码（包括国家代码）。 - `mobilePhone` string — 购物者的手机号码（包括国家代码）。 - `passwordChangeDate` string, date-time — 购物者上次更改密码的日期。 - `passwordChangeIndicator` 'notApplicable' | 'thisTransaction' | 'lessThan30Days' | 'from30To60Days' | 'moreThan60Days' — 指示购物者何时更改了密码。允许值：notApplicable、thisTransaction、lessThan30Days、from30To60Days、moreThan60Days - `pastTransactionsDay` integer — 过去24小时内来自此购物者的所有交易（成功和放弃）的数量。 - `pastTransactionsYear` integer — 过去一年内来自此购物者的所有交易（成功和放弃）的数量。 - `paymentAccountAge` string, date-time — 此支付方式添加到购物者账户的日期。 - `paymentAccountIndicator` 'notApplicable' | 'thisTransaction' | 'lessThan30Days' | 'from30To60Days' | 'moreThan60Days' — 指示自此支付方式添加到购物者账户以来的时间长度。允许值：notApplicable、thisTransaction、lessThan30Days、from30To60Days、moreThan60Days - `purchasesLast6Months` integer — 过去六个月的成功购买次数。 - `suspiciousActivity` boolean — 此账户是否记录了可疑活动。 - `workPhone` string — 购物者的工作电话号码（包括国家代码）。 - `additionalAmount` Amount — 金额信息。 - `currency` string, required — 三字符的[ISO4217货币代码，https://www.iso.org/iso-4217-currency-codes.html]。 - `value` integer, required — 以自然数表示的 amount 值。默认情况下，此参数的值以最小货币单位为单位。例如，如果货币为 USD，金额为 1.00 USD，则此参数的值设置为 100;或者，如果货币为 JPY 且金额为 ¥1，则将此参数的值设置为 1。 - `additionalData` object — 此字段包含特定支付请求可能需要的附加数据。`additionalData` 对象由每个条目的键和值组成。 - `applicationInfo` ApplicationInfo — 应用信息。 - `externalPlatform` ExternalPlatform — 集成平台 - `integrator` string — 外部平台集成商。 - `name` string — 字段名称。例如，外部平台名称。 - `version` string — 字段版本。例如，外部平台版本。 - `library` CommonField — 通用字段对象，包含名称和版本等基本属性。 - `name` string — 字段名称。例如，外部平台名称。 - `version` string — 字段的版本。例如，外部平台版本。 - `merchantApplication` CommonField — 通用字段对象，包含名称和版本等基本属性。 - `name` string — 字段名称。例如，外部平台名称。 - `version` string — 字段的版本。例如，外部平台版本。 - `merchantDevice` MerchantDevice — 商户设备信息，包含商户使用设备的详细信息。 - `os` string — 商户设备上运行的操作系统。 - `osVersion` string — 商户设备上操作系统的版本。 - `reference` string — 商户设备的参考。 - `paymentSource` CommonField — 通用字段对象，包含名称和版本等基本属性。 - `name` string — 字段名称。例如，外部平台名称。 - `version` string — 字段的版本。例如，外部平台版本。 - `shopperInteractionDevice` ShopperInteractionDevice — 购物者交互设备信息的对象。 - `locale` string — 购物者交互设备上的区域设置。 - `os` string — 购物者交互设备上运行的操作系统。 - `osVersion` string — 购物者交互设备上的操作系统版本。 - `authenticationData` AuthenticationData — 身份验证数据，包含与3D Secure身份验证相关的配置和数据。 - `attemptAuthentication` 'always' | 'never' — 指示何时应尝试3D Secure身份验证。此选项会覆盖所有其他规则，包括动态3D Secure设置。可能的值： * **always**: 执行3D Secure身份验证。 * **never**: 不执行3D Secure身份验证。如果PSD2 SCA或其他国家法规要求身份验证，则交易将被拒绝。 - `authenticationOnly` boolean — 如果设置为true，您将仅执行3D Secure 2身份验证，而不是支付授权。默认值：false。 - `threeDSRequestData` ThreeDSRequestData — 3D Secure 请求数据的详细信息。 - `challengeWindowSize` 's1' | 's2' | 's3' | 's4' | 's5' — 显示给持卡人的 3DS2 质询窗口的尺寸。可能的值：**01** - 尺寸为 250x400。**02** - 尺寸为 390x400。**03** - 尺寸为 500x600。**04** - 尺寸为 600x400。**05** - 全屏。 - `dataOnly` 'FALSE' | 'TRUE' — 仅数据流的标志。 - `nativeThreeDS` 'preferred' — 指示是否在可用时使用[原生 3D Secure 身份验证]。可能的值：**preferred**：在可用时使用原生 3D Secure 身份验证。 - `threeDSVersion` 'v2_1_0' | 'v2_2_0' — 使用的 3D Secure 版本。可能的值：**2.1.0** ， **2.2.0** - `billingAddress` BillingAddress — 账单地址信息。 - `city` string, required — 城市名称。最大长度：3000个字符。 - `country` string, required — 两个字符的ISO-3166-1 alpha-2国家代码。例如：US。如果您不知道国家或没有从购物者那里收集国家信息，请将`country`提供为`ZZ`。 - `houseNumberOrName` string, required — 房屋号码或名称。最大长度：3000个字符。 - `postalCode` string, required — 美国地址最多五位数字，其他国家地址最多十个字符。 - `stateOrProvince` string — 两个字符的ISO 3166-2州或省代码。例如：美国的CA或加拿大的ON。美国和加拿大必填。 - `street` string, required — 街道名称。最大长度：3000个字符。房屋号码不应包含在此字段中；应通过`houseNumberOrName`单独提供。 - `browserInfo` BrowserInfo — 购物者浏览器信息。 - `acceptHeader` string, required — 购物者浏览器的accept头信息值。 - `colorDepth` integer, required — 购物者浏览器的色深，单位为每像素位数。这应该通过使用浏览器的`screen.colorDepth`属性来获取。可接受的值：1、4、8、15、16、24、30、32或48位色深。 - `javaEnabled` boolean, required — 指示购物者浏览器是否能够执行Java的布尔值。 - `language` string, required — 购物者浏览器的`navigator.language`值（按照IETF BCP 47定义）。 - `screenHeight` integer, required — 购物者设备屏幕的总高度（以像素为单位）。 - `screenWidth` integer, required — 购物者设备屏幕的总宽度（以像素为单位）。 - `timeZoneOffset` integer, required — UTC时间与购物者浏览器本地时间之间的时差，以分钟为单位。 - `userAgent` string, required — 购物者浏览器的用户代理值。 - `javaScriptEnabled` boolean — 指示购物者浏览器是否能够执行JavaScript的布尔值。如果字段不存在，则默认假定值为'true'。 - `captureDelayHours` integer — 授权与计划自动扣款之间的延迟，以小时为单位指定。 - `channel` 'iOS' | 'Android' | 'Web' — 支付交易发生的平台。此字段是可选的，用于过滤仅在特定平台上可用的支付方式。如果未设置此值，我们将尝试从 `sdkVersion` 或 `token` 中推断。可能的值：iOS、Android、Web - `checkoutAttemptId` string — 结账尝试 ID 对应于由客户端 SDK 生成的 ID，用于跟踪用户支付路径。 - `company` Company — 公司信息。 - `homepage` string — 公司网站的主页。 - `name` string — 公司名称。 - `registrationNumber` string — 公司注册号。 - `registryLocation` string — 公司注册地点。 - `taxId` string — 公司税号。 - `type` string — 公司类型。 - `conversionId` string — 转换 ID 对应于由客户端 SDK 生成的 ID，用于跟踪用户支付路径。 - `countryCode` string — 购物者国家。格式：[ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) 示例：NL 或 DE - `dateOfBirth` string — 购物者的出生日期。格式 [ISO-8601](https://www.w3.org/TR/NOTE-datetime)：YYYY-MM-DD - `dccQuote` ForexQuote — 外汇报价，包含外汇交易的详细信息。 - `basePoints` integer, required — 基点。 - `validTill` string, date-time, required — 外汇报价有效期。 - `account` string — 账户名称。 - `accountType` string — 账户类型。 - `baseAmount` Amount — 金额信息。 - `currency` string, required — 三字符的[ISO4217货币代码，https://www.iso.org/iso-4217-currency-codes.html]。 - `value` integer, required — 以自然数表示的 amount 值。默认情况下，此参数的值以最小货币单位为单位。例如，如果货币为 USD，金额为 1.00 USD，则此参数的值设置为 100;或者，如果货币为 JPY 且金额为 ¥1，则将此参数的值设置为 1。 - `buy` Amount — 金额信息。 - `currency` string, required — 三字符的[ISO4217货币代码，https://www.iso.org/iso-4217-currency-codes.html]。 - `value` integer, required — 以自然数表示的 amount 值。默认情况下，此参数的值以最小货币单位为单位。例如，如果货币为 USD，金额为 1.00 USD，则此参数的值设置为 100;或者，如果货币为 JPY 且金额为 ¥1，则将此参数的值设置为 1。 - `interbank` Amount — 金额信息。 - `currency` string, required — 三字符的[ISO4217货币代码，https://www.iso.org/iso-4217-currency-codes.html]。 - `value` integer, required — 以自然数表示的 amount 值。默认情况下，此参数的值以最小货币单位为单位。例如，如果货币为 USD，金额为 1.00 USD，则此参数的值设置为 100;或者，如果货币为 JPY 且金额为 ¥1，则将此参数的值设置为 1。 - `reference` string — 外汇报价请求的参考号。 - `sell` Amount — 金额信息。 - `currency` string, required — 三字符的[ISO4217货币代码，https://www.iso.org/iso-4217-currency-codes.html]。 - `value` integer, required — 以自然数表示的 amount 值。默认情况下，此参数的值以最小货币单位为单位。例如，如果货币为 USD，金额为 1.00 USD，则此参数的值设置为 100;或者，如果货币为 JPY 且金额为 ¥1，则将此参数的值设置为 1。 - `signature` string — 验证完整性的签名。 - `source` string — 外汇报价的来源。 - `type` string — 外汇类型。 - `deliverAt` string, date-time — 购买商品的交货日期和时间。格式 [ISO 8601](https://www.w3.org/TR/NOTE-datetime)：YYYY-MM-DDThh:mm:ss.sssTZD 示例：2017-07-17T13:42:40.428+01:00 - `deliveryAddress` DeliveryAddress — 送货地址信息，包含用于送货的详细地址。 - `city` string, required — 城市名称。最大长度：3000个字符。 - `country` string, required — 两个字符的ISO-3166-1 alpha-2国家代码。例如：US。如果您不知道国家或没有从购物者那里收集国家信息，请将`country`提供为`ZZ`。 - `houseNumberOrName` string, required — 房屋号码或名称。最大长度：3000个字符。 - `postalCode` string, required — 邮政编码。美国地址最多五位数字，其他国家地址最多十个字符。 - `street` string, required — 街道名称。最大长度：3000个字符。房屋号码不应包含在此字段中；应通过 `houseNumberOrName` 单独提供。 - `firstName` string — 收货人名。 - `lastName` string — 收货人姓。 - `stateOrProvince` string — 两个字符的ISO 3166-2州或省代码。例如：美国的CA或加拿大的ON。美国和加拿大必填。 - `deliveryDate` string, date-time — 购买商品的交货日期和时间。格式 [ISO 8601](https://www.w3.org/TR/NOTE-datetime)：YYYY-MM-DDThh:mm:ss.sssTZD 示例：2017-07-17T13:42:40.428+01:00 - `deviceFingerprint` string — 包含购物者设备指纹的字符串。 - `enableOneClick` boolean — 当设置为 true 且提供了 `shopperReference` 时，将询问购物者是否应存储支付详细信息以供将来的一键支付。 - `enablePayOut` boolean — 当设置为 true 且提供了 `shopperReference` 时，支付详细信息将被标记以进行支出。 - `enableRecurring` boolean — 当设置为 true 且提供了 `shopperReference` 时，支付详细信息将被标记以进行定期支付。 - `entityType` 'NaturalPerson' | 'CompanyName' — 处理支付的实体类型。 - `fraudOffset` integer — 一个整数值，添加到正常的欺诈评分中。该值可以是正数或负数。 - `fundOrigin` FundOrigin — 资金来源信息，包含付款人的详细信息。 - `billingAddress` Address — 地址信息。 - `city` string, required — 城市名称。最大长度：3000个字符。 - `country` string, required — 两个字符的ISO-3166-1 alpha-2国家代码。例如：US。如果您不知道国家或没有从购物者那里收集国家信息，请将`country`提供为`ZZ`。 - `houseNumberOrName` string, required — 房屋号码或名称。最大长度：3000个字符。 - `postalCode` string, required — 美国地址最多五位数字，其他国家地址最多十个字符。 - `street` string, required — 街道名称。最大长度：3000个字符。房屋号码不应包含在此字段中；应通过`houseNumberOrName`单独提供。 - `stateOrProvince` string — 两个字符的ISO 3166-2州或省代码。例如，美国的CA或加拿大的ON。美国和加拿大必填。 - `shopperEmail` string — 个人的电子邮件地址。 - `shopperName` string — 个人的姓名。 - `telephoneNumber` string — 个人的电话号码。 - `walletIdentifier` string — 钱包标识符。 - `fundRecipient` FundRecipient — 资金接收人信息，包含接收人的详细信息。 - `billingAddress` Address — 地址信息。 - `city` string, required — 城市名称。最大长度：3000个字符。 - `country` string, required — 两个字符的ISO-3166-1 alpha-2国家代码。例如：US。如果您不知道国家或没有从购物者那里收集国家信息，请将`country`提供为`ZZ`。 - `houseNumberOrName` string, required — 房屋号码或名称。最大长度：3000个字符。 - `postalCode` string, required — 美国地址最多五位数字，其他国家地址最多十个字符。 - `street` string, required — 街道名称。最大长度：3000个字符。房屋号码不应包含在此字段中；应通过`houseNumberOrName`单独提供。 - `stateOrProvince` string — 两个字符的ISO 3166-2州或省代码。例如，美国的CA或加拿大的ON。美国和加拿大必填。 - `paymentMethod` CardDetails — 卡信息。 - `brand` string — 卡的次级品牌。例如：plastix、hmclub。 - `checkoutAttemptId` string — 结账尝试标识符。 - `cupsecureplus.smscode` string - `cvc` string — 卡验证代码。仅在您[完全符合PCI标准]的情况下收集原始卡数据。 - `encryptedCardNumber` string — 加密的卡号。 - `encryptedExpiryMonth` string — 加密的卡到期月份。 - `encryptedExpiryYear` string — 加密的卡到期年份。 - `encryptedSecurityCode` string — 加密的卡验证代码。 - `expiryMonth` string — 卡的到期月份。仅在您[完全符合PCI标准]的情况下收集原始卡数据。 - `expiryYear` string — 卡的到期年份。仅在您[完全符合PCI标准]的情况下收集原始卡数据。 - `fundingSource` 'credit' | 'debit' — 在有多个资金来源时应使用的资金来源。对于巴西组合卡，默认资金来源是信用。如果要使用借记，请将此值设置为debit。 - `holderName` string — 持卡人的姓名。 - `networkPaymentReference` string — 网络令牌引用。这是第一次支付响应中的[`networkTxReference`]。 - `number` string — 卡号。仅在您[完全符合PCI标准]的情况下收集原始卡数据。 - `recurringDetailReference` string — 这是您创建令牌时响应中返回的`recurringDetailReference`。 - `shopperNotificationReference` string — 请求通知购物者时响应中返回的`shopperNotificationReference`。仅用于印度的重复支付。 - `storedPaymentMethodId` string — 这是您创建令牌时响应中返回的`recurringDetailReference`。 - `threeDS2SdkVersion` string — 移动集成所需。3D Secure 2移动SDK的版本。 - `type` 'bcmc' | 'scheme' | 'networkToken' | 'giftcard' | 'card' — 默认支付方式详细信息。适用于方案支付方式和简单支付方式详细信息。 - `shopperEmail` string — 个人的电子邮件地址。 - `shopperName` string — 个人的姓名。 - `shopperReference` string — 用于定期支付的购物者参考号。用于唯一标识购物者，例如用户ID或账户ID。最小长度：3个字符。参考号不得包含个人身份信息（PII），例如姓名或电子邮件地址。 - `storedPaymentMethodId` string — 创建令牌时返回的 `recurringDetailReference`。 - `subMerchant` SubMerchant — 用于定义子商户信息的对象。 - `city` string — 子商户地址的城市。 * 格式：字母数字。 * 最大长度：13 个字符 - `country` string — 子商户地址的三字母国家代码。例如，**BRA** 表示巴西。* 格式：[ISO 3166-1 alpha-3](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3)。* 固定长度：3 个字符 - `mcc` string — 子商户的4位数商户类别代码 (MCC)。* 格式：数字。* 固定长度：4 位数字 - `name` string — 子商户的名称。根据计划规范，此值将覆盖显示在购物者银行对账单上的购物者声明。* 格式：字母数字。 * 最大长度：22 个字符 - `taxId` string — 子商户的税号。* 格式：数字。 * 固定长度：11 位数字的 CPF 或 14 位数字的 CNPJ - `telephoneNumber` string — 个人的电话号码。 - `walletIdentifier` string — 资金去向的指示符。 - `walletOwnerTaxId` string — 资金接收者的税号。 - `industryUsage` 'delayedCharge' | 'installment' | 'noShow' — 金额更新的原因。可能的值：delayedCharge - 延迟收费。noShow - 未到。installment - 分期付款。 - `installments` Installments — 分期付款信息，包含分期付款计划和具体设置。 - `plan` 'regular' | 'revolving' — 分期付款计划，适用于日本的卡分期付款。默认设置为regular。可能的值：regular - 常规分期。revolving - 循环分期。 - `preselectedValue` integer — 预选的分期期数。 - `values` integer[] — 可用的分期期数列表。 - `lineItems` LineItem[] — 购买商品的价格和产品信息，将包含在发送给购物者的发票上。此字段是 3x 4x Oney、Affirm、Afterpay、Clearpay、Klarna、Ratepay 和 Zip 所必需的。 - `amountExcludingTax` integer — 不含税金额，以最小单位表示。 - `amountIncludingTax` integer — 含税金额，以最小单位表示。 - `brand` string — 商品品牌。 - `color` string — 商品颜色。 - `description` string — 订单项描述。 - `id` string — 订单项ID。 - `imageUrl` string — 已购商品图片链接。 - `itemCategory` string — 商品类别，用于支付方式 PayPal 和 Ratepay。 - `manufacturer` string — 商品制造商。 - `productUrl` string — 已购商品链接。 - `quantity` integer — 商品数量。 - `receiverEmail` string — 与购物车中指定商品（通常为电子礼品卡）关联的电子邮件。 - `size` string — 商品尺寸。 - `sku` string — 库存单位。 - `taxAmount` integer — 税额，以最小单位表示。 - `taxPercentage` integer — 税率，以最小单位表示。 - `upc` string — 通用产品代码。 - `localizedShopperStatement` object — `localizedShopperStatement` 字段允许您使用本地字符集的动态值进行购物者声明。如果未提供、留空或跨境交易，将使用shopperStatement。当前支持日本使用日本卡的 Visa 和 Mastercard 支付的 ja-Kana 字符集。此字符集支持：基于 UTF-8 的片假名、大写字母、数字和特殊字符。半宽或全宽字符。 - `mandate` Mandate — 授权信息，包含定期交易的详细设置。 - `amount` string, required — 定期交易的账单金额（以最小单位表示）。 - `endsAt` string, required — 账单计划的结束日期，格式为 YYYY-MM-DD。 - `frequency` 'adhoc' | 'daily' | 'weekly' | 'biWeekly' | 'monthly' | 'quarterly' | 'halfYearly' | 'yearly', required — 购物者应被收取费用的频率。可能的值：adhoc - 临时。daily - 每日。weekly - 每周。biWeekly - 每两周。monthly - 每月。quarterly - 每季度。halfYearly - 每半年。yearly - 每年。 - `amountRule` 'max' | 'exact' — 账单金额的限制规则。可能的值：max：交易金额不能超过 `amount`。exact：交易金额应与 `amount` 相同。 - `billingAttemptsRule` 'on' | 'before' | 'after' — 规定在授权的账单日期内，定期扣款的时间段的规则。可能的值：on：在特定日期。before：在特定日期之前及当天。after：在特定日期之后及当天。 - `billingDay` string — 定期扣款的日期。应在授权账单日期的同一日历月内。可能的值：根据 `frequency`，值为 1-31。 - `remarks` string — UPI 在批准屏幕上向购物者显示的信息。 - `startsAt` string — 账单计划的开始日期，格式为 YYYY-MM-DD。默认情况下，为交易日期。 - `mcc` string — [商户类别代码](https://en.wikipedia.org/wiki/Merchant_category_code) (MCC) 是一个四位数的代码，与特定市场细分相关。此代码反映了商户进行的主要活动。 - `merchantId` string — 商户ID。 - `merchantOrderReference` string — 此参考允许将多个交易链接在一起以进行报告（即订单授权率）。每个计费周期的参考应唯一。首次授权尝试后，同一商户订单参考不得重复使用。如果使用，应为所有传入授权提供此字段。我们强烈建议您发送 `merchantOrderReference` 值，以便在授权重试时利用链接支付请求。此外，我们建议您在 `PaymentRequest.additionalData` 中提供 `retry.orderAttemptNumber`、`retry.chainAttemptNumber` 和 `retry.skipRetry` 值。 - `merchantRiskIndicator` MerchantRiskIndicator — 商户风险指示器，包含与交易相关的风险信息。 - `addressMatch` boolean — 所选的送货地址是否与账单地址相同。 - `deliveryAddressIndicator` 'shipToBillingAddress' | 'shipToVerifiedAddress' | 'shipToNewAddress' | 'shipToStore' | 'digitalGoods' | 'goodsNotShipped' | 'other' — 关于送货地址的指示器。允许的值： `shipToBillingAddress` 、`shipToVerifiedAddress` 、 `shipToNewAddress` 、 `shipToStore` 、 `digitalGoods` 、 `goodsNotShipped` 、 `other` - `deliveryEmail` string — 送货电子邮件地址（用于数字商品）。 - `deliveryEmailAddress` string — 对于电子交付，商品交付到的电子邮件地址。最大长度：254 个字符。 - `deliveryTimeframe` 'electronicDelivery' | 'sameDayShipping' | 'overnightShipping' | 'twoOrMoreDaysShipping' — 预计购物者收到商品的送货时间。允许的值： `electronicDelivery` 、 `sameDayShipping` 、 `overnightShipping` 、 `twoOrMoreDaysShipping` - `giftCardAmount` Amount — 金额信息。 - `currency` string, required — 三字符的[ISO4217货币代码，https://www.iso.org/iso-4217-currency-codes.html]。 - `value` integer, required — 以自然数表示的 amount 值。默认情况下，此参数的值以最小货币单位为单位。例如，如果货币为 USD，金额为 1.00 USD，则此参数的值设置为 100;或者，如果货币为 JPY 且金额为 ¥1，则将此参数的值设置为 1。 - `giftCardCount` integer — 对于预付或礼品卡购买，购买的单个预付或礼品卡/代码的总数。 - `giftCardCurr` string — 对于预付或礼品卡购买，礼品卡的ISO 4217三位货币代码。 - `preOrderDate` string, date-time — 对于预订购买，预计该产品将可供购物者使用的日期。 - `preOrderPurchase` boolean — 指示此交易是否用于预订产品。 - `preOrderPurchaseInd` string — 指示持卡人是否订购了未来可用或发布日期的商品。 - `reorderItems` boolean — 指示购物者是否已经购买了相同的商品。 - `reorderItemsInd` string — 指示持卡人是否重新订购了以前购买的商品。 - `shipIndicator` string — 指示为交易选择的送货方式。 - `metadata` object — 元数据由每个条目的键和值组成。限制：每个请求最多 20 个键值对。超过时，会发生 "177" 错误："元数据大小超出限制"。每个键最多 20 个字符。每个值最多 80 个字符。 - `mpiData` ThreeDSecureData — 3D Secure 数据的详细信息。 - `authenticationResponse` 'Y' | 'N' | 'U' | 'A' — 在 3D Secure 1 中，如果购物者被重定向，则为身份验证响应。在 3D Secure 2 中，这是质询结果中的 `transStatus`。如果交易是无摩擦的，则省略此参数。 - `cavv` string, byte — 持卡人身份验证值（base64 编码，解码后为 20 字节）。 - `cavvAlgorithm` string — 使用的 CAVV 算法。仅适用于 3D Secure 1。 - `challengeCancel` '01' | '02' | '03' | '04' | '05' | '06' | '07' — 指示访问控制服务器 (ACS) 和目录服务器 (DS) 身份验证已取消的指示符。 - `directoryResponse` 'A' | 'C' | 'D' | 'I' | 'N' | 'R' | 'U' | 'Y' — 在 3D Secure 1 中，这是来自 3D 目录服务器的注册响应。在 3D Secure 2 中，这是 `ARes` 中的 `transStatus`。 - `dsTransID` string — 支持 3D Secure 2。由目录服务器 (DS) 分配的唯一交易标识符，用于标识单个交易。 - `eci` string — 电子商务指示符。 - `riskScore` string — 由目录服务器 (DS) 计算的风险评分。Cartes Bancaires 集成所需。 - `threeDSVersion` string — 3D Secure 协议的版本。 - `tokenAuthenticationVerificationValue` string, byte — 网络令牌身份验证值 (TAVV)。网络令牌密码。 - `transStatusReason` string — 提供有关 `transStatus` 字段具有指定值的原因的信息。 - `xid` string, byte — 支持 3D Secure 1。交易标识符（Base64 编码，解码后为 20 字节）。 - `order` EncryptedOrderData — 加密的订单数据，包含与订单相关的敏感信息。 - `orderData` string, required — 加密的订单数据。 - `pspReference` string, required — 属于订单的 `pspReference`，用于唯一标识订单。 - `orderReference` string — 当您进行多次部分（礼品卡）支付时，这是首次支付的 `pspReference`。我们使用此来将多次支付链接在一起。作为链接多次支付的您自己的参考，请改用 `merchantOrderReference`。 - `origin` string — 3D Secure 2 `channel` Web 集成所需。将此参数设置为加载 3D Secure 组件的页面的原始 URL。 - `paymentExchange` string — 支付交换信息。 - `paymentExchangeMarkup` number — 支付交换加价。 - `paymentExchangeRate` string — 支付交换汇率。 - `platformChargebackLogic` PlatformChargebackLogic — 用于定义平台拒付逻辑的对象。 - `behavior` 'deductAccordingToSplitRatio' | 'deductFromLiableAccount' | 'deductFromOneBalanceAccount' — 处理拒付的方法。可能的值：deductFromLiableAccount - 从责任账户扣除。deductFromOneBalanceAccount - 从单一余额账户扣除。deductAccordingToSplitRatio - 根据分摊比例扣除。 - `costAllocationAccount` string — 拒付费用记账的余额账户的唯一标识符。默认情况下，拒付费用记账到您的负责任余额账户。 - `targetAccount` string — 争议金额记账的余额账户的唯一标识符。如果 `behavior` 是 **deductFromOneBalanceAccount**，则为必填项。 - `processingAmount` string — 处理金额。 - `processingCurrency` string — 处理货币。 - `productId` string — 产品ID。 - `recurringExpiry` string — 不再执行授权的日期。仅适用于 3D Secure 2。 - `recurringFrequency` string — 授权之间的最少天数。仅适用于 3D Secure 2。 - `recurringProcessingModel` 'CardOnFile' | 'Subscription' | 'UnscheduledCardOnFile' — 定义定期支付类型。创建用于存储支付详细信息的令牌或使用存储的支付详细信息时需要。允许的值：`Subscription` - 固定或可变金额的交易，遵循固定时间表。`CardOnFile` - 使用文件卡（CoF）交易，卡详细信息被存储以启用一键式或全渠道旅程，或简化结账过程。任何不遵循固定时间表的订阅也被视为文件卡交易。`UnscheduledCardOnFile` - 未安排的文件卡（UCoF）交易是指在非固定时间表上发生且/或金额可变的交易。例如，当持卡人的余额低于某一金额时，自动充值。 - `redirectFromIssuerMethod` string — 指定从发行人重定向回来的重定向方法（GET 或 POST）。 - `redirectToIssuerMethod` string — 指定重定向到发行人的重定向方法（GET 或 POST）。 - `riskData` RiskData — 用于定义风险数据的对象。 - `clientData` string — 包含客户端数据，例如设备指纹、cookie 和特定的浏览器设置。 - `customFields` object — 作为配置风险规则输入的任何自定义字段。 - `fraudOffset` integer — 添加到正常欺诈评分的整数值。该值可以是正数或负数。 - `profileReference` string — 分配给此支付的风险档案。当留空时，将应用商户级账户的默认风险档案。 - `sessionValidity` string — 会话保持有效的日期和时间，格式为 [ISO 8601](https://www.w3.org/TR/NOTE-datetime)。例如：2020-07-18T15:42:40.428+01:00 - `shopperEmail` string — 购物者的电子邮件地址。我们建议您提供此数据，因为它用于速度欺诈检查。对于 3D Secure 2 交易，方案要求所有基于浏览器和移动实施的 `shopperEmail`。 - `shopperIP` string — 购物者的 IP 地址。一般来说，我们建议您提供此数据，因为它用于多种风险检查（例如，支付尝试次数或基于位置的检查）。对于 3D Secure 2 交易，方案要求所有基于浏览器实施的 `shopperIP`。根据您的业务模型，这对于某些商户也是强制性的。 - `shopperInteraction` 'Ecommerce' | 'ContAuth' | 'Moto' | 'POS' — 指定购物者提供其卡详细信息的销售渠道，以及购物者是否是回头客。对于 Web 服务 API，默认假定电子商务购物者交互。此字段有以下可能值：`Ecommerce` - 持卡人在线存在的在线交易。为了更好的授权率，我们建议随请求一起发送卡安全码（CSC）。 `ContAuth` - 文件卡和/或订阅交易，持卡人已知（回头客）。如果购物者在线存在，您也可以提供 CSC 以提高授权（一次点击支付）。`Moto` - 购物者通过电子邮件或电话与商户联系的邮购和电话订单交易。 `POS` - 购物者在场使用安全支付终端进行支付的销售点交易。 - `shopperLocale` string — 用于指定支付语言的语言代码和国家代码组合。 - `shopperName` string - `shopperReference` string — 定期付款所需。您唯一标识此购物者的参考，例如用户 ID 或帐户 ID。最小长度：3 个字符。您的参考不得包含个人身份信息（PII），例如姓名或电子邮件地址。 - `shopperStatement` string — 购物者银行对账单上显示的文本。我们建议发送最多 22 个字符，否则银行可能会截断字符串。允许的字符：**a-z**, **A-Z**, **0-9**, 空格和特殊字符 **. , ' _ - ? + * /_**. - `socialSecurityNumber` string — 购物者的社会安全号码。 - `splits` Split[] — 使用平台时，指定如何拆分支付的对象数组。 - `type` 'BalanceAccount' | 'Commission' | 'Default' | 'MarketPlace' | 'PaymentFee' | 'Remainder' | 'Surcharge' | 'Tip' | 'VAT', required — 分账项目的类型。可能的值：[Classic Platforms integration]: **Commission**，**Default**，**Marketplace**，**PaymentFee**，**VAT**。[Balance Platform]: **BalanceAccount**，**Commission**，**Default**，**PaymentFee**，**Remainder**，**Surcharge**，**Tip**，**VAT**。 - `account` string — 分账金额记账的账户的唯一标识符。如果 `type` 是 **MarketPlace** 或 **BalanceAccount**，则为必填项。[Classic Platforms integration]: 账户的 [`accountCode`]。 [Balance Platform]: 账户的 [`balanceAccountId`]。 - `amount` Amount — 金额信息。 - `currency` string, required — 三字符的[ISO4217货币代码，https://www.iso.org/iso-4217-currency-codes.html]。 - `value` integer, required — 以自然数表示的 amount 值。默认情况下，此参数的值以最小货币单位为单位。例如，如果货币为 USD，金额为 1.00 USD，则此参数的值设置为 100;或者，如果货币为 JPY 且金额为 ¥1，则将此参数的值设置为 1。 - `description` string — 分账项目的描述。 - `reference` string — 分账项目的唯一参考。如果 `type` 是 **MarketPlace** ([Classic Platforms integration]) 或 **BalanceAccount** ([Balance Platform])，则为必填项。对于其他类型，我们也建议提供一个 **唯一** 参考，以便您可以在交易概览和报告中对分账和关联的支付进行对账。 - `store` string — 如果您有平台设置，则平台集成所需，用于处理支付的电子商务或销售点商店。 - `storePaymentMethod` boolean — 当设置为 true 且提供了 `shopperReference` 时，支付详细信息将被存储。 - `telephoneNumber` string — 购物者的电话号码。 - `threeDS2RequestData` ThreeDS2RequestFields — 3D Secure 2 请求字段的对象。 - `acctInfo` AcctInfo — 持卡人信息。 - `chAccAgeInd` '01' | '02' | '03' | '04' | '05' — 持卡人在3DS请求方的账户的时长。允许值：01 — 没有账户。02 — 在此交易期间创建。03 — 少于30天。04 — 30–60天。05 — 超过60天。 - `chAccChange` string — 持卡人在3DS请求方的账户上次更改的日期，包括账单或送货地址、新的支付账户或新的用户添加。格式：YYYYMMDD - `chAccChangeInd` '01' | '02' | '03' | '04' — 自持卡人在3DS请求方的账户信息上次更改以来的时长，包括账单或送货地址、新的支付账户或新的用户添加。允许值：01 — 在此交易期间更改。02 — 少于30天。03 — 30–60天。04 — 超过60天。 - `chAccPwChange` string — 持卡人在3DS请求方的账户更改密码或重置账户的日期。格式：YYYYMMDD - `chAccPwChangeInd` '01' | '02' | '03' | '04' | '05' — 指示自持卡人在3DS请求方的账户更改密码或重置账户以来的时长。允许值：01 — 没有更改。02 — 在此交易期间更改。03 — 少于30天。04 — 30–60天。05 — 超过60天。 - `chAccString` string — 持卡人在3DS请求方开设账户的日期。格式：YYYYMMDD - `nbPurchaseAccount` string — 过去六个月内使用此持卡人账户的购买次数。最大长度：4个字符。 - `paymentAccAge` string — 支付账户在3DS请求方的账户中注册的日期。格式：YYYYMMDD - `paymentAccInd` '01' | '02' | '03' | '04' | '05' — 指示支付账户在3DS请求方的账户中注册的时长。允许值：01 — 没有账户（客人结账）。02 — 在此交易期间。03 — 少于30天。04 — 30–60天。05 — 超过60天。 - `provisionAttemptsDay` string — 过去24小时内的添加卡尝试次数。最大长度：3个字符。 - `shipAddressUsage` string — 此交易使用的送货地址首次用于3DS请求方的日期。格式：YYYYMMDD - `shipAddressUsageInd` '01' | '02' | '03' | '04' — 指示此交易使用的送货地址首次用于3DS请求方的时间。允许值：01 — 此交易。02 — 少于30天。03 — 30–60天。04 — 超过60天。 - `shipNameIndicator` '01' | '02' — 指示账户上的持卡人姓名是否与本次交易使用的收货人姓名相同。允许值：01 — 账户姓名与收货人姓名相同。02 — 账户姓名与收货人姓名不同。 - `suspiciousAccActivity` '01' | '02' — 指示3DS请求方是否在持卡人账户上发现可疑活动（包括之前的欺诈行为）。允许值：01 — 没有发现可疑活动。02 — 发现可疑活动。 - `txnActivityDay` string — 过去24小时内此持卡人账户在3DS请求方处跨所有支付账户的交易次数（成功和放弃的）。最大长度：3个字符。 - `txnActivityYear` string — 过去一年内此持卡人账户在3DS请求方处跨所有支付账户的交易次数（成功和放弃的）。最大长度：3个字符。 - `acctType` '01' | '02' | '03' — 指示账户类型。例如，用于多账户卡产品。长度：2 个字符。允许值：**01** — 不适用。**02** — 信用。**03** — 借记。 - `acquirerBIN` string — 对于[仅身份验证集成]必需。用于 3D Secure 2 的收单 BIN。此字符串应与您在授权中使用的值匹配。在测试平台上使用 123456。 - `acquirerMerchantID` string — 对于[仅身份验证集成]必需。由商户收单行为 3D Secure 2 注册的 merchantId。此字符串应与您在授权中使用的值匹配。在测试平台上使用 123456。 - `addrMatch` 'Y' | 'N' — 指示持卡人送货地址和持卡人账单地址是否相同。允许值： **Y** — 送货地址与账单地址相同。 **N** — 送货地址与账单地址不同。 - `authenticationOnly` boolean — 如果设置为 true，您将只执行 3D Secure 2 身份验证，而不是支付授权。 - `challengeIndicator` 'noPreference' | 'requestNoChallenge' | 'requestChallenge' | 'requestChallengeAsMandate' — 可以指定是否希望接收发卡行的质询。允许值：* `noPreference`、`requestNoChallenge`、`requestChallenge`、`requestChallengeAsMandate` - `deviceRenderOptions` DeviceRenderOptions — 设备渲染选项，包含SDK界面和UI类型的配置。 - `sdkInterface` 'native' | 'html' | 'both' — 支持的 SDK 界面类型。允许值：native、 html、both - `sdkUiType` string[] — 支持显示特定挑战的 UI 类型。允许值：text、singleSelect、outOfBand、otherHtml、multiSelect - `homePhone` Phone — 包含国家代码和订阅者号码的电话号码对象。 - `cc` string — 国家代码。长度：1-3 个字符。 - `subscriber` string — 订阅者号码。最大长度：15 个字符。 - `mcc` string — 对于以外一方为 3D Secure 2 注册的商户，主要是[仅身份验证集成]必需。`mcc` 是一个四位数代码，用于注册先前提供的 `acquirerMerchantID`。 - `merchantName` string — 对于[仅身份验证集成]必需。发卡行在购物者收到质询时向购物者展示的商户名称。我们建议使用与授权中使用的相同值。最大长度为 40 个字符。对于[完整的 3D Secure 2 集成]可选。如果您已经通过我们注册了 3D Secure 2，并且想要覆盖已配置在您帐户上的商户名称，请使用此字段。 - `messageVersion` string — `messageVersion` 值，指示 3D Secure 2 协议版本。 - `mobilePhone` Phone — 包含国家代码和订阅者号码的电话号码对象。 - `cc` string — 国家代码。长度：1-3 个字符。 - `subscriber` string — 订阅者号码。最大长度：15 个字符。 - `notificationURL` string — 发卡行应发送 `CRes` 的 URL。如果您不使用 `channel` **Web** 的组件或使用经典集成 `deviceChannel` **browser**，则必填。 - `payTokenInd` boolean — 值 **true** 表示在接收到 ACS 之前交易已被解令牌化。 - `paymentAuthenticationUseCase` string — 指示请求身份验证的支付类型（消息扩展）。 - `platform` 'iOS' | 'android' | 'browser' — 购物者的平台。允许值：* `iOS` * `android` * `browser` - `purchaseInstalData` string — 指示分期付款的最大授权次数。长度：1-3 个字符。 - `recurringExpiry` string — 不再执行授权的日期。格式：YYYYMMDD - `recurringFrequency` string — 指示授权之间的最小天数。最大长度：4 个字符。 - `sdkAppID` string — 从 3D Secure 2 SDK 接收到的 `sdkAppID` 值。 - `sdkEphemPubKey` SDKEphemPubKey — 用于定义 SDK 临时公钥的对象。 - `crv` string — `crv` 值，如从 3D Secure 2 SDK 接收的。 - `kty` string — `kty` 值，如从 3D Secure 2 SDK 接收的。 - `x` string — `x` 值，如从 3D Secure 2 SDK 接收的。 - `y` string — `y` 值，如从 3D Secure 2 SDK 接收的。 - `sdkMaxTimeout` integer — 3D Secure 2 身份验证过程的最长时间（以分钟为单位）。可选，仅适用于 `deviceChannel` 设置为 **app** 的情况。默认值为 **60** 分钟。 - `sdkReferenceNumber` string — 从 3D Secure 2 SDK 接收到的 `sdkReferenceNumber` 值。 - `sdkTransID` string — 从 3D Secure 2 SDK 接收到的 `sdkTransID` 值。 - `threeDSCompInd` string — 设备指纹识别的完成指示符。 - `threeDSRequestorAuthenticationInd` string — 指示身份验证请求的类型。 - `threeDSRequestorAuthenticationInfo` ThreeDSRequestorAuthenticationInfo — 3DS 请求者身份验证信息。 - `threeDSReqAuthData` string — 记录和支持特定身份验证过程的数据。最大长度：2048 字节。 - `threeDSReqAuthMethod` '01' | '02' | '03' | '04' | '05' | '06' — 持卡人用来向 3DS 请求者进行身份验证的机制。允许值：**01** — 没有发生 3DS 请求者身份验证（例如，持卡人“以访客身份登录”）。**02** — 使用 3DS 请求者自己的凭据登录到持卡人账户。**03** — 使用联合身份登录到持卡人账户。**04** — 使用发卡行凭据登录到持卡人账户。**05** — 使用第三方身份验证登录到持卡人账户。**06** — 使用 FIDO 验证器登录到持卡人账户。 - `threeDSReqAuthTimestamp` string — 持卡人身份验证的 UTC 日期和时间。格式：YYYYMMDDHHMM - `threeDSRequestorChallengeInd` '01' | '02' | '03' | '04' | '05' | '06' — 指示是否请求此交易的质询。可能的值： **01** — 无偏好。**02** — 不请求质询。**03** — 请求质询（3DS 请求者偏好）。**04** — 请求质询（强制要求）。**05** — 不进行质询（已经执行了交易风险分析）。**06** — 仅数据 - `threeDSRequestorID` string — 对于 Visa 的[仅身份验证集成]必需。由目录服务器在您注册 3D Secure 2 时分配的唯一 3D Secure 请求者标识符。 - `threeDSRequestorName` string — 对于 Visa 的[仅身份验证集成]必需。由目录服务器在您注册 3D Secure 2 时分配的唯一 3D Secure 请求者名称。 - `threeDSRequestorPriorAuthenticationInfo` ThreeDSRequestorPriorAuthenticationInfo — 3DS 请求者先前的身份验证信息。 - `threeDSReqPriorAuthData` string — 记录和支持特定身份验证过程的数据。最大长度：2048 字节。 - `threeDSReqPriorAuthMethod` '01' | '02' | '03' | '04' — 持卡人先前用于向 3DS 请求者进行身份验证的机制。允许值：**01** — 由 ACS 执行的无摩擦身份验证。**02** — 由 ACS 执行的持卡人质询。**03** — 验证地址验证服务 (AVS)。**04** — 其他发卡行方法。 - `threeDSReqPriorAuthTimestamp` string — 先前持卡人身份验证的 UTC 日期和时间。格式：YYYYMMDDHHMM - `threeDSReqPriorRef` string — 此数据元素向 ACS 提供附加信息，以确定处理请求的最佳方法。此数据元素包含先前经过身份验证的交易的 ACS 交易 ID。例如，持卡人首次经过身份验证的定期交易。长度：30 个字符。 - `threeDSRequestorURL` string — 在 3D Secure 2 过程中发生技术错误时，显示给购物者的（客户服务）网站的 URL。 - `transType` '01' | '03' | '10' | '11' | '28' — 标识正在验证的交易类型。长度：2 个字符。允许值：**01** — 商品/服务购买。**03** — 支票验收。**10** — 账户资金。**11** — 类现金交易。**28** — 预付激活和充值 - `transactionType` 'goodsOrServicePurchase' | 'checkAcceptance' | 'accountFunding' | 'quasiCashTransaction' | 'prepaidActivationAndLoad' — 标识正在验证的交易类型。允许的值：goodsOrServicePurchase - 商品或服务购买。checkAcceptance - 支票接受。accountFunding - 账户资金注入。quasiCashTransaction - 准现金交易。prepaidActivationAndLoad - 预付卡激活和充值。 - `whiteListStatus` string — 从先前的 3D Secure 2 交易返回的 `whiteListStatus` 值，仅适用于 3D Secure 2 协议版本 2.2.0。 - `workPhone` Phone — 包含国家代码和订阅者号码的电话号码对象。 - `cc` string — 国家代码。长度：1-3 个字符。 - `subscriber` string — 订阅者号码。最大长度：15 个字符。 - `threeDSAuthenticationOnly` boolean — 如果设置为 true，您将只执行3D Secure 2身份验证，而不是支付授权。 - `trustedShopper` boolean — 如果支付应路由到受信任的 MID，请设置为 true。 ## Response `200` 成功 ## Other responses - `201` — 已创建 - `401` — 未经授权 - `403` — 禁止 - `404` — 未找到 --- [API](https://skmtc.dev/futurepay/apis/futurepay-api.md) · [All operations](https://skmtc.dev/futurepay/apis/futurepay-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/futurepay/futurepay-api/revisions/a031b4bbeaa0/schema)