# 创建收银台支付

> 创建收银台支付并获取跳转到 Onerway 托管页面的 redirectUrl。

```yaml
openapi: 3.1.0
info:
  title: 创建收银台支付
  version: 1.0.0
  description: 创建收银台支付并获取跳转到 Onerway 托管页面的 redirectUrl。
paths:
  /txn/payment:
    post:
      summary: 创建收银台支付
      description: 创建收银台支付并获取跳转到 Onerway 托管页面的 redirectUrl。
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                billingInformation:
                  type: string
                  description: 交易账单信息，包括客户账单地址与联系方式。
                  contentMediaType: application/json
                  contentSchema:
                    type: object
                    properties:
                      firstName:
                        type: string
                        description: 客户名字。
                      lastName:
                        type: string
                        description: 客户姓氏。
                      jpFirstName:
                        type: string
                        description: 日语片假名格式的名字；仅日本支付方式和日本发行的卡需要。
                      jpLastName:
                        type: string
                        description: 日语片假名格式的姓氏；仅日本支付方式和日本发行的卡需要。
                      phone:
                        type: string
                        description: 客户电话号码，仅填本地号码（不含国家码）；国家码请单独传入 `phoneCountryCode`，二者组合为完整号码。Onerway
                          当前不强校验格式。
                      phoneCountryCode:
                        type: string
                        description: 客户电话号码的国家拨号码，纯数字、不含 `+`；与 `phone` 组合为完整号码。
                        x-onerway-required: conditional
                        x-onerway-condition:
                          - 当 `lpmsType=MB_WAY` 时必填。
                      email:
                        type: string
                        description: 客户邮箱地址，用于交易确认和争议处理。
                      postalCode:
                        type: string
                        description: 邮政编码；许多地区的 AVS 验证需要此字段。
                      address:
                        type: string
                        description: 完整地址字段，可替代街道、门牌号和城市等拆分字段；开启 AVS 时不建议仅用该字段替代拆分地址字段。
                      country:
                        type: string
                        description: "[ISO 3166-1
                          alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alph\
                          a-2) 国家或地区代码。"
                      province:
                        type: string
                        description: "[ISO
                          3166-2](https://en.wikipedia.org/wiki/ISO_3166-2#Current_code\
                          s) 省/州代码。"
                        x-onerway-required: conditional
                        x-onerway-condition:
                          - 当 `country` 为 `US` 或 `CA` 时必填。
                      city:
                        type: string
                        description: 城市名称。开启 AVS 或需要完整账单地址时建议传入，用于补充地址完整性、授权率和风控判断；不同发卡行和地区的实际校验维度可能不同。
                      street:
                        type: string
                        description: 街道名称。开启 AVS 时建议与 `number`、`postalCode`、`city`
                          拆分传入，作为账单地址验证相关信息；不要仅用完整 `address` 字段替代拆分地址。
                      number:
                        type: string
                        description: 门牌号或建筑号。开启 AVS 时建议与 `street`、`postalCode`、`city` 拆分传入，作为账单地址验证相关信息。
                      identityNumber:
                        type: string
                        description: 政府颁发的身份标识，通常用于特定本地支付方式；可能是身份证号码，也可能是个人税号。
                      birthDate:
                        type: string
                        description: 出生日期，格式为 `yyyy/MM/dd`。
                    required:
                      - email
                      - country
                  x-onerway-format: json_string
                cardInfo:
                  type: string
                  description: 卡支付信息。收银台场景当前仅支持 `holderName`；提供后可预填持卡人姓名。
                  contentMediaType: application/json
                  contentSchema:
                    type: object
                    properties:
                      holderName:
                        type: string
                        description: 持卡人姓名；提供后将预填到收银台支付表单。
                  x-onerway-format: json_string
                lpmsInfo:
                  type: string
                  description: 本地支付方式信息。结合 `productType=ALL` 使用时，设置 `lpmsType` 后收银台仅展示指定本地支付方式。
                  contentMediaType: application/json
                  contentSchema:
                    type: object
                    properties:
                      lpmsType:
                        type: string
                        description: 本地支付方式类型。
                        enum:
                          - GooglePay
                          - ApplePay
                          - JdPay
                          - Alipay+
                          - WeChat
                          - AlipayHK
                          - AlipayCN
                          - Kakao_Pay
                          - Klarna
                          - Boleto
                          - BankTransfer
                          - Banrisul
                          - Bradesco
                          - Banco do Brasil
                          - Itau
                          - MercadoPago
                          - PIX
                          - Servipag
                          - Sencillito
                          - Webpay
                          - Multicaja
                          - Baloto
                          - EFT
                          - Efecty
                          - SPEI
                          - OXXO
                          - OXXOPAY
                          - PagoEfectivo
                          - safetypay-cash
                          - safetypay-online
                          - PayU
                          - Przelewy24
                          - Pagosnet
                          - SEPADD
                          - Sofort
                          - Giropay
                          - iDEAL
                          - Konbini
                          - PayEasy
                          - POLi
                          - Bancontact
                          - OVO
                          - MyBank
                          - Dragonpay
                          - Skrill
                          - eNETS
                          - PayseraWallet
                          - LithuanianBanks
                          - PaySafeCard
                          - Paysafecash
                          - Payconiq
                          - Trustly
                          - PAY_BY_BANK
                          - GCash
                          - GrabPay
                          - PayMaya
                          - ELEVEN
                          - GrabPay SG
                          - TrueMoney Wallet
                          - Rabbit_Line_pay
                          - PromptPay
                          - KRUNGSRI_ONLINE
                          - BUALUANG_IBANKING
                          - CITI_POINTS
                          - K_PLUS
                          - MCASH
                          - TOUCH_GO_EWALLET
                          - ShopeePay
                          - Boost
                          - BNI
                          - MANDIRI
                          - Maybank
                          - PERMATA
                          - BRI
                          - CIMB
                          - DANA
                          - QRIS
                          - AKULAKU
                          - Paypay
                          - LINE_Pay
                          - Merpay
                          - Rakuten_Pay
                          - BitCash
                          - Net_Cash
                          - WebMoney
                          - au
                          - SoftBank
                          - NTT_Docomo
                          - Paidy
                          - BLIK
                          - BLIK_SEAMLESS
                          - cardpay
                          - stcpay
                          - tamara
                          - tabby
                          - MB_WAY
                        x-enum-descriptions:
                          GooglePay: Google Pay 钱包支付方式。
                          ApplePay: Apple Pay 钱包支付方式。
                          JdPay: JD Pay 支付方式。
                          Alipay+: Alipay+ 支付方式。
                          WeChat: 微信支付方式。
                          AlipayHK: 支付宝香港支付方式。
                          AlipayCN: 支付宝中国内地支付方式。
                          Kakao_Pay: Kakao Pay 支付方式。
                          Klarna: Klarna 支付方式。
                          Boleto: Boleto 支付方式。
                          BankTransfer: 银行转账支付方式。
                          Banrisul: Banrisul 银行支付方式。
                          Bradesco: Bradesco 银行支付方式。
                          Banco do Brasil: Banco do Brasil 银行支付方式。
                          Itau: Itaú 银行支付方式。
                          MercadoPago: Mercado Pago 支付方式。
                          PIX: PIX 即时支付方式。
                          Servipag: Servipag 支付方式。
                          Sencillito: Sencillito 支付方式。
                          Webpay: Webpay 支付方式。
                          Multicaja: Multicaja 支付方式。
                          Baloto: Baloto 现金支付方式。
                          EFT: 电子资金转账支付方式。
                          Efecty: Efecty 现金支付方式。
                          SPEI: SPEI 银行转账支付方式。
                          OXXO: OXXO 现金凭证支付方式。
                          OXXOPAY: OXXO Pay 支付方式。
                          PagoEfectivo: PagoEfectivo 现金支付方式。
                          safetypay-cash: SafetyPay Cash 支付方式。
                          safetypay-online: SafetyPay Online 支付方式。
                          PayU: PayU 支付方式。
                          Przelewy24: Przelewy24 支付方式。
                          Pagosnet: Pagosnet 支付方式。
                          SEPADD: SEPA 直接借记支付方式。
                          Sofort: Sofort 支付方式。
                          Giropay: giropay 支付方式。
                          iDEAL: iDEAL 支付方式。
                          Konbini: Konbini 便利店支付方式。
                          PayEasy: Pay-easy 支付方式。
                          POLi: POLi 支付方式。
                          Bancontact: Bancontact 支付方式。
                          OVO: OVO 钱包支付方式。
                          MyBank: MyBank 支付方式。
                          Dragonpay: Dragonpay 支付方式。
                          Skrill: Skrill 支付方式。
                          eNETS: eNETS 支付方式。
                          PayseraWallet: Paysera Wallet 支付方式。
                          LithuanianBanks: 立陶宛银行支付方式。
                          PaySafeCard: paysafecard 预付卡支付方式。
                          Paysafecash: paysafecash 支付方式。
                          Payconiq: Payconiq 支付方式。
                          Trustly: Trustly 支付方式。
                          PAY_BY_BANK: Pay by Bank 银行账户支付方式。
                          GCash: GCash 钱包支付方式。
                          GrabPay: GrabPay 钱包支付方式。
                          PayMaya: Maya 钱包支付方式。
                          ELEVEN: 7-Eleven 支付方式。
                          GrabPay SG: GrabPay Singapore 钱包支付方式。
                          TrueMoney Wallet: TrueMoney Wallet 支付方式。
                          Rabbit_Line_pay: Rabbit LINE Pay 支付方式。
                          PromptPay: PromptPay 支付方式。
                          KRUNGSRI_ONLINE: Krungsri Online 网银支付方式。
                          BUALUANG_IBANKING: Bualuang iBanking 支付方式。
                          CITI_POINTS: Citi Rewards Points 支付方式。
                          K_PLUS: K PLUS 支付方式。
                          MCASH: MCash 钱包支付方式。
                          TOUCH_GO_EWALLET: Touch 'n Go eWallet 支付方式。
                          ShopeePay: ShopeePay 钱包支付方式。
                          Boost: Boost 钱包支付方式。
                          BNI: BNI 虚拟账户支付方式。
                          MANDIRI: Mandiri 虚拟账户支付方式。
                          Maybank: Maybank 虚拟账户支付方式。
                          PERMATA: Permata 虚拟账户支付方式。
                          BRI: BRI 虚拟账户支付方式。
                          CIMB: CIMB 虚拟账户支付方式。
                          DANA: DANA 钱包支付方式。
                          QRIS: QRIS 支付方式。
                          AKULAKU: Akulaku 支付方式。
                          Paypay: PayPay 支付方式。
                          LINE_Pay: LINE Pay 支付方式。
                          Merpay: Merpay 支付方式。
                          Rakuten_Pay: Rakuten Pay 支付方式。
                          BitCash: BitCash 支付方式。
                          Net_Cash: NetCash 支付方式。
                          WebMoney: WebMoney 支付方式。
                          au: au PAY 支付方式。
                          SoftBank: SoftBank 运营商支付方式。
                          NTT_Docomo: d払い（Docomo）运营商支付方式。
                          Paidy: Paidy 支付方式。
                          BLIK: BLIK 支付方式。
                          BLIK_SEAMLESS: BLIK Seamless 支付方式。
                          cardpay: MADA 支付方式。
                          stcpay: stc pay 支付方式。
                          tamara: Tamara 支付方式。
                          tabby: Tabby 支付方式。
                          MB_WAY: MB Way 支付方式。
                      bankName:
                        type: string
                        description: 银行标识。请求中传入枚举项的 `value`，`description` 仅用于说明银行名称。
                        enum:
                          - banco_agrario
                          - banco_av_villas
                          - banco_bbva_colombia_s.a.
                          - banco_caja_social
                          - banco_colpatria
                          - banco_cooperativo_coopcentral
                          - banco_corpbanca_s.a
                          - banco_davivienda
                          - banco_de_bogota
                          - banco_de_occidente
                          - bancofalabella
                          - banco_gnb_sudameris
                          - banco_pichincha_s.a.
                          - banco_procredit
                          - bancolombia
                          - bancoomeva_s.a.
                          - citibank_
                          - itau
                          - nequi
                          - "20"
                          - "26"
                          - "31"
                          - "33"
                          - "43"
                          - "45"
                          - "49"
                          - "52"
                          - "53"
                          - "54"
                          - "64"
                          - "65"
                          - "69"
                          - "85"
                          - "88"
                          - "90"
                          - "95"
                          - "99"
                          - "112"
                          - "119"
                          - "129"
                          - "131"
                          - "136"
                          - "141"
                          - "143"
                          - "144"
                          - "153"
                          - "154"
                          - "158"
                          - "161"
                          - "185"
                          - "222"
                          - "223"
                          - "243"
                          - "266"
                          - "270"
                          - "271"
                          - "272"
                          - "274"
                          - "275"
                          - "279"
                          - "280"
                        x-onerway-enum-variants:
                          - title: EFT
                            when: 当 `lpmsType=EFT` 时。
                            values:
                              - value: banco_agrario
                                description: BANCO AGRARIO
                              - value: banco_av_villas
                                description: BANCO AV VILLAS
                              - value: banco_bbva_colombia_s.a.
                                description: BANCO BBVA COLOMBIA S.A.
                              - value: banco_caja_social
                                description: BANCO CAJA SOCIAL
                              - value: banco_colpatria
                                description: BANCO COLPATRIA
                              - value: banco_cooperativo_coopcentral
                                description: BANCO COOPERATIVO COOPCENTRAL
                              - value: banco_corpbanca_s.a
                                description: BANCO CORPBANCA S.A
                              - value: banco_davivienda
                                description: BANCO DAVIVIENDA
                              - value: banco_de_bogota
                                description: BANCO DE BOGOTA
                              - value: banco_de_occidente
                                description: BANCO DE OCCIDENTE
                              - value: bancofalabella
                                description: BANCO FALABELLA
                              - value: banco_gnb_sudameris
                                description: BANCO GNB SUDAMERIS
                              - value: banco_pichincha_s.a.
                                description: BANCO PICHINCHA S.A.
                              - value: banco_procredit
                                description: BANCO PROCREDIT
                              - value: bancolombia
                                description: BANCOLOMBIA
                              - value: bancoomeva_s.a.
                                description: BANCOOMEVA S.A.
                              - value: citibank_
                                description: CITIBANK
                              - value: itau
                                description: ITAU
                              - value: nequi
                                description: NEQUI
                          - title: Przelewy24
                            when: 当 `lpmsType=Przelewy24` 时。
                            values:
                              - value: "20"
                                description: Santander Bank Polska - Pretzel24 payment system
                              - value: "26"
                                description: Pay with Inteligo
                              - value: "31"
                                description: Pay with iPKO (PKO BP)
                              - value: "33"
                                description: BNP Paribas banking group
                              - value: "43"
                                description: Bank Polska Kasa Opieki Spółka Akcyjna
                              - value: "45"
                                description: Credit Agricole banking group
                              - value: "49"
                                description: ING Bank Śląski
                              - value: "52"
                                description: Inteligo Account
                              - value: "53"
                                description: Powszechna Kasa Oszczędności Bank Polski (iPKO)
                              - value: "54"
                                description: Santander Bank Polska
                              - value: "64"
                                description: Toyota Bank
                              - value: "65"
                                description: Bank Polska Kasa Opieki Spółka Akcyjna
                              - value: "69"
                                description: Volkswagen Bank
                              - value: "85"
                                description: Bank Millennium S.A.
                              - value: "88"
                                description: Pay with Alior Bank
                              - value: "90"
                                description: Nest Bank
                              - value: "95"
                                description: Credit Agricole banking group
                              - value: "99"
                                description: Pay with BOŚ Bank
                              - value: "112"
                                description: Pay with ING Bank
                              - value: "119"
                                description: Pay with Citi Handlowy
                              - value: "129"
                                description: Alior Bank - Installment payments
                              - value: "131"
                                description: Pay with Plus Bank
                              - value: "136"
                                description: mBank - Installment payments
                              - value: "141"
                                description: E-transfer with Pocztowy24
                              - value: "143"
                                description: Cooperative Banks
                              - value: "144"
                                description: Bank Nowy BFG S.A.
                              - value: "153"
                                description: Getin Bank
                              - value: "154"
                                description: Polish mobile payment system
                              - value: "158"
                                description: Noble Pay payment system
                              - value: "161"
                                description: Pay with Idea Bank
                              - value: "185"
                                description: Envelope Bank
                              - value: "222"
                                description: Nest Bank Transfer
                              - value: "223"
                                description: BNP Paribas - Pay with Pl@net
                              - value: "243"
                                description: mBank - mTransfer service
                              - value: "266"
                                description: P24now payment service
                              - value: "270"
                                description: mBank (ITP Service)
                              - value: "271"
                                description: ING Bank Śląski (ITP Service)
                              - value: "272"
                                description: BNP Paribas (ITP Service)
                              - value: "274"
                                description: PKO BP (ITP Service)
                              - value: "275"
                                description: Santander (ITP Service)
                              - value: "279"
                                description: Inteligo (ITP Service)
                              - value: "280"
                                description: mBank - Installment payments
                        x-onerway-required: conditional
                        x-onerway-condition:
                          - 当 `lpmsType=EFT` 或 `lpmsType=Przelewy24` 时必填。
                      walletAccountId:
                        type: string
                        description: 钱包或本地账户标识符。
                        x-onerway-required: conditional
                        x-onerway-condition:
                          - 所选本地支付方式需要采集钱包账户或本地账户标识符时必填。
                      walletAccountName:
                        type: string
                        description: 钱包或本地账户名称。
                        x-onerway-required: conditional
                        x-onerway-condition:
                          - 所选本地支付方式需要采集钱包账户或本地账户名称时必填。
                      iBan:
                        type: string
                        description: 国际银行账号。
                        x-onerway-required: conditional
                        x-onerway-condition:
                          - 在使用 IBAN 进行银行识别的地区转账时必填。
                      prepaidNumber:
                        type: string
                        description: 预付卡或充值卡号。
                        x-onerway-required: conditional
                        x-onerway-condition:
                          - 所选日本预付类支付方式需要采集预付卡或充值卡号时必填。
                    required:
                      - lpmsType
                  x-onerway-format: json_string
                merchantCustId:
                  type: string
                  description: 客户在商户系统中的唯一标识。
                  x-onerway-constraints:
                    - kind: rule
                      text: 非订阅收银台场景下，商户如希望降低复购摩擦，可传入该字段，收银台会向客户提供保存卡信息的选项。
                    - kind: consistency
                      text: 订阅交易中应以 `subscription.merchantCustId` 作为订阅客户标识；外层 `merchantCustId`
                        可不传，若同传则必须与 `subscription.merchantCustId` 保持一致。
                merchantNo:
                  type: string
                  description: Onerway 分配的商户号；获取方式参见[接入准备](/zh/payments/get-started/setup#获取凭证)。
                  x-onerway-constraints:
                    - kind: rule
                      text: 平台模式下传该笔交易所属子商户的商户号，而不是平台商户号；该子商户需已在 Onerway 完成报备。
                merchantTxnId:
                  type: string
                  description: 商户系统生成的每笔支付唯一交易标识，用于交易跟踪、对账和防重复处理。
                merchantTxnTime:
                  type: string
                  description: 商户发起交易的时间戳，格式为 `yyyy-MM-dd HH:mm:ss`；未传时 Onerway 默认使用 UTC+8
                    时区记录交易时间。
                merchantTxnTimeZone:
                  type: string
                  description: "`merchantTxnTime` 对应的时区偏移量；未传时 Onerway 默认使用 UTC+8 时区记录交易时间。"
                metaData:
                  type: string
                  description: 本次交易的商户自定义数据，交易查询和异步通知会原样返回。
                  x-onerway-constraints:
                    - kind: rule
                      text: 必须是包含合法 JSON 的字符串。未传入时，交易查询和异步通知中的 `metaData` 为空。
                    - kind: consistency
                      text: 若外层 `metaData` 与 `subscription.metaData` 同时传入，以 `subscription.metaData`
                        为准。
                orderAmount:
                  type: string
                  description: 指定货币的交易金额，使用十进制字符串。零小数币种必须表示整数金额，可带 `.00` 这类全 0
                    小数；非零小数会被拒绝。格式要求详见[币种与金额校验](/zh/payments/get-started/currency-and-amount)。
                orderCurrency:
                  type: string
                  description: "[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) 三位字母货币代码，需与
                    `orderAmount` 匹配。"
                osType:
                  type: string
                  description: 移动端和应用交易的操作系统类型。收银台建议使用 `WEB` 模式，通常不建议传此字段。
                  enum:
                    - IOS
                    - ANDROID
                  x-enum-descriptions:
                    IOS: iOS 设备。
                    ANDROID: Android 设备。
                  x-onerway-required: conditional
                  x-onerway-condition:
                    - 当 `paymentMode` 为 `APP` 或 `WAP` 时必填。
                paymentMode:
                  type: string
                  description: 交易平台或环境的支付模式；收银台建议使用默认值 `WEB`。
                  enum:
                    - WEB
                    - APP
                    - WAP
                  x-enum-descriptions:
                    WEB: 桌面浏览器支付。
                    APP: 原生移动 App 支付。
                    WAP: 移动浏览器支付。
                paymentMethodOptions:
                  type: string
                  description: 支付方式配置选项。收银台支持 `card` 与 `share` 对象。
                  contentMediaType: application/json
                  contentSchema:
                    type: object
                    properties:
                      card:
                        type: object
                        properties:
                          avsEnabled:
                            type: boolean
                            description: 是否开启 AVS（地址验证服务）验证；使用前需提前联系 Onerway。设为 `true` 时，将使用账单地址进行 AVS
                              验证；验证结果通过交易查询和 Webhook 在
                              `paymentMethodDetails.card.checks` 中返回。
                        description: 卡支付相关的收银台配置。
                      share:
                        type: object
                        properties:
                          profitShare:
                            type: boolean
                            description: 本次交易是否允许分账；启用后该笔交易才可参与后续分账。传 `true` 但未同时传 `profitShareRate`
                              时不会自动分账，仍可使用本次请求返回的
                              `transactionId`，通过[发起分账或分账回退](/zh/payments/api-reference/endpoints/create-or-reverse-profit-share)接口发起分账。
                          profitShareNotifyUrl:
                            type: string
                            description: 接收自动分账及分账回退通知的地址。不传时，不发送自动分账或分账回退通知。
                            x-onerway-constraints:
                              - kind: consistency
                                text: 非空地址必须使用 HTTPS，并与 `profitShare=true` 同时提交，否则支付请求会被拒绝。
                              - kind: rule
                                text: 仅在 `profitShare=true` 时保存该地址。`CAPTURE` 交易继承原 `AUTH`
                                  交易的地址。原支付已配置该地址时，后续分账或分账回退请求无需再传
                                  `urlCallback`。
                          profitShareRate:
                            type: string
                            description: 自动分账比例，`1` 表示 1%，`100` 表示 100%。`SALE` 或 `CAPTURE`
                              成功后按该比例自动分账给平台商户；发生退款或拒付时，按同一比例退还对应的分账金额。
                            x-onerway-constraints:
                              - kind: range
                                min: 1
                                max: 100
                                unit: "%"
                              - kind: rule
                                text: 需传入整数形式的字符串；小数、`0`、负数或大于 100 的取值会被拒绝。
                              - kind: consistency
                                text: 需与 `profitShare=true` 同时传入；`profitShare` 未传或为 `false` 时传入比例会被拒绝。
                        description: 本次交易的分账配置。平台模式下，子商户收到的款项中会有一部分分给平台商户。
                        x-onerway-lifecycle:
                          status: new
                          since: 2026-08-10
                          description:
                            en: New object for transaction profit sharing.
                            zh: 交易分账的新增对象。
                  x-onerway-format: json_string
                productType:
                  type: string
                  description: 收银台支付方式展示范围，用于决定客户在收银台可选择的支付方式类别；后续交易处理方式还需结合 `subProductType` 和
                    `txnType` 判断。
                  enum:
                    - ALL
                    - CARD
                  x-enum-descriptions:
                    ALL: 聚合收银台，展示当前商户和交易条件下可用的所有支付方式；如同时传入 `lpmsInfo.lpmsType`，则仅展示指定本地支付方式。
                    CARD: 仅展示卡支付方式；是否支持预授权、订阅、分期或保存卡等能力，还需结合 `subProductType`、`txnType` 和商户开通配置确认。
                retailers:
                  type: string
                  description: marketplace 交易的零售商信息；订单包含的每个零售商各传入一个对象。
                  contentMediaType: application/json
                  contentSchema:
                    type: array
                    items:
                      type: object
                      properties:
                        retailerId:
                          type: string
                          description: 商户自行定义的零售商唯一标识；需在 marketplace 或商户体系内保持唯一。该标识不是 `merchantNo` 中传入的
                            Onerway 子商户号，两者属于不同的标识体系。
                          x-onerway-constraints:
                            - kind: range
                              max: 64
                              unit: 字符
                        retailerName:
                          type: string
                          description: 零售商名称；建议传入其正式注册名称或对外经营名称。
                          x-onerway-constraints:
                            - kind: range
                              max: 128
                              unit: 字符
                        retailerCountry:
                          type: string
                          description: 零售商所在国家或地区，使用 [ISO 3166-1
                            alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)
                            国家或地区代码。
                      required:
                        - retailerId
                        - retailerName
                        - retailerCountry
                  x-onerway-constraints:
                    - kind: rule
                      text: 适用于 marketplace / 平台模式下商品由第三方零售商销售的场景；仅销售自有商品的商户无需传入。
                    - kind: consistency
                      text: 传入该字段后，`txnOrderMsg.products` 中的每个商品都需要传入 `retailerId`，且取值需命中此处列出的某个零售商。
                  x-onerway-format: json_string
                  x-onerway-lifecycle:
                    status: new
                    since: 2026-08-10
                    description:
                      en: New field for marketplace retailer information.
                      zh: marketplace 零售商信息的新增字段。
                risk3dsStrategy:
                  type: string
                  description: 收银台交易的 3DS 风控策略。
                  enum:
                    - DEFAULT
                    - INNER
                    - NONE
                  x-enum-descriptions:
                    DEFAULT: 默认策略，由 Onerway 根据交易、商户配置和风控判断是否发起 3DS 验证。
                    INNER: 强制使用 Onerway 托管的 3DS 验证流程。
                    NONE: 不走 3DS 验证；是否可用需结合商户配置和风控要求确认。
                  x-onerway-constraints:
                    - kind: unsupported
                      text: 收银台不支持 `EXTERNAL`。
                    - kind: rule
                      text: 如需指定非默认策略，需提前联系 Onerway 确认配置。
                shippingInformation:
                  type: string
                  description: 交易收货信息，包括客户收货地址与联系方式。
                  contentMediaType: application/json
                  contentSchema:
                    type: object
                    properties:
                      firstName:
                        type: string
                        description: 客户名字。
                      lastName:
                        type: string
                        description: 客户姓氏。
                      jpFirstName:
                        type: string
                        description: 日语片假名格式的名字；仅日本支付方式和日本发行的卡需要。
                      jpLastName:
                        type: string
                        description: 日语片假名格式的姓氏；仅日本支付方式和日本发行的卡需要。
                      phone:
                        type: string
                        description: 客户电话号码，仅填本地号码（不含国家码）；国家码请单独传入 `phoneCountryCode`，二者组合为完整号码。Onerway
                          当前不强校验格式。
                      phoneCountryCode:
                        type: string
                        description: 客户电话号码的国家拨号码，纯数字、不含 `+`；与 `phone` 组合为完整号码。
                        x-onerway-required: conditional
                        x-onerway-condition:
                          - 当 `lpmsType=MB_WAY` 时必填。
                      email:
                        type: string
                        description: 客户邮箱地址，用于交易确认和争议处理。
                      postalCode:
                        type: string
                        description: 邮政编码；许多地区的 AVS 验证需要此字段。
                      address:
                        type: string
                        description: 完整地址字段，可替代街道、门牌号和城市等拆分字段；开启 AVS 时不建议仅用该字段替代拆分地址字段。
                      country:
                        type: string
                        description: "[ISO 3166-1
                          alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alph\
                          a-2) 国家或地区代码。"
                      province:
                        type: string
                        description: "[ISO
                          3166-2](https://en.wikipedia.org/wiki/ISO_3166-2#Current_code\
                          s) 省/州代码。"
                        x-onerway-required: conditional
                        x-onerway-condition:
                          - 当 `country` 为 `US` 或 `CA` 时必填。
                      city:
                        type: string
                        description: 城市名称。开启 AVS 或需要完整账单地址时建议传入，用于补充地址完整性、授权率和风控判断；不同发卡行和地区的实际校验维度可能不同。
                      street:
                        type: string
                        description: 街道名称。开启 AVS 时建议与 `number`、`postalCode`、`city`
                          拆分传入，作为账单地址验证相关信息；不要仅用完整 `address` 字段替代拆分地址。
                      number:
                        type: string
                        description: 门牌号或建筑号。开启 AVS 时建议与 `street`、`postalCode`、`city` 拆分传入，作为账单地址验证相关信息。
                      identityNumber:
                        type: string
                        description: 政府颁发的身份标识，通常用于特定本地支付方式；可能是身份证号码，也可能是个人税号。
                      birthDate:
                        type: string
                        description: 出生日期，格式为 `yyyy/MM/dd`。
                    required:
                      - email
                      - country
                  x-onerway-format: json_string
                sign:
                  type: string
                  description: 请求签名字符串；生成方式详见[请求签名](/zh/payments/get-started/request-signing)。
                subProductType:
                  type: string
                  description: 所选支付方式范围下的交易处理模式。
                  enum:
                    - DIRECT
                    - SUBSCRIBE
                    - INSTALLMENT
                  x-enum-descriptions:
                    DIRECT: 普通收银台支付，按 `txnType` 执行一次性扣款或预授权。
                    SUBSCRIBE: 初始订阅交易，用于通过收银台创建订阅合约；需同时传入 `subscription`，后续扣款、取消和更新需走对应订阅接口。
                    INSTALLMENT: 分期交易；需在 `txnOrderMsg.periodValue` 中传入咨询分期期数接口返回的期数值。
                  x-onerway-constraints:
                    - kind: consistency
                      text: 需要与 `productType` 和 `txnType` 配合定义交易模型。
                    - kind: unsupported
                      text: 收银台不支持 `TOKEN`。
                    - kind: rule
                      text: 收银台如需让客户保存支付信息，可在非订阅场景传入 `merchantCustId`，或在托管卡订阅场景使用
                        `subscription.bindCard`。
                subscription:
                  type: string
                  description: 用于通过收银台创建或初始化订阅的信息。本接口仅用于初始订阅；订阅后续扣款、取消、更新需走对应订阅接口。`selfExecute=1`
                    表示托管订阅；`selfExecute=2` 表示自主管理订阅。
                  contentMediaType: application/json
                  contentSchema:
                    type: object
                    properties:
                      requestType:
                        type: string
                        description: 订阅请求类型。本接口仅用于初始订阅，仅支持 `0`。`1` 用于后续扣款场景，本接口不支持传入。
                        enum:
                          - "0"
                        x-enum-descriptions:
                          "0": 初始订阅请求。
                      merchantCustId:
                        type: string
                        description: 订阅客户在商户系统中的唯一标识，用于关联订阅合约、支付信息和交易记录。
                        x-onerway-constraints:
                          - kind: consistency
                            text: 如果外层 `merchantCustId` 同时传入，必须与本字段保持一致；外层 `merchantCustId` 可不传。
                      productName:
                        type: string
                        description: 订阅产品或计划名称。Onerway
                          托管订阅（`selfExecute=1`）必填；商户自主管理订阅（`selfExecute=2`）也支持传入，用于在订阅记录中区分商品或计划。同一用户在订阅结束前不能重复购买同一商品。
                        x-onerway-required: conditional
                        x-onerway-condition:
                          - Onerway 托管订阅（`selfExecute=1`）时必填。
                      amountOff:
                        type: string
                        description: 优惠期内每期订阅扣款减免的固定金额。
                        x-onerway-constraints:
                          - kind: rule
                            text: 使用 decimal string 格式；币种和精度与外层 `orderCurrency`
                              一致，规则见[币种与金额校验](/zh/payments/get-started/currency-and-amount)。
                          - kind: consistency
                            text: 必须大于 `0` 且小于外层 `orderAmount`，以确保实际扣款金额大于 `0`。
                          - kind: unsupported
                            text: 续费请求（`requestType=1`）和托管订阅（`selfExecute=1`）不支持该字段。
                        x-onerway-lifecycle:
                          status: new
                          since: 2026-08-12
                          description:
                            en: New field for fixed-amount discounts on initial merchant-managed
                              subscription cycles.
                            zh: 非托管订阅前若干期固定金额优惠的新增字段。
                      amountOffCycleCount:
                        type: integer
                        description: 享受 `amountOff` 优惠的成功订阅扣款期数；不传时仅首次成功扣款享受优惠。
                        x-onerway-constraints:
                          - kind: range
                            min: 1
                            unit: 期
                          - kind: consistency
                            text: 仅可与 `amountOff` 同时传入；与托管订阅的 `cycleCount` 字段无关。
                          - kind: rule
                            text: 仅成功扣款消耗优惠期数；仅授权、失败、取消和处理中的交易均不消耗。
                          - kind: unsupported
                            text: 续费请求（`requestType=1`）和托管订阅（`selfExecute=1`）不支持该字段。
                        x-onerway-lifecycle:
                          status: new
                          since: 2026-08-12
                          description:
                            en: New field for extending a fixed-amount discount across multiple subscription
                              charges.
                            zh: 将固定金额优惠延续到多期订阅扣款的新增字段。
                      frequencyType:
                        type: string
                        description: 订阅计费频率类型。
                        enum:
                          - D
                          - M
                          - Y
                        x-enum-descriptions:
                          D: 按天计费。
                          M: 按月计费。
                          Y: 按年计费。
                        x-onerway-required: conditional
                        x-onerway-condition:
                          - 通过收银台发起订阅首次购买时必填。
                        x-onerway-constraints:
                          - kind: values
                            text: "`selfExecute=1` 支持 `D`、`M`、`Y`；`selfExecute=2` 仅支持 `D`。"
                      frequencyPoint:
                        type: string
                        description: 计费周期长度，单位由 `frequencyType` 指定。
                        x-onerway-required: conditional
                        x-onerway-condition:
                          - 通过收银台发起订阅首次购买时必填。
                        x-onerway-constraints:
                          - kind: values
                            text: 托管订阅（`selfExecute=1`）中，`frequencyType=D` 时可传
                              `1`、`7`、`14`；`frequencyType=M` 时可传
                              `1`、`3`、`6`；`frequencyType=Y` 时仅可传
                              `1`。自主管理订阅（`selfExecute=2`）中该值没有固定取值集合，表示计费周期的天数，例如月度订阅传
                              `30`、年度订阅传 `365`。
                          - kind: rule
                            text: 自主管理订阅（`selfExecute=2`）中，该值仅用于记录订阅的计费周期：Onerway
                              不据此自动发起扣款，也不校验实际扣款时间是否符合该周期；每期续费扣款由商户自行发起。
                      cycleCount:
                        type: integer
                        description: 托管订阅计费周期数量。
                        x-onerway-required: conditional
                        x-onerway-condition:
                          - 托管订阅中使用固定周期数定义订阅计划时提供。
                        x-onerway-constraints:
                          - kind: range
                            min: 1
                            max: 99
                            unit: 期
                          - kind: unsupported
                            text: "`selfExecute=2` 自主管理订阅不支持。"
                      expireDate:
                        type: string
                        description: 订阅到期日期。
                        x-onerway-required: conditional
                        x-onerway-condition:
                          - 使用到期日期定义订阅结束时间时提供。
                        x-onerway-constraints:
                          - kind: consistency
                            text: 与 `cycleCount` 共享最大期数约束；按 `frequencyType` 和 `frequencyPoint` 推导出的订阅周期不得超过
                              `99` 期。
                      mode:
                        type: string
                        description: 订阅首期扣款方式。
                        enum:
                          - "1"
                          - "2"
                        x-enum-descriptions:
                          "1": 仅获取用户订阅授权，首期扣款改由商户自行发起；仅自主管理订阅（`selfExecute=2`）适用。
                          "2": 获取用户授权后立即完成首期扣款；适用于卡订阅及需用户授权的本地支付方式。
                        x-onerway-constraints:
                          - kind: values
                            text: "`1` 仅获取用户订阅授权并返回授权结果，暂不扣款，首期扣款改由商户自行发起；仅自主管理订阅（`selfExecute=2`）适用。"
                          - kind: rule
                            text: "`2` 获取用户授权后立即完成首期扣款；不传时默认为 `2`。"
                      selfExecute:
                        type: string
                        description: 订阅执行方式。
                        enum:
                          - "1"
                          - "2"
                        x-enum-descriptions:
                          "1": 由 Onerway 按订阅计划自动扣款。
                          "2": 由商户在每个订阅周期主动触发扣款。
                      bindCard:
                        type: boolean
                        description: 托管卡订阅首次支付成功后，是否保存客户的卡。保存结果由 Onerway
                          通过独立的[保存支付方式结果通知](/zh/payments/api-reference/webhooks/payment-method-result)（`txnType=BIND_CARD`）发送。
                        x-onerway-constraints:
                          - kind: rule
                            text: 保存成功时，[保存支付方式结果通知](/zh/payments/api-reference/webhooks/payment-method-result)返回
                              `status=S`，其 `tokenId` 即保存支付方式
                              token，可用于[创建直连交易](/zh/payments/api-reference/endpoints/direct-create-transaction)的
                              `subProductType=TOKEN` 支付；收银台不支持
                              `subProductType=TOKEN`。订阅扣款使用[订阅扣款通知](/zh/payments/api-reference/webhooks/subscription-payment)返回的
                              `contractId` 与 `tokenId`，与保存支付方式 token 是两个不同的
                              token。
                          - kind: rule
                            text: 本地支付方式订阅忽略该字段：其订阅授权结果总会通过保存支付方式结果通知发送。
                          - kind: unsupported
                            text: "`selfExecute=2` 自主管理订阅不支持。"
                      trialFromPlan:
                        type: string
                        description: 托管订阅的试用期计费控制。
                        enum:
                          - "0"
                          - "1"
                        x-enum-descriptions:
                          "0": 试用期不收费。
                          "1": 试用期按订阅计划收费。
                        x-onerway-constraints:
                          - kind: values
                            text: "`0` 表示不计费；`1` 表示按订阅计划计费。"
                          - kind: unsupported
                            text: "`selfExecute=2` 自主管理订阅不支持。"
                      trialDays:
                        type: integer
                        description: 试用期持续天数，用于指定从订阅生效后连续试用多少天。
                        x-onerway-required: conditional
                        x-onerway-condition:
                          - Onerway 托管订阅（`selfExecute=1`）且按天数配置试用期时必填。
                        x-onerway-constraints:
                          - kind: range
                            min: 3
                            max: 365
                            unit: 天
                          - kind: consistency
                            text: 托管订阅支持；与 `trialEnd` 二选一。
                          - kind: unsupported
                            text: "`selfExecute=2` 自主管理订阅不支持。"
                      trialEnd:
                        type: string
                        description: 试用期结束日期，用于直接指定试用期截止到哪一天。
                        x-onerway-required: conditional
                        x-onerway-condition:
                          - Onerway 托管订阅（`selfExecute=1`）且配置试用期结束日期时必填。
                        x-onerway-constraints:
                          - kind: consistency
                            text: 托管订阅支持；与 `trialDays` 二选一。
                          - kind: unsupported
                            text: "`selfExecute=2` 自主管理订阅不支持。"
                      notificationEmail:
                        type: string
                        description: 订阅通知邮箱；订阅确认、状态变更、扣款通知都会发送到该邮箱。
                        x-onerway-constraints:
                          - kind: unsupported
                            text: "`selfExecute=2` 自主管理订阅不支持。"
                      metaData:
                        type: string
                        description: 订阅的商户自定义数据，必须是包含合法 JSON 的字符串。
                        x-onerway-constraints:
                          - kind: consistency
                            text: 若外层 `metaData` 与 `subscription.metaData` 同时传入，以 `subscription.metaData`
                              为准。
                    required:
                      - requestType
                      - merchantCustId
                      - selfExecute
                  x-onerway-required: conditional
                  x-onerway-condition:
                    - 当 `subProductType=SUBSCRIBE` 时必填。
                  x-onerway-format: json_string
                txnOrderMsg:
                  type: string
                  description: 交易业务信息，包含 `returnUrl`、`notifyUrl`、`appId` 和商品信息等。浏览器、设备和持卡人 IP
                    信息由收银台页面侧采集，不在本请求中由商户传入。
                  contentMediaType: application/json
                  contentSchema:
                    type: object
                    properties:
                      returnUrl:
                        type: string
                        description: 客户付款完成后的同步返回地址。建议在 `returnUrl` 后拼接订单号或其他标识，并在客户同步返回时主动查询交易结果。
                      products:
                        type: string
                        description: 顾客购买的商品信息列表；商品金额、折扣和运费合计需要等于 `orderAmount`。
                        contentMediaType: application/json
                        contentSchema:
                          type: array
                          items:
                            type: object
                            properties:
                              name:
                                type: string
                                description: 商品名称。
                              price:
                                type: string
                                description: 商品单价。
                              num:
                                type: string
                                description: 商品数量。
                              currency:
                                type: string
                                description: "[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) 货币代码。"
                              productAvatarUrl:
                                type: string
                                description: 商品图片链接。
                                x-onerway-required: conditional
                                x-onerway-condition:
                                  - 当 `lpmsType` 为 `stcpay`、`tamara`、`tabby` 或
                                    `cardpay` 时必填。
                              desc:
                                type: string
                                description: 商品描述。
                              type:
                                type: string
                                description: 商品类别；默认不填即普通商品。`virtual` 和 `physical` 用于区分是否涉及发货；`shipping_fee` 和
                                  `discount` 可用于所有支付方式。
                                enum:
                                  - virtual
                                  - physical
                                  - shipping_fee
                                  - discount
                                x-enum-descriptions:
                                  virtual: 虚拟商品。
                                  physical: 实物商品。
                                  shipping_fee: 运费商品项。
                                  discount: 折扣商品项，金额需要传负数。
                                x-onerway-required: conditional
                                x-onerway-condition:
                                  - 当 `lpmsType` 为 `stcpay`、`tamara`、`tabby` 或
                                    `cardpay` 时必填；这些支付方式需要区分商品项时使用 `virtual` 或
                                    `physical`。
                              retailerId:
                                type: string
                                description: 销售该商品的零售商标识。
                                x-onerway-required: conditional
                                x-onerway-condition:
                                  - 传入 `retailers` 时必填。
                                x-onerway-constraints:
                                  - kind: consistency
                                    text: 取值必须命中 `retailers` 中的某一个 `retailerId`。
                                x-onerway-lifecycle:
                                  status: new
                                  since: 2026-08-10
                                  description:
                                    en: New field linking each product to its retailer.
                                    zh: 将商品关联到零售商的新增字段。
                            required:
                              - name
                              - price
                              - num
                              - currency
                        x-onerway-format: json_string
                      appId:
                        type: string
                        description: 店铺 ID，商户在 Onerway 入驻时生成并可在后台获取。
                      customerPlatform:
                        type: string
                        description: 商户平台标识。Web 端传网站域名，App 端传应用名称。
                        x-onerway-required: conditional
                        x-onerway-condition:
                          - 当 `lpmsType` 为 `stcpay`、`tamara`、`tabby` 或 `cardpay`
                            时必填。
                      periodValue:
                        type: string
                        description: 分期付款期数，应使用咨询分期期数接口返回的期数值。
                        x-onerway-required: conditional
                        x-onerway-condition:
                          - 外层 `subProductType=INSTALLMENT` 时必填。
                      notifyUrl:
                        type: string
                        description: 支付结果异步通知地址；商户收到 Webhook 通知后建议主动查询确认交易结果。
                    required:
                      - returnUrl
                      - products
                      - appId
                      - notifyUrl
                  x-onerway-format: json_string
                txnType:
                  type: string
                  description: 要执行的支付操作类型；该字段与 `productType`、`subProductType`
                    共同定义交易模型，交易查询和异步通知也会返回。
                  enum:
                    - SALE
                    - AUTH
                  x-enum-descriptions:
                    SALE: 扣款型交易。与 `subProductType=DIRECT` / `SUBSCRIBE` / `INSTALLMENT`
                      组合时，分别用于普通支付、初始订阅或分期交易。
                    AUTH: 预授权型交易，先完成授权不立即请款。通常用于支持预授权的卡支付场景，仍需结合 `productType`、`subProductType`
                      和商户开通配置确认是否可用。
              required:
                - billingInformation
                - merchantNo
                - merchantTxnId
                - orderAmount
                - orderCurrency
                - productType
                - shippingInformation
                - sign
                - subProductType
                - txnOrderMsg
                - txnType
            examples:
              one-time-card:
                summary: 仅银行卡收银台
                value:
                  billingInformation: '{"country":"US","email":"customer@test.com","province":"CA"}'
                  cardInfo: '{"holderName":"Test Cardholder"}'
                  merchantCustId: custId_1784021156
                  merchantNo: replace_with_merchant_no
                  merchantTxnId: card-4f71d2ae-4d0b-4fc2-8f2c-e450cf735baf
                  merchantTxnTime: 2025-08-21 10:17:31
                  orderAmount: "1"
                  orderCurrency: USD
                  productType: CARD
                  shippingInformation: '{"country":"US","email":"customer@test.com","province":"CA"}'
                  sign: 4ee2d1398368a3cad281e97614fc134418922400f61a34c1fc1e81eca40002ba
                  subProductType: DIRECT
                  txnOrderMsg: '{"appId":"replace_with_app_id","products":"[{\"currency\":\"USD\",\"name\":\"test
                    product\",\"num\":\"1\",\"price\":\"1\",\"type\":\"\"}]","returnUrl":"https://developers.onerway.com/example-return","notifyUrl":"https://developers.onerway.com/example-notify"}'
                  txnType: SALE
              one-time-all-methods:
                summary: 展示全部可用支付方式的聚合收银台
                value:
                  billingInformation: '{"country":"US","email":"customer@test.com","province":"CA"}'
                  cardInfo: '{"holderName":"Test Cardholder"}'
                  merchantCustId: custId_1784021159
                  merchantNo: replace_with_merchant_no
                  merchantTxnId: all-711c89ac-304e-41b8-b92c-326270db9eaa
                  merchantTxnTime: 2025-08-21 10:17:31
                  orderAmount: "1"
                  orderCurrency: USD
                  productType: ALL
                  shippingInformation: '{"country":"US","email":"customer@test.com","province":"CA"}'
                  sign: a5b63beb2778c887dd7429fe841c1d6ed3d04c207f21036b091d10157cd33843
                  subProductType: DIRECT
                  txnOrderMsg: '{"appId":"replace_with_app_id","products":"[{\"currency\":\"USD\",\"name\":\"test
                    product\",\"num\":\"1\",\"price\":\"1\",\"type\":\"\"}]","returnUrl":"https://developers.onerway.com/example-return","notifyUrl":"https://developers.onerway.com/example-notify"}'
                  txnType: SALE
              one-time-google-pay:
                summary: 仅展示 Google Pay 的聚合收银台
                value:
                  billingInformation: '{"country":"US","email":"customer@test.com","province":"CA"}'
                  cardInfo: '{"holderName":"Test Cardholder"}'
                  lpmsInfo: '{"lpmsType":"GooglePay"}'
                  merchantCustId: custId_1784021162
                  merchantNo: replace_with_merchant_no
                  merchantTxnId: googlepay-f914bb0e-f7f9-42ba-8268-18159b8f7ee9
                  merchantTxnTime: 2025-08-21 10:17:31
                  orderAmount: "100"
                  orderCurrency: USD
                  productType: ALL
                  shippingInformation: '{"country":"US","email":"customer@test.com","province":"CA"}'
                  sign: 220e3b9a0e59d037d5bb29002c53c734904eb223116d78caf39da44b9979e303
                  subProductType: DIRECT
                  txnOrderMsg: '{"appId":"replace_with_app_id","products":"[{\"currency\":\"USD\",\"name\":\"test
                    product\",\"num\":\"1\",\"price\":\"100\",\"type\":\"\"}]","returnUrl":"https://developers.onerway.com/example-return","notifyUrl":"https://developers.onerway.com/example-notify"}'
                  txnType: SALE
              one-time-apple-pay:
                summary: 仅展示 Apple Pay 的聚合收银台
                value:
                  billingInformation: '{"country":"US","email":"customer@test.com","province":"CA"}'
                  cardInfo: '{"holderName":"Test Cardholder"}'
                  lpmsInfo: '{"lpmsType":"ApplePay"}'
                  merchantCustId: custId_1784021162
                  merchantNo: replace_with_merchant_no
                  merchantTxnId: applepay-0ebc4e9d-c0a8-4ea4-b58d-0b58822de562
                  merchantTxnTime: 2025-08-21 10:17:31
                  orderAmount: "1"
                  orderCurrency: USD
                  productType: ALL
                  shippingInformation: '{"country":"US","email":"customer@test.com","province":"CA"}'
                  sign: 6eecfa0d03ec7d98d52ee27a907735de12d56e658c979fbcd9c4f90179597351
                  subProductType: DIRECT
                  txnOrderMsg: '{"appId":"replace_with_app_id","products":"[{\"currency\":\"USD\",\"name\":\"test
                    product\",\"num\":\"1\",\"price\":\"1\",\"type\":\"\"}]","returnUrl":"https://developers.onerway.com/example-return","notifyUrl":"https://developers.onerway.com/example-notify"}'
                  txnType: SALE
              subscription:
                summary: Onerway 托管扣款的月度银行卡订阅
                value:
                  billingInformation: '{"country":"US","email":"customer@test.com","province":"CA"}'
                  cardInfo: '{"holderName":"Test Cardholder"}'
                  merchantCustId: cust_managed_001
                  merchantNo: replace_with_merchant_no
                  merchantTxnId: managed-monthly-6db3a7cb-eb2d-48e0-8c60-c8501945c5df
                  merchantTxnTime: 2026-04-08 18:00:00
                  orderAmount: "20"
                  orderCurrency: USD
                  productType: CARD
                  shippingInformation: '{"country":"US","email":"customer@test.com","province":"CA"}'
                  sign: 9d9ac005ee7801013cfe5894029f77ebebd7c83584eca581951626e8244416fd
                  subProductType: SUBSCRIBE
                  subscription: '{"requestType":"0","merchantCustId":"cust_managed_001","productName":"Managed
                    Plan -
                    Monthly","frequencyType":"M","frequencyPoint":"1","cycleCount":12,"mode":"2","selfExecute":"1","notificationEmail":"customer@test.com","metaData":"{\"plan\":\"pro-monthly\"}"}'
                  txnOrderMsg: '{"appId":"replace_with_app_id","products":"[{\"currency\":\"USD\",\"name\":\"Managed
                    Subscription
                    Plan\",\"num\":\"1\",\"price\":\"20\",\"type\":\"\"}]","returnUrl":"https://developers.onerway.com/example-return","notifyUrl":"https://developers.onerway.com/example-notify"}'
                  txnType: SALE
              all-methods-monthly-subscription:
                summary: Onerway 托管扣款的月度聚合收银台订阅
                value:
                  billingInformation: '{"country":"US","email":"customer@test.com","province":"CA"}'
                  cardInfo: '{"holderName":"Test Cardholder"}'
                  merchantCustId: cust_all_managed_001
                  merchantNo: replace_with_merchant_no
                  merchantTxnId: all-managed-monthly-35ec60d7-5b40-425b-a18b-bcdf5fff7f65
                  merchantTxnTime: 2026-04-09 10:00:00
                  orderAmount: "20"
                  orderCurrency: USD
                  productType: ALL
                  shippingInformation: '{"country":"US","email":"customer@test.com","province":"CA"}'
                  sign: 13baa9bbfa5bd0b29063a559a9fc9b88aec0cb0560fde1ea362a36ee8d64bdb1
                  subProductType: SUBSCRIBE
                  subscription: '{"requestType":"0","merchantCustId":"cust_all_managed_001","productName":"All-Managed
                    Plan -
                    Monthly","frequencyType":"M","frequencyPoint":"1","cycleCount":12,"selfExecute":"1","mode":"2","notificationEmail":"customer@test.com","metaData":"{\"plan\":\"all-pro-monthly\"}"}'
                  txnOrderMsg: '{"appId":"replace_with_app_id","products":"[{\"currency\":\"USD\",\"name\":\"Managed
                    Subscription
                    Plan\",\"num\":\"1\",\"price\":\"20\",\"type\":\"\"}]","returnUrl":"https://developers.onerway.com/example-return","notifyUrl":"https://developers.onerway.com/example-notify"}'
                  txnType: SALE
              apple-pay-daily-subscription:
                summary: 带多期优惠的 Apple Pay 非托管订阅
                value:
                  billingInformation: '{"country":"US","email":"customer@test.com","province":"CA"}'
                  cardInfo: '{"holderName":"Test Cardholder"}'
                  lpmsInfo: '{"lpmsType":"ApplePay"}'
                  merchantCustId: custId_1745215352000
                  merchantNo: replace_with_merchant_no
                  merchantTxnId: self-managed-daily-2a4f2b18-d342-4fd9-98f7-819b4a292de4
                  merchantTxnTime: 2025-04-21 14:02:32
                  orderAmount: "20"
                  orderCurrency: USD
                  productType: ALL
                  shippingInformation: '{"country":"US","email":"customer@test.com","province":"CA"}'
                  sign: replace_with_calculated_signature
                  subProductType: SUBSCRIBE
                  subscription: '{"requestType":"0","merchantCustId":"custId_1745215352000","productName":"Self-managed-30days-Once
                    daily","amountOff":"5.00","amountOffCycleCount":3,"frequencyType":"D","frequencyPoint":"1","expireDate":"2099-01-01","selfExecute":"2","mode":"2"}'
                  txnOrderMsg: '{"appId":"replace_with_app_id","products":"[{\"currency\":\"USD\",\"name\":\"Subscription
                    Product\",\"num\":\"1\",\"price\":\"20\",\"type\":\"\"}]","returnUrl":"https://developers.onerway.com/example-return","notifyUrl":"https://developers.onerway.com/example-notify"}'
                  txnType: SALE
              pre-authorization:
                summary: 通过收银台预授权银行卡支付
                value:
                  billingInformation: '{"country":"US","email":"customer@test.com","province":"CA"}'
                  cardInfo: '{"holderName":"Test Cardholder"}'
                  merchantCustId: CustId-D3AA-8022
                  merchantNo: replace_with_merchant_no
                  merchantTxnId: 62243ffa-b8e6-4d78-8684-b538f5dbb379
                  merchantTxnTime: 2025-08-21 10:17:31
                  orderAmount: "1"
                  orderCurrency: USD
                  productType: ALL
                  shippingInformation: '{"country":"US","email":"customer@test.com","province":"CA"}'
                  sign: bc16c76eb8d747f62f024b63ae682d60bba03d58f9cd3c828bdda9bdbb568779
                  subProductType: DIRECT
                  txnOrderMsg: '{"appId":"replace_with_app_id","products":"[{\"currency\":\"USD\",\"name\":\"test
                    product\",\"num\":\"1\",\"price\":\"1\",\"type\":\"\"}]","returnUrl":"https://developers.onerway.com/example-return","notifyUrl":"https://developers.onerway.com/example-notify"}'
                  txnType: AUTH
              marketplace-retailers:
                summary: 多零售商 marketplace 收银台
                value:
                  billingInformation: '{"country":"US","email":"customer@test.com","province":"CA"}'
                  merchantNo: replace_with_merchant_no
                  merchantTxnId: mkt-8f1c2d4e-6b70-4a19-9c53-1e7a0d5b2f38
                  merchantTxnTime: 2025-08-21 10:17:31
                  orderAmount: "150.00"
                  orderCurrency: USD
                  productType: ALL
                  retailers: '[{"retailerId":"RTL_100001","retailerName":"ABC Retail
                    Limited","retailerCountry":"GB"},{"retailerId":"RTL_100002","retailerName":"XYZ
                    Store GmbH","retailerCountry":"DE"}]'
                  shippingInformation: '{"country":"US","email":"customer@test.com","province":"CA"}'
                  sign: replace_with_calculated_signature
                  subProductType: DIRECT
                  txnOrderMsg: '{"appId":"replace_with_app_id","products":"[{\"currency\":\"USD\",\"name\":\"Wireless
                    Headphones\",\"num\":\"2\",\"price\":\"50.00\",\"retailerId\":\"RTL_100001\"},{\"currency\":\"USD\",\"name\":\"Desk
                    Lamp\",\"num\":\"1\",\"price\":\"50.00\",\"retailerId\":\"RTL_100002\"}]","returnUrl":"https://developers.onerway.com/example-return","notifyUrl":"https://developers.onerway.com/example-notify"}'
                  txnType: SALE
              automatic-profit-share:
                summary: 配置自动分账通知的支付
                value:
                  billingInformation: '{"country":"US","email":"customer@test.com","province":"CA"}'
                  cardInfo: '{"holderName":"Test Cardholder"}'
                  merchantCustId: example_customer_id
                  merchantNo: replace_with_merchant_no
                  merchantTxnId: example_automatic_profit_share_payment
                  merchantTxnTime: 2026-09-17 10:00:00
                  orderAmount: "1"
                  orderCurrency: USD
                  productType: CARD
                  shippingInformation: '{"country":"US","email":"customer@test.com","province":"CA"}'
                  sign: replace_with_calculated_signature
                  subProductType: DIRECT
                  txnOrderMsg: '{"appId":"replace_with_app_id","products":"[{\"currency\":\"USD\",\"name\":\"test
                    product\",\"num\":\"1\",\"price\":\"1\",\"type\":\"\"}]","returnUrl":"https://developers.onerway.com/example-return","notifyUrl":"https://developers.onerway.com/example-notify"}'
                  txnType: SALE
                  paymentMethodOptions: '{"share":{"profitShare":true,"profitShareRate":"10","profitShareNotifyUrl":"https://developers.onerway.com/example-profit-callback"}}'
      responses:
        "200":
          description: 仅银行卡收银台会话已创建
          content:
            application/json:
              schema:
                type: object
                properties:
                  respCode:
                    type: string
                    description: 响应码；`20000`
                      表示请求处理成功，其余为错误码。完整码表见[响应码](/zh/payments/api-reference/response-codes)。
                  respMsg:
                    type: string
                    description: 响应码对应的可读说明。
                  data:
                    type: object
                    properties:
                      transactionId:
                        type: string
                        description: Onerway 为本次交易生成的交易号，用于跟踪与查询。
                      paymentId:
                        type: string
                        description: 支付意图 ID，标识本次支付；当前一笔请求对应一个 `paymentId`，与 `transactionId` 一一对应。
                      merchantTxnId:
                        type: string
                        description: 商户支付订单号，回显请求中的 `merchantTxnId`。
                      merchantNo:
                        type: string
                        description: Onerway 分配的商户号，标识商户账户。
                      responseTime:
                        type:
                          - string
                          - "null"
                        description: 接口响应时间，格式 `yyyy-MM-dd HH:mm:ss`。
                        x-onerway-value:
                          nullable: true
                          empty: true
                          when:
                            en: Has a value after the transaction is processed; empty at the checkout
                              session creation stage.
                            zh: 交易处理后才有值；会话创建阶段为空。
                      txnTime:
                        type:
                          - string
                          - "null"
                        description: 交易完成时间，格式 `yyyy-MM-dd HH:mm:ss`。
                        x-onerway-value:
                          nullable: true
                          empty: true
                          when:
                            en: Has a value after the transaction completes; empty at the checkout session
                              creation stage.
                            zh: 交易完成后才有值；会话创建阶段为空。
                      orderAmount:
                        type: string
                        description: 原始订单金额，以交易币种计价；以十进制字符串返回，精度遵循提交的 `orderCurrency` 可接受的小数规则。
                      orderCurrency:
                        type: string
                        description: 下单币种，[ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) 三位字母货币代码。
                      txnAmount:
                        type:
                          - string
                          - "null"
                        description: 旧版到账金额字段。
                        x-onerway-value:
                          nullable: true
                          empty: true
                          when:
                            en: Deprecated field; no reliable settlement amount is available from the
                              checkout session creation response.
                            zh: 已弃用字段；收银台会话创建响应中不提供可靠到账金额。
                        deprecated: true
                        x-onerway-deprecated:
                          description:
                            en: Do not rely on this field for the settled amount. The actual settlement
                              amount is settled per settlement batch; refer to
                              the batch settlement details or report.
                            zh: 请勿依赖本字段判断到账金额。实际结算金额按结算批次结算，以对应批次的结算明细 / 结算报表为准。
                      txnCurrency:
                        type:
                          - string
                          - "null"
                        description: 旧版结算币种字段。
                        x-onerway-value:
                          nullable: true
                          empty: true
                          when:
                            en: Deprecated field; no reliable settlement currency is available from the
                              checkout session creation response.
                            zh: 已弃用字段；收银台会话创建响应中不提供可靠结算币种。
                        deprecated: true
                        x-onerway-deprecated:
                          description:
                            en: Do not rely on this field for the settlement currency. The settlement
                              currency follows the settlement configuration
                              pre-agreed between the merchant and Onerway.
                            zh: 请勿依赖本字段判断结算币种。结算币种以商户与 Onerway 预先约定的结算配置为准。
                      txnTimeZone:
                        type:
                          - string
                          - "null"
                        description: 交易时区偏移量，格式 `±HH:mm`。
                        x-onerway-value:
                          nullable: true
                          empty: true
                          when:
                            en: Has a value after the transaction completes; empty at the checkout session
                              creation stage.
                            zh: 交易完成后才有值；会话创建阶段为空。
                      status:
                        type: string
                        description: 当前交易处理状态；收银台会话创建后恒为 `U`（未支付）。
                        enum:
                          - S
                          - F
                          - P
                          - R
                          - N
                          - I
                          - U
                        x-enum-descriptions:
                          S: 交易成功。
                          F: 交易失败。
                          P: 交易处理中。
                          R: 需要跳转以继续支付。
                          N: 交易已取消（含超时未支付关单）。
                          I: 交易审核或审批中。
                          U: 收银台交易未支付或未完成。
                      paymentStatus:
                        type: string
                        description: 支付意图级状态。当前一笔请求对应一个支付意图，`paymentStatus`
                          与交易状态保持一致，暂不支持跨多次尝试的意图状态流转；会话创建后为 `U`。
                        enum:
                          - I
                          - U
                          - P
                          - R
                          - A
                          - O
                          - S
                          - N
                        x-enum-descriptions:
                          I: 支付意图已初始化。
                          U: 支付意图待支付。
                          P: 支付意图处理中。
                          R: 支付意图需要跳转。
                          A: 支付意图已授权。
                          O: 支付意图仍打开。
                          S: 支付意图已成功。
                          N: 支付意图已关闭：超时未完成支付，包括下单后未支付关单与多次尝试均失败后关单。
                      reason:
                        type:
                          - string
                          - "null"
                        description: 交易失败原因说明，供商户排查与向客户提示。
                        x-onerway-value:
                          nullable: true
                          empty: true
                          when:
                            en: Has a value when the transaction is declined or fails; empty when the
                              checkout session is created successfully.
                            zh: 交易被拒绝 / 失败时才有值；会话创建成功时为空。
                      redirectUrl:
                        type: string
                        description: 收银台页面地址；商户应将客户跳转至该地址完成支付流程。
                      sign:
                        type: string
                        description: 响应签名字符串；当前不建议商户对响应验签。
                      contractId:
                        type:
                          - string
                          - "null"
                        description: 订阅合约号，标识订阅，是完成后续扣款的关键参数。
                        x-onerway-value:
                          nullable: true
                          empty: true
                          when:
                            en: Has a value after the initial subscription succeeds via asynchronous
                              notification or query, usually stored together
                              with `tokenId`; empty at checkout session
                              creation.
                            zh: 初始订阅成功后才有值（经异步通知 / 查询），通常与 `tokenId` 成对存储；会话创建时为空。
                      tokenId:
                        type:
                          - string
                          - "null"
                        description: 支付 token，基于买家支付信息生成。可能是订阅 token（用于后续扣款）或卡令牌化 token（用于 token
                          支付）；两者属不同体系、不可混用。需按 PCI 要求妥善保管。
                        x-onerway-value:
                          nullable: true
                          empty: true
                          when:
                            en: Has a value after the initial subscription or card tokenization succeeds via
                              asynchronous notification or query; empty at
                              checkout session creation.
                            zh: 初始订阅成功或卡令牌化成功后才有值（经异步通知 / 查询）；会话创建时无值。
                      tokenization:
                        type:
                          - string
                          - "null"
                        description: 收银台流程产生 tokenization 数据时返回的 tokenization 结果。
                        x-onerway-value:
                          nullable: true
                          when:
                            en: No tokenization result is available for the checkout session.
                            zh: 当前收银台会话没有可用的 tokenization 结果时返回 null。
                      eci:
                        type:
                          - string
                          - "null"
                        description: 电子商务指示符（ECI），标识交易安全等级与责任转移。
                        x-onerway-value:
                          nullable: true
                          empty: true
                          when:
                            en: Has a value only for 3DS transactions.
                            zh: 3DS 交易才有值。
                      transactionOrderNo:
                        type:
                          - string
                          - "null"
                        description: 下游支付处理过程中分配的交易订单号。
                        x-onerway-value:
                          nullable: true
                          when:
                            en: No downstream transaction order number has been assigned at checkout session
                              creation.
                            zh: 收银台会话创建时尚未分配下游交易订单号时返回 null。
                      periodValue:
                        type:
                          - string
                          - "null"
                        description: 分期付款期数。
                        x-onerway-value:
                          nullable: true
                          empty: true
                          when:
                            en: Has a value only for installment transactions.
                            zh: 分期交易才有值。
                      lpmsType:
                        type:
                          - string
                          - "null"
                        description: 本次交易使用的本地支付方式类型。
                        enum:
                          - GooglePay
                          - ApplePay
                          - JdPay
                          - Alipay+
                          - WeChat
                          - AlipayHK
                          - AlipayCN
                          - Kakao_Pay
                          - Klarna
                          - Boleto
                          - BankTransfer
                          - Banrisul
                          - Bradesco
                          - Banco do Brasil
                          - Itau
                          - MercadoPago
                          - PIX
                          - Servipag
                          - Sencillito
                          - Webpay
                          - Multicaja
                          - Baloto
                          - EFT
                          - Efecty
                          - SPEI
                          - OXXO
                          - OXXOPAY
                          - PagoEfectivo
                          - safetypay-cash
                          - safetypay-online
                          - PayU
                          - Przelewy24
                          - Pagosnet
                          - SEPADD
                          - Sofort
                          - Giropay
                          - iDEAL
                          - Konbini
                          - PayEasy
                          - POLi
                          - Bancontact
                          - OVO
                          - MyBank
                          - Dragonpay
                          - Skrill
                          - eNETS
                          - PayseraWallet
                          - LithuanianBanks
                          - PaySafeCard
                          - Paysafecash
                          - Payconiq
                          - Trustly
                          - PAY_BY_BANK
                          - GCash
                          - GrabPay
                          - PayMaya
                          - ELEVEN
                          - GrabPay SG
                          - TrueMoney Wallet
                          - Rabbit_Line_pay
                          - PromptPay
                          - KRUNGSRI_ONLINE
                          - BUALUANG_IBANKING
                          - CITI_POINTS
                          - K_PLUS
                          - MCASH
                          - TOUCH_GO_EWALLET
                          - ShopeePay
                          - Boost
                          - BNI
                          - MANDIRI
                          - Maybank
                          - PERMATA
                          - BRI
                          - CIMB
                          - DANA
                          - QRIS
                          - AKULAKU
                          - Paypay
                          - LINE_Pay
                          - Merpay
                          - Rakuten_Pay
                          - BitCash
                          - Net_Cash
                          - WebMoney
                          - au
                          - SoftBank
                          - NTT_Docomo
                          - Paidy
                          - BLIK
                          - BLIK_SEAMLESS
                          - cardpay
                          - stcpay
                          - tamara
                          - tabby
                          - MB_WAY
                          - null
                        x-enum-descriptions:
                          GooglePay: Google Pay 钱包支付方式。
                          ApplePay: Apple Pay 钱包支付方式。
                          JdPay: JD Pay 支付方式。
                          Alipay+: Alipay+ 支付方式。
                          WeChat: 微信支付方式。
                          AlipayHK: 支付宝香港支付方式。
                          AlipayCN: 支付宝中国内地支付方式。
                          Kakao_Pay: Kakao Pay 支付方式。
                          Klarna: Klarna 支付方式。
                          Boleto: Boleto 支付方式。
                          BankTransfer: 银行转账支付方式。
                          Banrisul: Banrisul 银行支付方式。
                          Bradesco: Bradesco 银行支付方式。
                          Banco do Brasil: Banco do Brasil 银行支付方式。
                          Itau: Itaú 银行支付方式。
                          MercadoPago: Mercado Pago 支付方式。
                          PIX: PIX 即时支付方式。
                          Servipag: Servipag 支付方式。
                          Sencillito: Sencillito 支付方式。
                          Webpay: Webpay 支付方式。
                          Multicaja: Multicaja 支付方式。
                          Baloto: Baloto 现金支付方式。
                          EFT: 电子资金转账支付方式。
                          Efecty: Efecty 现金支付方式。
                          SPEI: SPEI 银行转账支付方式。
                          OXXO: OXXO 现金凭证支付方式。
                          OXXOPAY: OXXO Pay 支付方式。
                          PagoEfectivo: PagoEfectivo 现金支付方式。
                          safetypay-cash: SafetyPay Cash 支付方式。
                          safetypay-online: SafetyPay Online 支付方式。
                          PayU: PayU 支付方式。
                          Przelewy24: Przelewy24 支付方式。
                          Pagosnet: Pagosnet 支付方式。
                          SEPADD: SEPA 直接借记支付方式。
                          Sofort: Sofort 支付方式。
                          Giropay: giropay 支付方式。
                          iDEAL: iDEAL 支付方式。
                          Konbini: Konbini 便利店支付方式。
                          PayEasy: Pay-easy 支付方式。
                          POLi: POLi 支付方式。
                          Bancontact: Bancontact 支付方式。
                          OVO: OVO 钱包支付方式。
                          MyBank: MyBank 支付方式。
                          Dragonpay: Dragonpay 支付方式。
                          Skrill: Skrill 支付方式。
                          eNETS: eNETS 支付方式。
                          PayseraWallet: Paysera Wallet 支付方式。
                          LithuanianBanks: 立陶宛银行支付方式。
                          PaySafeCard: paysafecard 预付卡支付方式。
                          Paysafecash: paysafecash 支付方式。
                          Payconiq: Payconiq 支付方式。
                          Trustly: Trustly 支付方式。
                          PAY_BY_BANK: Pay by Bank 银行账户支付方式。
                          GCash: GCash 钱包支付方式。
                          GrabPay: GrabPay 钱包支付方式。
                          PayMaya: Maya 钱包支付方式。
                          ELEVEN: 7-Eleven 支付方式。
                          GrabPay SG: GrabPay Singapore 钱包支付方式。
                          TrueMoney Wallet: TrueMoney Wallet 支付方式。
                          Rabbit_Line_pay: Rabbit LINE Pay 支付方式。
                          PromptPay: PromptPay 支付方式。
                          KRUNGSRI_ONLINE: Krungsri Online 网银支付方式。
                          BUALUANG_IBANKING: Bualuang iBanking 支付方式。
                          CITI_POINTS: Citi Rewards Points 支付方式。
                          K_PLUS: K PLUS 支付方式。
                          MCASH: MCash 钱包支付方式。
                          TOUCH_GO_EWALLET: Touch 'n Go eWallet 支付方式。
                          ShopeePay: ShopeePay 钱包支付方式。
                          Boost: Boost 钱包支付方式。
                          BNI: BNI 虚拟账户支付方式。
                          MANDIRI: Mandiri 虚拟账户支付方式。
                          Maybank: Maybank 虚拟账户支付方式。
                          PERMATA: Permata 虚拟账户支付方式。
                          BRI: BRI 虚拟账户支付方式。
                          CIMB: CIMB 虚拟账户支付方式。
                          DANA: DANA 钱包支付方式。
                          QRIS: QRIS 支付方式。
                          AKULAKU: Akulaku 支付方式。
                          Paypay: PayPay 支付方式。
                          LINE_Pay: LINE Pay 支付方式。
                          Merpay: Merpay 支付方式。
                          Rakuten_Pay: Rakuten Pay 支付方式。
                          BitCash: BitCash 支付方式。
                          Net_Cash: NetCash 支付方式。
                          WebMoney: WebMoney 支付方式。
                          au: au PAY 支付方式。
                          SoftBank: SoftBank 运营商支付方式。
                          NTT_Docomo: d払い（Docomo）运营商支付方式。
                          Paidy: Paidy 支付方式。
                          BLIK: BLIK 支付方式。
                          BLIK_SEAMLESS: BLIK Seamless 支付方式。
                          cardpay: MADA 支付方式。
                          stcpay: stc pay 支付方式。
                          tamara: Tamara 支付方式。
                          tabby: Tabby 支付方式。
                          MB_WAY: MB Way 支付方式。
                        x-onerway-value:
                          nullable: true
                          empty: true
                          when:
                            en: Has a value only for local payment method transactions; empty at checkout
                              session creation.
                            zh: 使用本地支付方式的交易才有值；会话创建时为空。
                      qrCode:
                        type:
                          - string
                          - "null"
                        description: 二维码值，承载编码的支付信息。
                        x-onerway-value:
                          nullable: true
                          empty: true
                          when:
                            en: Has a value only for QR-code-based payment methods; empty at checkout
                              session creation.
                            zh: 使用二维码的支付方式才有值；会话创建时为空。
                      subscriptionManageUrl:
                        type:
                          - string
                          - "null"
                        description: 订阅管理地址，买家可通过该地址查看和管理订阅。
                        x-onerway-value:
                          nullable: true
                          empty: true
                          when:
                            en: Has a value only in subscription scenarios.
                            zh: 订阅场景才有值。
                      subscriptionsManageUrl:
                        type:
                          - string
                          - "null"
                        description: 订阅列表管理地址，供买家集中管理其多个订阅。与
                          `subscriptionManageUrl`（单数）区分：单数为单个订阅管理页，复数为多订阅列表页。
                        x-onerway-value:
                          nullable: true
                          empty: true
                          when:
                            en: Returned when the buyer subscribes to multiple products at the same time.
                            zh: 买家同时订阅多个产品时返回。
                      linkName:
                        type:
                          - string
                          - "null"
                        description: 与当前收银台会话关联的支付链接展示名称。
                        x-onerway-value:
                          nullable: true
                          when:
                            en: The checkout session was not created from a named payment link.
                            zh: 收银台会话不是通过具名支付链接创建时返回 null。
                      itemName:
                        type:
                          - string
                          - "null"
                        description: 与支付链接收银台会话关联的商品或服务名称。
                        x-onerway-value:
                          nullable: true
                          when:
                            en: No payment-link item is associated with the checkout session.
                            zh: 当前收银台会话未关联支付链接商品时返回 null。
                    description: 收银台会话创建响应的业务数据对象。
              examples:
                one-time-card:
                  summary: 仅银行卡收银台会话已创建
                  value:
                    respCode: "20000"
                    respMsg: Success
                    data:
                      transactionId: "2076961389037359104"
                      merchantTxnId: card-4f71d2ae-4d0b-4fc2-8f2c-e450cf735baf
                      merchantNo: replace_with_merchant_no
                      responseTime: ""
                      txnTime: ""
                      orderAmount: "1.00"
                      orderCurrency: USD
                      txnAmount: ""
                      txnCurrency: null
                      txnTimeZone: null
                      status: U
                      paymentId: "2076961389016387584"
                      paymentStatus: U
                      reason: null
                      redirectUrl: https://sandbox-checkout.onerway.com/checkout?key=bb02fff76ddf4ea9b021e4cd738e13e3
                      sign: 3607ed6b158396e7a16574e2d62d5abb4b0157fa1e7321714438749488eb2f12
                      contractId: ""
                      tokenId: null
                      eci: null
                      transactionOrderNo: null
                      periodValue: null
                      lpmsType: null
                      qrCode: null
                      subscriptionManageUrl: null
                      tokenization: null
                      linkName: null
                      itemName: null
                one-time-all-methods:
                  summary: 聚合收银台会话已创建
                  value:
                    respCode: "20000"
                    respMsg: Success
                    data:
                      transactionId: "2076961398319353856"
                      merchantTxnId: all-711c89ac-304e-41b8-b92c-326270db9eaa
                      merchantNo: replace_with_merchant_no
                      responseTime: ""
                      txnTime: ""
                      orderAmount: "1.00"
                      orderCurrency: USD
                      txnAmount: ""
                      txnCurrency: null
                      txnTimeZone: null
                      status: U
                      paymentId: "2076961398294188032"
                      paymentStatus: U
                      reason: null
                      redirectUrl: https://sandbox-checkout.onerway.com/aggregate?key=83d94e672c1b4b3b89082f1079fb7bab
                      sign: 63cb5333a684d5a1d3e009df7451c3b1724fc316440a6d3ad7c8a3f0453d7787
                      contractId: ""
                      tokenId: null
                      eci: null
                      transactionOrderNo: null
                      periodValue: null
                      lpmsType: null
                      qrCode: null
                      subscriptionManageUrl: null
                      tokenization: null
                      linkName: null
                      itemName: null
                one-time-google-pay:
                  summary: 仅展示 Google Pay 的收银台会话已创建
                  value:
                    respCode: "20000"
                    respMsg: Success
                    data:
                      transactionId: "2076961406078816256"
                      merchantTxnId: googlepay-f914bb0e-f7f9-42ba-8268-18159b8f7ee9
                      merchantNo: replace_with_merchant_no
                      responseTime: ""
                      txnTime: ""
                      orderAmount: "100.00"
                      orderCurrency: USD
                      txnAmount: ""
                      txnCurrency: null
                      txnTimeZone: null
                      status: U
                      paymentId: "2076961406070427648"
                      paymentStatus: U
                      reason: null
                      redirectUrl: https://sandbox-checkout.onerway.com/aggregate?key=954b2e942818433d83c8d9e131051e2d&checkoutDetail=H4sIAAAAAAAAAK1W23LbNhD9lQ6fLYlkJJLyU2XJadVajsdS0qYdTwYkVxRiEGABULLG43%2FvArw7TvrSF41wsNz7nsWzQ4pinTqXjhf6YRS50TR4F0ZT1wvnvnPh5CCTA%2BH6VjiXkev67ryHkRzww0UMrCe5e%2BJWXyZExqAg59F%2B7k3j2IXRPtzPR1M%2FJqPID6KRF3mzeRztQ4D5UMGOWs2%2B6wcjNxx505%2B88NIPLl3vW7m%2FBEdZXjJ24WiEzoX5dLu4uXYssMhFybUJ0HXHrluBy1JK4MkZ4Y%2FbFWKqjO%2BkSMtE1wpW6%2Fvr5Q5vEiJTg635XjR2ThArqo3YQetCXU4mKeRijJ7IEzmPE5FP8MuYMkZ5tkhTCUqh8Ol0GmtQ2gjUmiutzw7lKTw16s3Fr0Qd2jOGy4FtaWZT2wldUd4%2F3pZ5DLJBjmSRJFXstcjx2PzNBdet%2BjOQ9qODYCnIurK%2FiQP%2FaSWg9vVKEj4wvzTa5bmBYsIfb8XgZPVUZ5p2d%2BpE93opUugLm3OV%2FCHWntF8cugjpIqvCrv%2FaX0x0IbFeOVvncEN0clhqyXRkA3u6oZooKI6Lo2c6LQokEeaWM9XoBJJC01FWxaqVNmVJEtyVWvtFVKeCy0ySfIGgYS2nUYYg9YFyI%2F38E%2BJLTRAVCG46oZAkuTRb72m%2FHc4b6FnEKE7cmaCpK%2BFJCVs2ER4c82thxjUVhNdm3lB0%2Fs9JJoeYUN5iW3tXL5z7XB9kNhCG5X1U49zYFpd5qTKzrOzp1LpfoMwMjwXh95kQ04ow5ZMSqUFMsDPvTkqhNKEDRqjGbk6w03dcdgdW8gj5Ynp8OXC9DbVXTW1hC7ffJALmgLXKDvMUEylPqzaxFw4X4v3r0P7Wty8FVzdj53nL5aIvmkiCSmVmOuPknV%2BEl0aTtlaRlSKZK1uJUqZwLIijR41Wlr23TCYB97UDVykey%2FwZ4FjLOhScqu%2FozSRqAGlkYIqSwWYO9bzBRuOK5IYj23puzlH9s8xZ8th%2FpMDJI%2Bi1BuMm2EMfz9X7FWRzi92b2CD9rj3jSsmMtHzISYKgukNgv0J7ngbbVAM3wtmuMUiz49Cz%2FVmgR9FneQrC8VgHywX96uLm7vNtrZ9RwyBtsmSgmO%2BUziKQqWUZOOYiRizJmF8Qm4XJzXmoCfiCBJ%2FC5B2Dka4SEYqjZ8mjQ8mgknqBThasRtHbhAkYRKmURBFwTSZkgD86XRc8OzH2cEuWta3JsHOYnP9J8KbxXZ3fW9CwcNqvV1%2B%2BHR9j38%2FrbcL5%2BHlodK5FRInYDb3L3BIgSHN8z3NSkn6PVnxae%2FivRE1xh56df%2FOPVVbYGCo1fns2GbOQA34oTKSJkmzvlugW931KqufA7a7sbjuPHBev1Fq9sUhxV7e9D%2B4Wt77q9tg9zlcbWa71UenFauzioXNUNq2LWVIK%2FwVq1TTW3U2PGlkAlIP88OP8vfdmDmclvWAfDNGb6TzP6pRb3Wkrqs3WHhPmILq%2Bo%2FmSVNjOOVrbniVGdMtbJZwHZAh8bh6Ejj1UKxzS0P%2F21SUuFxxPdu9tIO8YPh%2F4s1DN5zh89SNXHyqBuHMnxjjX%2FCa8i%2BJYEKOvxZmQt5gBXNbOXykcKofq1qWUAFLS25XukuORatSW7iSJaUW9zUtNxhwEjNoircTj1CLv1iC7Z4M9rBIzbOh3W%2FNMl1zDPdImH2Rz%2BfR%2FJ1pPQkY%2BQ9fxd813vGtBU397RS%2B%2FAsR3RC%2F%2BwsAAA%3D%3D
                      sign: 5ef84acb27f4fcdfcff73ba25fad6b921d1684b393da50bd7dfb1e4bbc294683
                      contractId: ""
                      tokenId: null
                      eci: null
                      transactionOrderNo: null
                      periodValue: null
                      lpmsType: null
                      qrCode: null
                      subscriptionManageUrl: null
                      tokenization: null
                      linkName: null
                      itemName: null
                one-time-apple-pay:
                  summary: 仅展示 Apple Pay 的收银台会话已创建
                  value:
                    respCode: "20000"
                    respMsg: Success
                    data:
                      transactionId: "2076961409027411968"
                      merchantTxnId: applepay-0ebc4e9d-c0a8-4ea4-b58d-0b58822de562
                      merchantNo: replace_with_merchant_no
                      responseTime: ""
                      txnTime: ""
                      orderAmount: "1.00"
                      orderCurrency: USD
                      txnAmount: ""
                      txnCurrency: null
                      txnTimeZone: null
                      status: U
                      paymentId: "2076961409010634752"
                      paymentStatus: U
                      reason: null
                      redirectUrl: https://sandbox-checkout.onerway.com/aggregate?key=f44bb646ec1d41b4a02cf340af5d0c99&checkoutDetail=H4sIAAAAAAAAAK1W32%2FjNgz%2BVw5%2BbhLHTWynT0vTHtatvSuaHoZtKA6yzCRqZcmT5KRB0f99lCz%2F6rW3l70EEUmTIvnxo14CUpZXeXAWTJMoSdMwncWnSToLp8kiCk6CAhTdEWG%2ByOAsDcMoXPRkpAD8cJkB71nePwvnD%2F1yKMlxFEJGZ7DIRzQk6WgGZDbK5mk%2BCvE3jaIc5nE0%2FP6eOcdRGMWjMBlNZ5%2BmyVkUn4Xv2P0lBdqKivOTwKDoWNpP18vry8AJloWshLH5jcOwFq0qpUDQIwq%2FrS9QpqvsVsm8osZ%2FfnF1d7m6Rw0lKreyK7GRTZQDZJoZa7YzptRnk0kOhRzjPdSBHMdUFhP8MmOcM7Fd5rkCrdH4cDiMDWhjDbzn2utLwEQOz417q%2FiV6F17xmQF8DXburp2RudM9I9fqiID1Uj2ZElpnbk32e%2Bbv4UUpnV%2FBNJ%2BtJM8B%2BXb%2BpvciU8XEvxdzxURg%2FAr610dG1FGxNMXOTg5P%2FWZ5Z1OH9jGrGQOfWN7ros%2FlLVnDE93fQmp86vT7n%2FqFQNv2Iw39%2FUVvCGG7tZGEQPbgc4DohGV9XFl7WTnRYPaM%2BpufgGaKlYaJtu2MK2rriVbWmjvtddIdSyN3CpSNBKgrEUa4RzaK0Cxv4N%2FKoTQQKJLKXQ3AorQp6i9NRO%2Fw3ENvYAouiVHLkn%2B1kgxwocgQs2lcDfEpNaGGB%2FmFUNvNkAN28MNExXCOjg7Dd1wfVUIoRu97Zce58BCXRWkrs5LsGFKmz5AOBmey11vrqEgjCMkaaWNxPn%2FpTdHpdSG8AEwmpHzFW76jsMeuEbumaAW4aulxTYzXTeNgq7eYlALloMwaDusUMaU2V20hTkJHsvPb1N7LK%2FfS87jsbv5qyOiH0CkIGcKa%2F1N8e6exFSWU9aOD7Um29a3lpWisKpJo0eMjpOjMIkX8XQWLsIomU2nizgNbARTKeH8d5QmqR5QGimZdlSAteO9uyDghCbU3ti1vptz5P4Ca7Ya1p%2FugD7Jytxg3hxz%2BPulZi%2B%2FS%2BzSQHz2qPdHDZdb2btBRjTEs2sU9ue3Y22MwDD5aZyms2geJlF4Gk%2Fj03k66yyHAcrBMri%2BvVmfrJZ3Fz70LbHs2VZKSYHFzmEvS50zsh1nXGZYMgXjAxK7POixADORe1D4W4JyQzDCLTLSefY8aa5gE5gkGaWQ0nyeUzILo3maZNk0XqR0kxJIEzJ%2BLGH70%2BIghFZeaasb5ExTGxtVe6aJBQyiEZQ1Ch5eH2pfa6kQ9%2FP09ARHEziSu9iwbaVIH4k1i%2FYUn62pjfLQ6%2FYHeqbXwMESavBn4CC8BT1ghTpITmmzsltBt7D9AvNPAIfp5jCuGzEuCT2WrhTDd4onYZxVhPRNz8NA4Qv6sVO6Yxz5Rbyhl3qMa4jDs0FKIH6qH35W0g%2FLIOCw8pPywzy9U%2BH%2FaJBf78hh5%2B%2FQ8YZwDbX6j%2BZt42U47lfCEiy3oVux3cY%2BIcvmWf02CPyAXBWOj%2F63Calwy%2BKedgvqHoqS4%2F%2FJdJGEyRwfqWEa4oM1TubRxAb%2FjmomvlPJpcJpscPyDkFYbX3hPYODf7IaVUEtWDmWOzddcZy0brUT17akMvLO83MjA0EyDk3z7uUTePNXx7Td28Edlrl9P7SLrtmqVwLT3RPu3uWLRRJNLfQUYOY%2FfRx%2FGLwjXie0%2FXeD%2Bfov84r8zgEMAAA%3D
                      sign: 7827ec370f90f8e572fc8bba98094c544cf79018b5bc5c5ebb6441b67fccdf0e
                      contractId: ""
                      tokenId: null
                      eci: null
                      transactionOrderNo: null
                      periodValue: null
                      lpmsType: null
                      qrCode: null
                      subscriptionManageUrl: null
                      tokenization: null
                      linkName: null
                      itemName: null
                subscription:
                  summary: Onerway 托管扣款的月度银行卡订阅已创建
                  value:
                    respCode: "20000"
                    respMsg: Success
                    data:
                      transactionId: "2076964432134934528"
                      merchantTxnId: managed-monthly-6db3a7cb-eb2d-48e0-8c60-c8501945c5df
                      merchantNo: replace_with_merchant_no
                      responseTime: ""
                      txnTime: ""
                      orderAmount: "20.00"
                      orderCurrency: USD
                      txnAmount: ""
                      txnCurrency: null
                      txnTimeZone: null
                      status: U
                      paymentId: "2076964432118157312"
                      paymentStatus: U
                      reason: null
                      redirectUrl: https://sandbox-checkout.onerway.com/checkout?key=db80f63868ea4c77bf849ff68f41f507
                      sign: 2ad480ce322aac1388885c1dd304e574b063449ac31d2ba00b3ad85c7259faaf
                      contractId: ""
                      tokenId: null
                      eci: null
                      transactionOrderNo: null
                      periodValue: null
                      lpmsType: null
                      qrCode: null
                      subscriptionManageUrl: https://sandbox-myscribe.onerway.com/pages/subscription-list/details?subKey=1BnKnUKVXhc1PWa
                      tokenization: null
                      linkName: null
                      itemName: null
                all-methods-monthly-subscription:
                  summary: Onerway 托管扣款的月度聚合收银台订阅已创建
                  value:
                    respCode: "20000"
                    respMsg: Success
                    data:
                      transactionId: "2076964836763635712"
                      merchantTxnId: all-managed-monthly-35ec60d7-5b40-425b-a18b-bcdf5fff7f65
                      merchantNo: replace_with_merchant_no
                      responseTime: ""
                      txnTime: ""
                      orderAmount: "20.00"
                      orderCurrency: USD
                      txnAmount: ""
                      txnCurrency: null
                      txnTimeZone: null
                      status: U
                      paymentId: "2076964836751052800"
                      paymentStatus: U
                      reason: null
                      redirectUrl: https://sandbox-checkout.onerway.com/aggregate?key=95d018b40db04a8f91ee148d77cf0b79
                      sign: ba0ac1e3eb1bad688eb167995b02c86b311c3398a46d84fb6abf7496a542317f
                      contractId: ""
                      tokenId: null
                      eci: null
                      transactionOrderNo: null
                      periodValue: null
                      lpmsType: null
                      qrCode: null
                      subscriptionManageUrl: https://sandbox-myscribe.onerway.com/pages/subscription-list/details?subKey=1BnKnUKVepFb0s4
                      tokenization: null
                      linkName: null
                      itemName: null
                apple-pay-daily-subscription:
                  summary: 商户自行扣款的每日 Apple Pay 订阅已创建
                  value:
                    respCode: "20000"
                    respMsg: Success
                    data:
                      transactionId: "2076965246048014336"
                      merchantTxnId: self-managed-daily-2a4f2b18-d342-4fd9-98f7-819b4a292de4
                      merchantNo: replace_with_merchant_no
                      responseTime: ""
                      txnTime: ""
                      orderAmount: "20.00"
                      orderCurrency: USD
                      txnAmount: ""
                      txnCurrency: null
                      txnTimeZone: null
                      status: U
                      paymentId: "2076965246022848512"
                      paymentStatus: U
                      reason: null
                      redirectUrl: https://sandbox-checkout.onerway.com/aggregate?key=4c376d59099b4b02bbe8e1acc6a257f7
                      sign: 7b3d9ffdbc551c9430d14a37a48fa12d15bd7be2ca60ac9318bd3c046bb5317c
                      contractId: ""
                      tokenId: null
                      eci: null
                      transactionOrderNo: null
                      periodValue: null
                      lpmsType: null
                      qrCode: null
                      subscriptionManageUrl: null
                      tokenization: null
                      linkName: null
                      itemName: null
                pre-authorization:
                  summary: 银行卡支付预授权已创建
                  value:
                    respCode: "20000"
                    respMsg: Success
                    data:
                      transactionId: "2076966571951394816"
                      merchantTxnId: 62243ffa-b8e6-4d78-8684-b538f5dbb379
                      merchantNo: replace_with_merchant_no
                      responseTime: ""
                      txnTime: ""
                      orderAmount: "1.00"
                      orderCurrency: USD
                      txnAmount: ""
                      txnCurrency: null
                      txnTimeZone: null
                      status: U
                      paymentId: "2076966571943006208"
                      paymentStatus: U
                      reason: null
                      redirectUrl: https://sandbox-checkout.onerway.com/aggregate?key=6523c581d82b498ebc80be8bf1269dee
                      sign: dfb51272c66a3edd0bb6afe1470e39d746239d11bf7ed441adf9a3be8535a215
                      contractId: ""
                      tokenId: null
                      eci: null
                      transactionOrderNo: null
                      periodValue: null
                      lpmsType: null
                      qrCode: null
                      subscriptionManageUrl: null
                      tokenization: null
                      linkName: null
                      itemName: null
                marketplace-retailers:
                  summary: marketplace 收银台会话已创建
                  value:
                    respCode: "20000"
                    respMsg: Success
                    data:
                      transactionId: "2076966571951394817"
                      merchantTxnId: mkt-8f1c2d4e-6b70-4a19-9c53-1e7a0d5b2f38
                      merchantNo: replace_with_merchant_no
                      responseTime: ""
                      txnTime: ""
                      orderAmount: "150.00"
                      orderCurrency: USD
                      txnAmount: ""
                      txnCurrency: null
                      txnTimeZone: null
                      status: U
                      paymentId: "2076966571943006209"
                      paymentStatus: U
                      reason: null
                      redirectUrl: https://sandbox-checkout.onerway.com/aggregate?key=8f1c2d4e6b704a199c531e7a0d5b2f38
                      sign: replace_with_calculated_signature
                      contractId: ""
                      tokenId: null
                      eci: null
                      transactionOrderNo: null
                      periodValue: null
                      lpmsType: null
                      qrCode: null
                      subscriptionManageUrl: null
                      tokenization: null
                      linkName: null
                      itemName: null
```
