openapi: 3.0.1
info:
  title: PayKKa-collection-openplatform
  description: ''
  version: 1.0.0
tags:
  - name: 汇入汇款
  - name: 收款人
  - name: 付款
  - name: 换汇
  - name: 文件服务
  - name: 订单
  - name: 解付入账
  - name: 账户余额
  - name: 商户入网
  - name: 收款账户
paths:
  /api/v2/remittance/notify:
    post:
      summary: 汇入汇款(通知)
      deprecated: false
      description: type=INCOMING_REMITTANCE
      operationId: notification_1
      tags:
        - 汇入汇款
      parameters:
        - name: X-Merch-Id
          in: header
          description: ''
          example: M24061911365700670
          schema:
            type: string
            default: M24061911365700670
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                type:
                  type: string
                  description: >-
                    业务类型: MERCH-商户, VA-虚拟账户, INCOMING_REMITTANCE-汇入汇款,
                    CONTRACT_ORDER-合同订单, TRADE_SETTLE-解付入账, PAYEE-收款人,
                    WD_ACCOUNT-提现账户, CUR_EXCHANGE-换汇, PAYMENT-付款
                  enum:
                    - MERCH
                    - VA
                    - INCOMING_REMITTANCE
                    - CONTRACT_ORDER
                    - TRADE_SETTLE
                    - PAYEE
                    - WD_ACCOUNT
                    - FOREX
                    - PAYMENT
                version:
                  type: string
                  description: 版本号(V1、V2、...)
                data:
                  type: object
                  properties:
                    merch_id:
                      type: string
                      description: 收款商户id
                      minLength: 1
                      maxLength: 20
                    order_no:
                      type: string
                      description: paykka收款单号
                      minLength: 1
                      maxLength: 32
                    amount:
                      type: integer
                      description: 汇入汇款金额(币种最小单位)
                      format: int64
                    currency:
                      type: string
                      description: >-
                        币种: EUR-欧元, USD-美元, CNY-人民币, GBP-英镑, JPY-日元, AUD-澳元,
                        CAD-加元, SGD-新加坡元, HKD-港币, PHP-菲律宾比索, CNH-离岸人民币
                      enum:
                        - EUR
                        - USD
                        - CNY
                        - GBP
                        - JPY
                        - AUD
                        - CAD
                        - SGD
                        - HKD
                        - PHP
                        - CNH
                    payer:
                      type: string
                      description: 付款人
                    payment_account:
                      type: string
                      description: 付款账号
                    payer_bank_bic:
                      type: string
                      description: 付款银行BIC
                    payer_bank_name:
                      type: string
                      description: 付款人银行名称
                    payee:
                      type: string
                      description: 收款人
                    recv_account:
                      type: string
                      description: 收款账号
                    recv_time:
                      type: string
                      description: 收款时间
                      format: date-time
                    remark:
                      type: string
                      description: 附言
                  description: 业务数据
                  required:
                    - merch_id
                    - order_no
                    - amount
                    - currency
                    - recv_account
                    - recv_time
              required:
                - type
                - version
                - data
            example: ''
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties: {}
          headers: {}
        '400':
          description: Bad Request
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '401':
          description: Unauthorized
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '404':
          description: Not Found
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '429':
          description: Too Many Requests
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '500':
          description: Internal Server Error
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
      security: []
  /api/v2/merch/beneficiary/create:
    post:
      summary: 收款人创建
      deprecated: false
      description: 收款人创建
      operationId: create
      tags:
        - 收款人
      parameters:
        - name: X-Merch-Id
          in: header
          description: ''
          example: M24061911365700670
          schema:
            type: string
            default: M24061911365700670
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                request_id:
                  maxLength: 32
                  minLength: 1
                  type: string
                  description: 请求号，请求方系统内唯一
                type:
                  type: string
                  description: '目的(必填): PAYMENT-收款、WITHDRAWAL-提现'
                beneficiary:
                  type: object
                  properties:
                    purpose:
                      type: string
                      description: >-
                        收款类型 PFG-货款 LWF-物流仓储费 ASF-广告服务费 TSF-技术服务费 CSF-咨询服务费
                        OTHER-其他 数据字典:PAYEE_TYPE
                      enum:
                        - PFG
                        - LWF
                        - ASF
                        - TSF
                        - CSF
                        - OTHER
                    purpose_desc:
                      maxLength: 100
                      minLength: 0
                      type: string
                      description: 收款类型说明,其他收款类型的时候需要填(最长100字符)，purpose为OTHER时必填
                    country:
                      type: string
                      description: 国家代码,使用ISO3166-2标准2位国家代码,非制裁国家(见附录)
                    industry:
                      type: integer
                      description: 主营行业(见附件)，对公账户且为收款人时必填
                      format: int32
                    nick_name:
                      maxLength: 100
                      minLength: 0
                      type: string
                      description: 账户昵称(最长100字符)
                    first_name:
                      maxLength: 100
                      minLength: 1
                      type: string
                      description: 受益人first name(境外收款人对私必填)(最长100字符)
                    last_name:
                      maxLength: 100
                      minLength: 1
                      type: string
                      description: 受益人last name(境外收款人对私必填)(最长100字符)
                    doc_type:
                      type: string
                      description: 证件类型(境内个人账户必填), 境内个人账户必填且为ID_CARD
                    id_number:
                      maxLength: 100
                      minLength: 0
                      type: string
                      description: 证件号码(境内个人账户必填)(最长100字符)
                    uni_social_credit:
                      maxLength: 18
                      minLength: 0
                      type: string
                      description: 统一社会信用代码(境内对公账户必填)(最长18字符)
                    address:
                      type: object
                      properties:
                        province:
                          type: string
                          description: 州/省(美国/加拿大/墨西哥且银行币种账户非CNY必填)
                        city:
                          maxLength: 50
                          minLength: 0
                          type: string
                          description: 城市(境外必填)
                        zipcode:
                          maxLength: 20
                          minLength: 0
                          type: string
                          description: 邮编(境外必填)
                        address1:
                          maxLength: 50
                          minLength: 0
                          type: string
                          description: 银行账户持有人地址(境外必填)
                        address2:
                          type: string
                          description: 地址行2
                      description: 受益人地址信息
                      required:
                        - province
                        - city
                        - zipcode
                        - address1
                  description: 收款人信息
                  required:
                    - purpose
                    - country
                bank_acc:
                  description: 银行账户信息
                  type: object
                  properties:
                    country:
                      type: string
                      description: 国家代码,使用ISO3166-2标准2位国家代码,非制裁国家(见附录)
                      maxLength: 2
                      minLength: 0
                      examples:
                        - string
                    currency:
                      type: string
                      description: >-
                        币种: EUR-欧元, USD-美元, CNY-人民币, GBP-英镑, JPY-日元, AUD-澳元,
                        CAD-加元, SGD-新加坡元, HKD-港币, PHP-菲律宾比索, CNH-离岸人民币
                      enum:
                        - EUR
                        - USD
                        - CNY
                        - GBP
                        - JPY
                        - AUD
                        - CAD
                        - SGD
                        - HKD
                        - PHP
                        - CNH
                    acc_name:
                      maxLength: 100
                      minLength: 1
                      type: string
                      description: 账户名称(最长100字符)
                    acc_type:
                      type: string
                      description: '账户类型: PRIVATE-个人账户, COMPANY-企业对公'
                      enum:
                        - PRIVATE
                        - COMPANY
                    acc_no:
                      maxLength: 100
                      minLength: 0
                      type: string
                      description: 银行账号，acc_no和iban二选一
                    payment_type:
                      type: string
                      description: 支付清算网络：LOCAL-本地支付，SWIFT-国际支付
                      enum:
                        - LOCAL
                        - SWIFT
                    routing_code_type1:
                      type: string
                      description: >-
                        LOCAL清算网络时必须(随业务发展后会扩展枚举值）：ABA、SORT_CODE、BANK_CODE(境内详见银行编码附件，境外如加拿大如实填写)
                    routing_code_value1:
                      type: string
                      description: routing_code_type1不为空时必须
                    routing_code_type2:
                      type: string
                      description: >-
                        LOCAL清算网络子类型(随业务发展后会扩展枚举值）：BRANCH_BANK_CODE(境内详见银行编码附件，境外如加拿大如实填写)
                    routing_code_value2:
                      type: string
                      description: routing_code_type2不为空时必须
                    iban:
                      maxLength: 50
                      minLength: 0
                      type: string
                      description: IBAN，欧元区账户特有，acc_no和iban二选一
                    bic_swift:
                      type: string
                      description: swift code或bic，SWIFT清算网络时其它国家与地区均需要上传该字段(只支持8位或11位)
                      maxLength: 11
                      minLength: 8
                      examples:
                        - string
                    bank_acc_type:
                      type: string
                      description: 银行账户类型 CHECKING-支票 SAVINGS-储蓄卡
                      enum:
                        - CHECKING
                        - SAVINGS
                    bank_addr:
                      maxLength: 100
                      minLength: 0
                      type: string
                      description: 开户银行详细地址(境外账户必填)(最长100字符)
                    bank_name:
                      maxLength: 100
                      minLength: 0
                      type: string
                      description: 开户银行名称(境外账户必填; 最长100字符)
                    branch_bank_name:
                      maxLength: 100
                      minLength: 0
                      type: string
                      description: 开户银行支行名称(最长100字符)
                    phone:
                      type: string
                      description: 银行预留手机号(大陆人民币对私提现)
                      maxLength: 11
                      minLength: 11
                      examples:
                        - string
                    province:
                      maxLength: 10
                      minLength: 0
                      type: string
                      description: 开户银行所属省份(境内企业对公账户必填, 见附件)
                    city:
                      maxLength: 10
                      minLength: 0
                      type: string
                      description: 开户银行所属城市(境内企业对公账户必填, 见附件)
                    district:
                      maxLength: 10
                      minLength: 0
                      type: string
                      description: 开户银行所属区(境内企业对公账户必填, 见附件)
                  required:
                    - country
                    - currency
                    - acc_name
                    - acc_type
                    - payment_type
                attachment:
                  description: 其他文件附件
                  type: object
                  properties:
                    other_file_ids:
                      maxItems: 7
                      minItems: 0
                      type: array
                      description: 附件文件id 最多7个
                      items:
                        type: integer
                        description: 附件文件id 最多7个
                        format: int32
                    contract_file_id:
                      type: integer
                      description: 合同文件-上传文件接口返回的id(目的为收款时, 合同/PI/物流文件必传其一)
                      format: int32
                    logistics_file_id:
                      type: integer
                      description: 物流文件-上传文件接口返回的id(目的为收款时, 合同/PI/物流文件必传其一)
                      format: int32
                    pi_file_id:
                      type: integer
                      description: PI文件-上传文件接口返回的id(目的为收款时, 合同/PI/物流文件必传其一)
                      format: int32
              required:
                - request_id
                - type
                - beneficiary
                - bank_acc
            example: ''
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/PayeeRes'
          headers: {}
        '400':
          description: Bad Request
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '401':
          description: Unauthorized
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '404':
          description: Not Found
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '429':
          description: Too Many Requests
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '500':
          description: Internal Server Error
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
      security: []
  /api/v2/merch/beneficiary/update:
    post:
      summary: 修改收款人(用于被驳回时修改收款人信息)
      deprecated: false
      description: 收款人修改
      operationId: update
      tags:
        - 收款人
      parameters:
        - name: X-Merch-Id
          in: header
          description: ''
          example: M24061911365700670
          schema:
            type: string
            default: M24061911365700670
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                request_id:
                  maxLength: 32
                  minLength: 1
                  type: string
                  description: 请求号，请求方系统内唯一
                type:
                  type: string
                  description: '目的(必填): PAYMENT-收款、WITHDRAWAL-提现'
                beneficiary:
                  description: 收款人信息
                  type: object
                  properties:
                    purpose:
                      type: string
                      description: >-
                        收款类型 PFG-货款 LWF-物流仓储费 ASF-广告服务费 TSF-技术服务费 CSF-咨询服务费
                        OTHER-其他 数据字典:PAYEE_TYPE
                      enum:
                        - PFG
                        - LWF
                        - ASF
                        - TSF
                        - CSF
                        - OTHER
                    purpose_desc:
                      maxLength: 100
                      minLength: 0
                      type: string
                      description: 收款类型说明,其他收款类型的时候需要填(最长100字符)，purpose为OTHER时必填
                    country:
                      type: string
                      description: 国家代码,使用ISO3166-2标准2位国家代码,非制裁国家(见附录)
                    industry:
                      type: integer
                      description: 主营行业(见附件)，对公账户且为收款人时必填
                      format: int32
                    nick_name:
                      maxLength: 100
                      minLength: 0
                      type: string
                      description: 账户昵称(最长100字符)
                    first_name:
                      maxLength: 100
                      minLength: 1
                      type: string
                      description: 受益人first name(境外收款人对私必填)(最长100字符)
                    last_name:
                      maxLength: 100
                      minLength: 1
                      type: string
                      description: 受益人last name(境外收款人对私必填)(最长100字符)
                    doc_type:
                      type: string
                      description: 证件类型(境内个人账户必填), 境内个人账户必填且为ID_CARD
                    id_number:
                      maxLength: 100
                      minLength: 0
                      type: string
                      description: 证件号码(境内个人账户必填)(最长100字符)
                    uni_social_credit:
                      maxLength: 18
                      minLength: 0
                      type: string
                      description: 统一社会信用代码(境内对公账户必填)(最长18字符)
                    address:
                      type: object
                      properties:
                        province:
                          type: string
                          description: 州/省(美国/加拿大/墨西哥且银行币种账户非CNY必填)
                        city:
                          maxLength: 50
                          minLength: 0
                          type: string
                          description: 城市(境外必填)
                        zipcode:
                          maxLength: 20
                          minLength: 0
                          type: string
                          description: 邮编(境外必填)
                        address1:
                          maxLength: 50
                          minLength: 0
                          type: string
                          description: 银行账户持有人地址(境外必填)
                        address2:
                          type: string
                          description: 地址行2
                      required:
                        - province
                        - city
                        - address1
                        - zipcode
                      description: 受益人地址信息
                  required:
                    - purpose
                    - country
                bank_acc:
                  description: 银行账户信息
                  type: object
                  properties:
                    country:
                      maxLength: 2
                      minLength: 0
                      type: string
                      description: 国家代码,使用ISO3166-2标准2位国家代码,非制裁国家(见附录)
                    currency:
                      type: string
                      description: >-
                        币种: EUR-欧元, USD-美元, CNY-人民币, GBP-英镑, JPY-日元, AUD-澳元,
                        CAD-加元, SGD-新加坡元, HKD-港币, PHP-菲律宾比索, CNH-离岸人民币
                      enum:
                        - EUR
                        - USD
                        - CNY
                        - GBP
                        - JPY
                        - AUD
                        - CAD
                        - SGD
                        - HKD
                        - PHP
                        - CNH
                    acc_name:
                      maxLength: 100
                      minLength: 1
                      type: string
                      description: 账户名称(最长100字符)
                    acc_type:
                      type: string
                      description: '账户类型: PRIVATE-个人账户, COMPANY-企业对公'
                      enum:
                        - PRIVATE
                        - COMPANY
                    acc_no:
                      maxLength: 100
                      minLength: 0
                      type: string
                      description: 银行账号，acc_no和iban二选一
                    payment_type:
                      type: string
                      description: 支付清算网络：LOCAL-本地支付，SWIFT-国际支付
                      enum:
                        - LOCAL
                        - SWIFT
                    routing_code_type1:
                      type: string
                      description: >-
                        LOCAL清算网络时必须(随业务发展后会扩展枚举值）：ABA、SORT_CODE、BANK_CODE(境内详见银行编码附件，境外如加拿大如实填写)
                    routing_code_value1:
                      type: string
                      description: routing_code_type1不为空时必须
                    routing_code_type2:
                      type: string
                      description: >-
                        LOCAL清算网络子类型(随业务发展后会扩展枚举值）：BRANCH_BANK_CODE(境内详见银行编码附件，境外如加拿大如实填写)
                    routing_code_value2:
                      type: string
                      description: routing_code_type2不为空时必须
                    iban:
                      maxLength: 50
                      minLength: 0
                      type: string
                      description: IBAN，欧元区账户特有，acc_no和iban二选一
                    bic_swift:
                      type: string
                      description: swift code或bic，SWIFT清算网络时其它国家与地区均需要上传该字段(只支持8位或11位)
                      maxLength: 11
                      minLength: 8
                      examples:
                        - string
                    bank_acc_type:
                      type: string
                      description: 银行账户类型 CHECKING-支票 SAVINGS-储蓄卡
                      enum:
                        - CHECKING
                        - SAVINGS
                    bank_addr:
                      maxLength: 100
                      minLength: 0
                      type: string
                      description: 开户银行详细地址(境外账户必填)(最长100字符)
                    bank_name:
                      maxLength: 100
                      minLength: 0
                      type: string
                      description: 开户银行名称(境外账户必填; 最长100字符)
                    branch_bank_name:
                      maxLength: 100
                      minLength: 0
                      type: string
                      description: 开户银行支行名称(最长100字符)
                    phone:
                      type: string
                      description: 银行预留手机号(大陆人民币对私提现)
                      maxLength: 11
                      minLength: 11
                      examples:
                        - string
                    province:
                      maxLength: 10
                      minLength: 0
                      type: string
                      description: 开户银行所属省份(境内企业对公账户必填, 见附件)
                    city:
                      maxLength: 10
                      minLength: 0
                      type: string
                      description: 开户银行所属城市(境内企业对公账户必填, 见附件)
                    district:
                      maxLength: 10
                      minLength: 0
                      type: string
                      description: 开户银行所属区(境内企业对公账户必填, 见附件)
                  required:
                    - country
                    - currency
                    - acc_name
                    - acc_type
                    - payment_type
                attachment:
                  description: 其他文件附件
                  type: object
                  properties:
                    other_file_ids:
                      maxItems: 7
                      minItems: 0
                      type: array
                      description: 附件文件id 最多7个
                      items:
                        type: integer
                        description: 附件文件id 最多7个
                        format: int32
                    contract_file_id:
                      type: integer
                      description: 合同文件-上传文件接口返回的id(目的为收款时, 合同/PI/物流文件必传其一)
                      format: int32
                    logistics_file_id:
                      type: integer
                      description: 物流文件-上传文件接口返回的id(目的为收款时,合同/PI/物流文件必传其一)
                      format: int32
                    pi_file_id:
                      type: integer
                      description: PI文件id-上传文件接口返回的id(目的为收款时,合同/PI/物流文件必传其一)
                      format: int32
              required:
                - request_id
                - type
                - beneficiary
                - bank_acc
            example: ''
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/PayeeRes'
          headers: {}
        '400':
          description: Bad Request
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '401':
          description: Unauthorized
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '404':
          description: Not Found
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '429':
          description: Too Many Requests
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '500':
          description: Internal Server Error
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
      security: []
  /api/v2/merch/beneficiary/inquiry:
    post:
      summary: 收款人创建结果查询
      deprecated: false
      description: 查询收款人状态
      operationId: inquiry_1
      tags:
        - 收款人
      parameters:
        - name: X-Merch-Id
          in: header
          description: ''
          example: M24061911365700670
          schema:
            type: string
            default: M24061911365700670
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PayeeInquiryV2Req'
            example: ''
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/PayeeRes'
          headers: {}
        '400':
          description: Bad Request
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '401':
          description: Unauthorized
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '404':
          description: Not Found
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '429':
          description: Too Many Requests
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '500':
          description: Internal Server Error
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
      security: []
  /api/v2/merch/beneficiary/notify:
    post:
      summary: 收款人创建结果(通知)
      deprecated: false
      description: 收款人创建结果(通知)
      operationId: notification_1
      tags:
        - 收款人
      parameters:
        - name: X-Merch-Id
          in: header
          description: ''
          example: M24061911365700670
          schema:
            type: string
            default: M24061911365700670
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                type:
                  type: string
                  description: >-
                    业务类型: MERCH-商户, VA-虚拟账户, INCOMING_REMITTANCE-汇入汇款,
                    CONTRACT_ORDER-合同订单, TRADE_SETTLE-解付入账, PAYEE-收款人,
                    WD_ACCOUNT-提现账户, CUR_EXCHANGE-换汇, PAYMENT-付款
                  enum:
                    - MERCH
                    - VA
                    - INCOMING_REMITTANCE
                    - CONTRACT_ORDER
                    - TRADE_SETTLE
                    - PAYEE
                    - WD_ACCOUNT
                    - FOREX
                    - PAYMENT
                version:
                  type: string
                  description: 版本号(V1、V2、...)
                data:
                  type: object
                  properties:
                    request_id:
                      maxLength: 32
                      minLength: 1
                      type: string
                      description: 请求号，请求方系统内唯一
                    merch_id:
                      type: string
                      description: 商户id
                      minLength: 1
                      maxLength: 20
                    type:
                      type: string
                      description: '目的(必填): PAYMENT-收款、WITHDRAWAL-提现'
                    payee_id:
                      type: string
                      description: 收款人id
                      minLength: 1
                      maxLength: 20
                    status:
                      type: string
                      description: 付款人审核状态 PENDING-待审核 NORMAL-正常 REJECTED-审核未通过
                      enum:
                        - PENDING
                        - NORMAL
                        - REJECTED
                    msg:
                      type: string
                      description: 结果说明，失败时不为空
                  description: 业务数据
                  required:
                    - request_id
                    - merch_id
                    - type
                    - payee_id
                    - status
              required:
                - type
                - version
                - data
            example: ''
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties: {}
          headers: {}
        '400':
          description: Bad Request
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '401':
          description: Unauthorized
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '404':
          description: Not Found
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '429':
          description: Too Many Requests
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '500':
          description: Internal Server Error
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
      security: []
  /api/v2/fx/conversion/preorder:
    post:
      summary: 换汇预下单(询价)
      operationId: preorder
      deprecated: false
      description: 卖出和买入金额只允许填一个
      tags:
        - 换汇
      parameters:
        - name: X-Merch-Id
          in: header
          description: ''
          example: M24061911365700670
          schema:
            type: string
            default: M24061911365700670
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                sell_currency:
                  type: string
                  description: >-
                    卖出币种: EUR-欧元, USD-美元, CNY-人民币, GBP-英镑, JPY-日元, AUD-澳元,
                    CAD-加元, SGD-新加坡元, HKD-港币, PHP-菲律宾比索, CNH-离岸人民币
                  enum:
                    - EUR
                    - USD
                    - CNY
                    - GBP
                    - JPY
                    - AUD
                    - CAD
                    - SGD
                    - HKD
                    - PHP
                    - CNH
                buy_currency:
                  type: string
                  description: >-
                    买入币种: EUR-欧元, USD-美元, CNY-人民币, GBP-英镑, JPY-日元, AUD-澳元,
                    CAD-加元, SGD-新加坡元, HKD-港币, PHP-菲律宾比索, CNH-离岸人民币
                  enum:
                    - EUR
                    - USD
                    - CNY
                    - GBP
                    - JPY
                    - AUD
                    - CAD
                    - SGD
                    - HKD
                    - PHP
                    - CNH
                sell_amount:
                  type: integer
                  description: 卖出金额(币种最小单位)，sell_amount和buy_amount必传其中一个
                buy_amount:
                  type: integer
                  description: 买入金额(币种最小单位)，sell_amount和buy_amount必传其中一个
              required:
                - sell_currency
                - buy_currency
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  order_no:
                    type: string
                    description: 换汇订单号
                  sell_currency:
                    type: string
                    description: 卖出币种
                  buy_currency:
                    type: string
                    description: 买入币种
                  sell_amount:
                    type: integer
                    description: 卖出金额(币种最小单位)
                  buy_amount:
                    type: integer
                    description: 买入金额(币种最小单位)
                  fx_rate:
                    type: number
                    description: 汇率(1单位卖出货币兑换多少单位买入货币)
                  expires_at:
                    type: string
                    description: '过期于(format: yyyy-MM-dd''T''HH:mm:ssXXX)'
                    examples:
                      - '2024-12-03T23:33:33Z'
                    format: date-time
                required:
                  - order_no
                  - expires_at
                  - fx_rate
                  - sell_currency
                  - buy_currency
                  - sell_amount
                  - buy_amount
          headers: {}
      security: []
  /api/v2/fx/conversion/confirm:
    post:
      summary: 换汇确认
      operationId: confirm
      deprecated: false
      description: ''
      tags:
        - 换汇
      parameters:
        - name: X-Merch-Id
          in: header
          description: ''
          example: M24061911365700670
          schema:
            type: string
            default: M24061911365700670
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                order_no:
                  type: string
                  description: 订单号(预下单返回)
                request_id:
                  type: string
                  description: 请求号，请求方系统内唯一
                  minLength: 1
                  maxLength: 32
              required:
                - order_no
                - request_id
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                title: ''
                type: object
                properties:
                  status:
                    type: string
                    enum:
                      - PROCESSING
                      - SUCCEEDED
                      - FAILED
                required:
                  - status
          headers: {}
      security: []
  /api/v2/fx/conversion/inquiry:
    post:
      summary: 查询换汇结果
      operationId: inquiry
      deprecated: false
      description: ''
      tags:
        - 换汇
      parameters:
        - name: X-Merch-Id
          in: header
          description: ''
          example: M24061911365700670
          schema:
            type: string
            default: M24061911365700670
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                order_no:
                  type: string
                  description: 订单号
              required:
                - order_no
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                      - PROCESSING
                      - SUCCEEDED
                      - FAILED
                  fail_reason:
                    type: string
                    description: 原因(失败时有值)
                    maxLength: 255
                required:
                  - status
          headers: {}
      security: []
  /api/v2/fx/conversion/notify:
    post:
      summary: 换汇结果通知
      operationId: notify
      deprecated: false
      description: ''
      tags:
        - 换汇
      parameters:
        - name: X-Merch-Id
          in: header
          description: ''
          example: M24061911365700670
          schema:
            type: string
            default: M24061911365700670
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                type:
                  type: string
                  description: >-
                    业务类型: MERCH-商户, VA-虚拟账户, INCOMING_REMITTANCE-汇入汇款,
                    CONTRACT_ORDER-合同订单, TRADE_SETTLE-解付入账, PAYEE-收款人,
                    WD_ACCOUNT-提现账户, FOREX-换汇, PAYMENT-付款
                  enum:
                    - MERCH
                    - VA
                    - INCOMING_REMITTANCE
                    - CONTRACT_ORDER
                    - TRADE_SETTLE
                    - PAYEE
                    - WD_ACCOUNT
                    - FOREX
                    - PAYMENT
                version:
                  type: string
                  description: 版本号(V1、V2、...)
                data:
                  type: object
                  properties:
                    merch_id:
                      type: string
                    status:
                      type: string
                      enum:
                        - SUCCEEDED
                        - FAILED
                    fail_reason:
                      type: string
                      maxLength: 255
                    order_no:
                      type: string
                  required:
                    - merch_id
                    - status
                    - fail_reason
                    - order_no
              required:
                - type
                - data
                - version
            example:
              type: MERCH
              data:
                request_id: '123'
                merch_id: example
                status: ENABLED
                fail_reason: example
                order_no: LOCAL
      responses:
        '200':
          description: ''
          content:
            '*/*':
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                      - PROCESSING
                      - SUCCEEDED
                      - FAILED
                  fail_reason:
                    type: string
                    description: 原因(失败时有值)
                    maxLength: 255
                required:
                  - status
          headers: {}
      security: []
  /api/v2/merch/pay/notify:
    post:
      summary: 付款结果通知
      deprecated: false
      description: 付款结果通知
      operationId: notify
      tags:
        - 付款
      parameters:
        - name: X-Merch-Id
          in: header
          description: ''
          example: M24061911365700670
          schema:
            type: string
            default: M24061911365700670
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                type:
                  type: string
                version:
                  type: string
                  description: 版本号(V1、V2、...)
                data:
                  type: object
                  properties:
                    request_id:
                      type: string
                    status:
                      type: string
                      enum:
                        - PROCESSING
                        - SUCCEEDED
                        - FAILED
                        - RETURNED
                      description: 状态
                    fee_amount:
                      type: integer
                      description: 手续费(币种为付款货币，该币种最小单位)
                    beneficiary_type:
                      type: string
                      enum:
                        - PAY
                        - WITHDRAW
                      description: 收款人类型
                  required:
                    - request_id
                    - status
                    - fee_amount
                    - beneficiary_type
              required:
                - type
                - data
                - version
            example:
              type: MERCH
              data:
                request_id: '123'
                status: ENABLED
                fee_amount: 123
                beneficiary_type: sss
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                      - PROCESSING
                      - SUCCEEDED
                      - FAILED
                    description: 状态
                  fee_amount:
                    type: integer
                    description: 手续费(币种为付款货币)
                    format: int64
                  beneficiary_type:
                    type: string
                    description: 收款人类型
                    enum:
                      - PAY
                      - WITHDRAW
                required:
                  - fee_amount
                  - beneficiary_type
                  - status
          headers: {}
        '400':
          description: Bad Request
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '401':
          description: Unauthorized
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '404':
          description: Not Found
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '429':
          description: Too Many Requests
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '500':
          description: Internal Server Error
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
      security: []
  /api/v2/merch/pay/apply:
    post:
      summary: 付款
      deprecated: false
      description: 计算付款手续费等, 如果需要换汇则会返回汇率
      operationId: inquiry_3
      tags:
        - 付款
      parameters:
        - name: X-Merch-Id
          in: header
          description: ''
          example: M24061911365700670
          schema:
            type: string
            default: M24061911365700670
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                request_id:
                  type: string
                  description: 请求id
                amount:
                  minimum: 1
                  type: integer
                  description: 付款金额(币种最小单位)
                  format: int64
                currency:
                  type: string
                  description: >-
                    币种: EUR-欧元, USD-美元, CNY-人民币, GBP-英镑, JPY-日元, AUD-澳元, CAD-加元,
                    SGD-新加坡元, HKD-港币, PHP-菲律宾比索, CNH-离岸人民币
                  enum:
                    - EUR
                    - USD
                    - CNY
                    - GBP
                    - JPY
                    - AUD
                    - CAD
                    - SGD
                    - HKD
                    - PHP
                    - CNH
                beneficiary_id:
                  maxLength: 32
                  minLength: 0
                  type: string
                  description: 收款人id
                postscript:
                  type: string
                  description: 附言
                  maxLength: 64
                  nullable: true
              required:
                - amount
                - currency
                - beneficiary_id
                - request_id
            example: ''
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                      - PROCESSING
                      - SUCCEEDED
                      - FAILED
                    description: 状态
                  fee_amount:
                    type: integer
                    description: 手续费(币种为付款货币，该币种最小单位)
                    format: int64
                  beneficiary_type:
                    type: string
                    description: 收款人类型
                    enum:
                      - PAY
                      - WITHDRAW
                required:
                  - fee_amount
                  - beneficiary_type
                  - status
          headers: {}
        '400':
          description: Bad Request
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '401':
          description: Unauthorized
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '404':
          description: Not Found
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '429':
          description: Too Many Requests
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '500':
          description: Internal Server Error
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
      security: []
  /api/v2/merch/pay/inquiry:
    post:
      summary: 付款状态查询
      deprecated: false
      description: 付款确认结果状态查询
      operationId: status
      tags:
        - 付款
      parameters:
        - name: X-Merch-Id
          in: header
          description: ''
          example: M24061911365700670
          schema:
            type: string
            default: M24061911365700670
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/OpenPlatformCommonV2Req'
            example: ''
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: object
                properties:
                  status:
                    type: string
                    description: 状态
                    enum:
                      - PROCESSING
                      - SUCCEEDED
                      - FAILED
                      - RETURNED
                  fee_amount:
                    type: integer
                    description: 手续费(币种为付款货币，该币种最小单位)
                    format: int64
                  beneficiary_type:
                    type: string
                    description: 收款人类型
                    enum:
                      - PAY
                      - WITHDRAW
                required:
                  - fee_amount
                  - beneficiary_type
                  - status
          headers: {}
        '400':
          description: Bad Request
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '401':
          description: Unauthorized
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '404':
          description: Not Found
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '429':
          description: Too Many Requests
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '500':
          description: Internal Server Error
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
      security: []
  /api/file/upload:
    post:
      summary: 文件上传
      deprecated: false
      description: ''
      operationId: upload
      tags:
        - 文件服务
      parameters:
        - name: X-Merch-Id
          in: header
          description: ''
          example: M24061911365700670
          schema:
            type: string
            default: M24061911365700670
      requestBody:
        content:
          multipart/form-data:
            schema:
              type: object
              properties:
                file:
                  format: binary
                  type: string
                  description: 文件(最大不超过10MiB)
                  example: ''
                meta:
                  description: 文件元数据(json)
                  example: ''
                  type: string
              required:
                - file
                - meta
            example: ''
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/FileUploadResult'
          headers: {}
        '400':
          description: Bad Request
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '401':
          description: Unauthorized
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '404':
          description: Not Found
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '429':
          description: Too Many Requests
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '500':
          description: Internal Server Error
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
      security: []
  /api/v2/merch/contract/create:
    post:
      summary: 订单创建
      deprecated: false
      description: ''
      operationId: create_1
      tags:
        - 订单
      parameters:
        - name: X-Merch-Id
          in: header
          description: ''
          example: M24061911365700670
          schema:
            type: string
            default: M24061911365700670
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                request_id:
                  maxLength: 32
                  minLength: 1
                  type: string
                  description: 请求号，请求方系统内唯一
                buyer_country:
                  type: string
                  description: 买家国家代码,使用ISO3166-2标准2位国家代码(见附录)
                buyer_name:
                  maxLength: 128
                  minLength: 1
                  type: string
                  description: 买家姓名(最长128字符)
                amount:
                  type: integer
                  description: 订单金额(币种最小单位)
                  format: int64
                currency:
                  type: string
                  description: >-
                    币种: EUR-欧元, USD-美元, CNY-人民币, GBP-英镑, JPY-日元, AUD-澳元, CAD-加元,
                    SGD-新加坡元, HKD-港币, PHP-菲律宾比索, CNH-离岸人民币
                  enum:
                    - EUR
                    - USD
                    - CNY
                    - GBP
                    - JPY
                    - AUD
                    - CAD
                    - SGD
                    - HKD
                    - PHP
                    - CNH
                contract_no:
                  maxLength: 32
                  minLength: 1
                  type: string
                  description: 合同编号(最长32字符)(只能为数字和字母)(商户下唯一)
                contract_file_ids:
                  maxItems: 10
                  minItems: 1
                  type: array
                  description: 合同附件id-上传文件接口返回的id(最多10个文件)
                  items:
                    type: integer
                    description: 合同附件id-上传文件接口返回的id(最多10个文件)
                    format: int32
                goods_info:
                  type: object
                  properties:
                    category:
                      type: integer
                      description: 商品分类(支持的商品品类见附件)
                      format: int32
                    name:
                      maxLength: 128
                      minLength: 1
                      type: string
                      description: 商品名称(最长128字符)
                    quantity:
                      type: integer
                      description: 商品数量
                      format: int64
                    url:
                      type: string
                      description: 商品网址
                      maxLength: 256
                      minLength: 1
                    custom_dec_info:
                      type: object
                      properties:
                        dec_method:
                          type: string
                          description: >-
                            申报方式:METHOD_1-未在海关报备或未纳入海关统计的电商交易订单
                            METHOD_2-按一般贸易方式在海关报关出口
                        dec_no:
                          type: string
                          description: 报关单号(最长32字符)
                          minLength: 0
                          maxLength: 32
                      required:
                        - dec_method
                      description: 报关信息
                  description: 商品信息
                  required:
                    - category
                    - name
                    - url
                    - custom_dec_info
                invoice_file_ids:
                  maxItems: 10
                  minItems: 1
                  type: array
                  description: PI/CI/发票id-上传文件接口返回id(最多10个文件)
                  items:
                    type: integer
                    description: PI/CI/发票id-上传文件接口返回id(最多10个文件)
                    format: int32
                is_exchange_settle:
                  type: boolean
                  description: 是否需要结汇
                logistics_info:
                  type: object
                  properties:
                    buyer_type:
                      type: string
                      description: NEW-新买家;OLD-老买家 未发货必传
                      enum:
                        - NEW
                        - OLD
                    destination:
                      maxLength: 256
                      minLength: 1
                      type: string
                      description: 目的地 已发货时必传(最长256字符)
                    expected_ship_date:
                      type: string
                      description: 预期发货日期 未发货时必传 格式:yyyy-MM-dd
                      format: date
                    freight_arrange_file_ids:
                      maxItems: 10
                      minItems: 1
                      type: array
                      description: 货运安排沟通记录id-上传文件接口返回id (最多10个文件)
                      items:
                        type: integer
                        description: 货运安排沟通记录id-上传文件接口返回id 物流状态=UNSHIPPED时必传(最多10个文件)
                        format: int32
                    latest_order_file_ids:
                      maxItems: 10
                      minItems: 1
                      type: array
                      description: 商户与该买家最近一笔交易的报关单或出境物流凭证id-上传文件接口返回id 老买家时必传(最多10个文件)
                      items:
                        type: integer
                        description: 商户与该买家最近一笔交易的报关单或出境物流凭证id-上传文件接口返回id 老买家时必传(最多10个文件)
                        format: int32
                    logistics_company_name:
                      maxLength: 256
                      minLength: 1
                      type: string
                      description: 物流公司名称 已发货时必传(最长256字符)
                    outbound_no:
                      maxLength: 32
                      minLength: 1
                      type: string
                      description: 出境物流单号 已发货时必传((最长32字符)
                    inquiry_records_file_ids:
                      maxItems: 10
                      minItems: 1
                      type: array
                      description: 询盘下单沟通记录-上传文件接口返回的id (最多10个文件)
                      items:
                        type: integer
                        description: 询盘下单沟通记录-上传文件接口返回的id 物流状态=UNSHIPPED时必传(最多10个文件)
                        format: int32
                    ship_date:
                      type: string
                      description: 发货日期 已发货时必传 格式:yyyy-MM-dd
                      format: date
                    ship_status:
                      type: string
                      description: '物流状态: SHIPPED-已发货 UNSHIPPED-未发货'
                      enum:
                        - SHIPPED
                        - UNSHIPPED
                    shipped_file_ids:
                      maxItems: 10
                      minItems: 1
                      type: array
                      description: 发货凭证id-上传文件接口返回的id 已发货时必传(最多10个文件)
                      items:
                        type: integer
                        description: 发货凭证id-上传文件接口返回的id 已发货时必传(最多10个文件)
                        format: int32
                    transaction_type:
                      type: string
                      description: >-
                        成交方式: EXW-工厂交货 FCA-货交承运人 FAS-船边交货 FOB-船上交货 CFR-成本加运费
                        CIF-成本、保险加运费 CPT-运费付至 DDP-完税后交货 DAF-边境交货 DDU-未完税交货
                        DEQ-目的港码头交货 DES-目的港船上交货
                      enum:
                        - EXW
                        - FCA
                        - FAS
                        - FOB
                        - CFR
                        - CIF
                        - CPT
                        - DDP
                        - DAF
                        - DDU
                        - DEQ
                        - DES
                    transport_type:
                      type: string
                      description: >-
                        运输方式: AIR-空运 SHIPPING-海运 EXPRESS-快递 LAND-陆运 POST-邮政
                        OTHER-其他
                      enum:
                        - AIR
                        - SHIPPING
                        - EXPRESS
                        - LAND
                        - POST
                        - OTHER
                  description: 物流信息
                  required:
                    - ship_status
                    - transaction_type
                order_date:
                  type: string
                  description: '订单时间 格式: yyyy-MM-dd'
                  format: date
                remark:
                  maxLength: 128
                  minLength: 0
                  type: string
                  description: 备注(长度128字符)
                other_file_ids:
                  type: array
                  description: 其他附件id-上传文件接口返回的id
                  items:
                    type: integer
                    description: 其他附件id-上传文件接口返回的id
                    format: int32
              required:
                - request_id
                - buyer_country
                - buyer_name
                - amount
                - currency
                - contract_no
                - contract_file_ids
                - goods_info
                - invoice_file_ids
                - is_exchange_settle
                - logistics_info
                - order_date
            example: ''
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ContractOrderCreateRes'
          headers: {}
        '400':
          description: Bad Request
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '401':
          description: Unauthorized
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '404':
          description: Not Found
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '429':
          description: Too Many Requests
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '500':
          description: Internal Server Error
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
      security: []
  /api/v2/merch/contract/update:
    post:
      summary: 订单更新
      deprecated: false
      description: request_id与合同订单创建接口相同
      operationId: update_2
      tags:
        - 订单
      parameters:
        - name: X-Merch-Id
          in: header
          description: ''
          example: M24061911365700670
          schema:
            type: string
            default: M24061911365700670
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                request_id:
                  maxLength: 32
                  minLength: 1
                  type: string
                  description: 请求号，请求方系统内唯一
                buyer_name:
                  maxLength: 128
                  minLength: 1
                  type: string
                  description: 买家姓名(最长128字符)
                buyer_country:
                  type: string
                  description: 买家国家代码,使用ISO3166-2标准2位国家代码(见附录)
                amount:
                  type: integer
                  description: 订单金额(币种最小单位)
                  format: int64
                currency:
                  type: string
                  description: >-
                    币种: EUR-欧元, USD-美元, CNY-人民币, GBP-英镑, JPY-日元, AUD-澳元, CAD-加元,
                    SGD-新加坡元, HKD-港币, PHP-菲律宾比索, CNH-离岸人民币
                  enum:
                    - EUR
                    - USD
                    - CNY
                    - GBP
                    - JPY
                    - AUD
                    - CAD
                    - SGD
                    - HKD
                    - PHP
                    - CNH
                contract_file_ids:
                  maxItems: 10
                  minItems: 1
                  type: array
                  description: 合同附件id-上传文件接口返回的id(最多10个文件)
                  items:
                    type: integer
                    description: 合同附件id-上传文件接口返回的id(最多10个文件)
                    format: int32
                contract_no:
                  maxLength: 32
                  minLength: 1
                  type: string
                  description: 合同编号(最长32字符)(只能为数字和字母)(商户下唯一)
                goods_info:
                  type: object
                  properties:
                    category:
                      type: integer
                      description: 商品分类(支持的商品品类见附件)
                      format: int32
                    name:
                      maxLength: 128
                      minLength: 1
                      type: string
                      description: 商品名称(最长128字符)
                    quantity:
                      type: integer
                      description: 商品数量
                      format: int64
                    url:
                      type: string
                      description: 商品网址
                      maxLength: 256
                      minLength: 1
                    custom_dec_info:
                      type: object
                      properties:
                        dec_method:
                          type: string
                          description: >-
                            申报方式:METHOD_1-未在海关报备或未纳入海关统计的电商交易订单
                            METHOD_2-按一般贸易方式在海关报关出口
                        dec_no:
                          type: string
                          description: 报关单号(最长32字符)
                          minLength: 0
                          maxLength: 32
                      required:
                        - dec_method
                      description: 报关信息
                  description: 商品信息
                  required:
                    - category
                    - name
                    - url
                    - custom_dec_info
                invoice_file_ids:
                  maxItems: 10
                  minItems: 1
                  type: array
                  description: PI/CI/发票id-上传文件接口返回id(最多10个文件)
                  items:
                    type: integer
                    description: PI/CI/发票id-上传文件接口返回id(最多10个文件)
                    format: int32
                is_exchange_settle:
                  type: boolean
                  description: 是否需要结汇
                logistics_info:
                  type: object
                  properties:
                    buyer_type:
                      type: string
                      description: NEW-新买家;OLD-老买家
                      enum:
                        - NEW
                        - OLD
                    destination:
                      maxLength: 256
                      minLength: 1
                      type: string
                      description: 目的地 已发货时必传(最长256字符)
                    expected_ship_date:
                      type: string
                      description: 预期发货日期 未发货时必传 格式:yyyy-MM-dd
                      format: date
                    freight_arrange_file_ids:
                      maxItems: 10
                      minItems: 1
                      type: array
                      description: 货运安排沟通记录id-上传文件接口返回id (最多10个文件)
                      items:
                        type: integer
                        description: 货运安排沟通记录id-上传文件接口返回id 物流状态=UNSHIPPED时必传(最多10个文件)
                        format: int32
                    latest_order_file_ids:
                      maxItems: 10
                      minItems: 1
                      type: array
                      description: 商户与该买家最近一笔交易的报关单或出境物流凭证id-上传文件接口返回id 老买家时必传(最多10个文件)
                      items:
                        type: integer
                        description: 商户与该买家最近一笔交易的报关单或出境物流凭证id-上传文件接口返回id 老买家时必传(最多10个文件)
                        format: int32
                    logistics_company_name:
                      maxLength: 256
                      minLength: 1
                      type: string
                      description: 物流公司名称 已发货时必传(最长256字符)
                    outbound_no:
                      maxLength: 32
                      minLength: 1
                      type: string
                      description: 出境物流单号 已发货时必传((最长32字符)
                    inquiry_records_file_ids:
                      maxItems: 10
                      minItems: 1
                      type: array
                      description: 询盘下单沟通记录-上传文件接口返回的id (最多10个文件)
                      items:
                        type: integer
                        description: 询盘下单沟通记录-上传文件接口返回的id 物流状态=UNSHIPPED时必传(最多10个文件)
                        format: int32
                    ship_date:
                      type: string
                      description: 发货日期 已发货时必传 格式:yyyy-MM-dd
                      format: date
                    ship_status:
                      type: string
                      description: '物流状态: SHIPPED-已发货 UNSHIPPED-未发货'
                      enum:
                        - SHIPPED
                        - UNSHIPPED
                    shipped_file_ids:
                      maxItems: 10
                      minItems: 1
                      type: array
                      description: 发货凭证id-上传文件接口返回的id 已发货时必传(最多10个文件)
                      items:
                        type: integer
                        description: 发货凭证id-上传文件接口返回的id 已发货时必传(最多10个文件)
                        format: int32
                    transaction_type:
                      type: string
                      description: >-
                        成交方式: EXW-工厂交货 FCA-货交承运人 FAS-船边交货 FOB-船上交货 CFR-成本加运费
                        CIF-成本、保险加运费 CPT-运费付至 DDP-完税后交货 DAF-边境交货 DDU-未完税交货
                        DEQ-目的港码头交货 DES-目的港船上交货
                      enum:
                        - EXW
                        - FCA
                        - FAS
                        - FOB
                        - CFR
                        - CIF
                        - CPT
                        - DDP
                        - DAF
                        - DDU
                        - DEQ
                        - DES
                    transport_type:
                      type: string
                      description: >-
                        运输方式: AIR-空运 SHIPPING-海运 EXPRESS-快递 LAND-陆运 POST-邮政
                        OTHER-其他
                      enum:
                        - AIR
                        - SHIPPING
                        - EXPRESS
                        - LAND
                        - POST
                        - OTHER
                  description: 物流信息
                  required:
                    - ship_status
                    - transaction_type
                order_date:
                  type: string
                  description: '订单时间 格式: yyyy-MM-dd'
                  format: date
                remark:
                  maxLength: 128
                  minLength: 0
                  type: string
                  description: 备注(长度128字符)
                other_file_ids:
                  type: array
                  description: 其他附件id-上传文件接口返回的id
                  items:
                    type: integer
                    description: 其他附件id-上传文件接口返回的id
                    format: int32
              required:
                - request_id
                - buyer_name
                - buyer_country
                - amount
                - currency
                - contract_file_ids
                - contract_no
                - goods_info
                - invoice_file_ids
                - is_exchange_settle
                - logistics_info
                - order_date
            example: ''
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ContractOrderUpdateRes'
          headers: {}
        '400':
          description: Bad Request
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '401':
          description: Unauthorized
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '404':
          description: Not Found
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '429':
          description: Too Many Requests
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '500':
          description: Internal Server Error
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
      security: []
  /api/v2/merch/contract/inquiry:
    post:
      summary: 订单状态查询
      deprecated: false
      description: request_id与合同订单创建接口相同
      operationId: inquiry_4
      tags:
        - 订单
      parameters:
        - name: X-Merch-Id
          in: header
          description: ''
          example: M24061911365700670
          schema:
            type: string
            default: M24061911365700670
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ContractOrderGetV2Req'
            example: ''
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ContractOrderGetRes'
          headers: {}
        '400':
          description: Bad Request
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '401':
          description: Unauthorized
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '404':
          description: Not Found
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '429':
          description: Too Many Requests
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '500':
          description: Internal Server Error
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
      security: []
  /api/v2/merch/contract/logistics/supplement:
    post:
      summary: 补充物流(发货)信息
      deprecated: false
      description: request_id与合同订单创建接口相同
      operationId: supplement_1
      tags:
        - 订单
      parameters:
        - name: X-Merch-Id
          in: header
          description: ''
          example: M24061911365700670
          schema:
            type: string
            default: M24061911365700670
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                request_id:
                  maxLength: 32
                  minLength: 1
                  type: string
                  description: 请求号，请求方系统内唯一(需要补充的订单接口的request_id)
                logistics_company_name:
                  type: string
                  description: 物流公司名称
                transport_type:
                  type: string
                  description: '运输方式: AIR-空运 SHIPPING-海运 EXPRESS-快递 LAND-陆运 POST-邮政 OTHER-其他'
                  enum:
                    - AIR
                    - SHIPPING
                    - EXPRESS
                    - LAND
                    - POST
                    - OTHER
                outbound_no:
                  type: string
                  description: 出境物流单号
                destination:
                  type: string
                  description: 目的地
                ship_date:
                  type: string
                  description: '发货日期(时间格式: yyyy-MM-dd)'
                  format: date
                shipped_file_ids:
                  maxItems: 10
                  minItems: 1
                  type: array
                  description: 发货凭证文件ID列表
                  items:
                    type: integer
                    description: 发货凭证文件ID列表
                    format: int32
              required:
                - request_id
                - logistics_company_name
                - transport_type
                - outbound_no
                - destination
                - ship_date
                - shipped_file_ids
            example: ''
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/LogisticsSupplementRes'
          headers: {}
        '400':
          description: Bad Request
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '401':
          description: Unauthorized
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '404':
          description: Not Found
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '429':
          description: Too Many Requests
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '500':
          description: Internal Server Error
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
      security: []
  /api/v2/trade-settle/apply:
    post:
      summary: 创建解付入账流程
      deprecated: false
      description: 收款单状态为[PENDING_RELATE|CHECK_REJECTED]时可以申请
      operationId: relate_1
      tags:
        - 解付入账
      parameters:
        - name: X-Merch-Id
          in: header
          description: ''
          required: true
          example: ''
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TradeSettleApplyReq'
            example: ''
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/TradeSettleApplyRes'
          headers: {}
        '400':
          description: Bad Request
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '401':
          description: Unauthorized
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '404':
          description: Not Found
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '429':
          description: Too Many Requests
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '500':
          description: Internal Server Error
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
      security: []
  /api/v2/trade-settle/inquiry:
    post:
      summary: 解付入账状态查询
      deprecated: false
      description: ''
      operationId: inquiry_6
      tags:
        - 解付入账
      parameters:
        - name: X-Merch-Id
          in: header
          description: ''
          required: true
          example: ''
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TradeSettleInquiryReq'
            example: ''
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/TradeSettleInquiryRes'
          headers: {}
        '400':
          description: Bad Request
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '401':
          description: Unauthorized
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '404':
          description: Not Found
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '429':
          description: Too Many Requests
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '500':
          description: Internal Server Error
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
      security: []
  /api/v2/trade-settle/notify:
    post:
      summary: 解付入账结果(通知)
      deprecated: false
      description: 解付入账结果(通知)
      operationId: notification_5
      tags:
        - 解付入账
      parameters:
        - name: X-Merch-Id
          in: header
          description: ''
          example: M24061911365700670
          schema:
            type: string
            default: M24061911365700670
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                type:
                  type: string
                  description: >-
                    业务类型: MERCH-商户, VA-虚拟账户, INCOMING_REMITTANCE-汇入汇款,
                    CONTRACT_ORDER-合同订单, TRADE_SETTLE-解付入账, PAYEE-收款人,
                    WD_ACCOUNT-提现账户, CUR_EXCHANGE-换汇, PAYMENT-付款
                  enum:
                    - MERCH
                    - VA
                    - INCOMING_REMITTANCE
                    - CONTRACT_ORDER
                    - TRADE_SETTLE
                    - PAYEE
                    - WD_ACCOUNT
                    - FOREX
                    - PAYMENT
                version:
                  type: string
                  description: 版本号(V1、V2、...)
                data:
                  type: object
                  properties:
                    merch_id:
                      type: string
                      description: 商户id
                      minLength: 1
                      maxLength: 20
                    reason:
                      type: string
                      description: 最近一次审核驳回原因
                    recv_order_no:
                      type: string
                      description: 收款单id(汇入汇款通知的单号)
                      minLength: 1
                      maxLength: 32
                    status:
                      type: string
                      description: >-
                        状态(PENDING_RELATE-待关联订单、PENDING_REVIEW-审核中、CREDITED-已入账、PENDING_REFUND-退款中、REJECTED-审核未通过、REFUNDED-已退款)
                      enum:
                        - PENDING_RELATE
                        - PENDING_REVIEW
                        - CREDITED
                        - REJECTED
                        - PENDING_REFUND
                        - REFUNDED
                  description: 业务数据
                  required:
                    - merch_id
                    - recv_order_no
                    - status
              required:
                - type
                - version
                - data
            example: ''
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties: {}
          headers: {}
        '400':
          description: Bad Request
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '401':
          description: Unauthorized
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '404':
          description: Not Found
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '429':
          description: Too Many Requests
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '500':
          description: Internal Server Error
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
      security: []
  /api/v2/merch/balance:
    post:
      summary: 查询账户余额
      deprecated: false
      description: 账户币种若不传，则返回全部币种
      operationId: query
      tags:
        - 账户余额
      parameters:
        - name: X-Merch-Id
          in: header
          description: ''
          required: true
          example: ''
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                currency:
                  type: string
                  description: >-
                    币种: EUR-欧元, USD-美元, CNY-人民币, GBP-英镑, JPY-日元, AUD-澳元, CAD-加元,
                    SGD-新加坡元, HKD-港币, PHP-菲律宾比索,  CNH-离岸人民币
                  enum:
                    - EUR
                    - USD
                    - CNY
                    - GBP
                    - JPY
                    - AUD
                    - CAD
                    - SGD
                    - HKD
                    - PHP
                    - CNH
            example: ''
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: object
                properties:
                  account_list:
                    type: array
                    description: 列表
                    items:
                      type: object
                      properties:
                        balance:
                          type: integer
                          description: 余额(币种最小单位)
                          format: int64
                        currency:
                          type: string
                          description: >-
                            币种: EUR-欧元, USD-美元, CNY-人民币, GBP-英镑, JPY-日元, AUD-澳元,
                            CAD-加元, SGD-新加坡元, HKD-港币, PHP-菲律宾比索, CNH-离岸人民币
                          enum:
                            - EUR
                            - USD
                            - CNY
                            - GBP
                            - JPY
                            - AUD
                            - CAD
                            - SGD
                            - HKD
                            - PHP
                            - CNH
                      required:
                        - balance
                        - currency
                required:
                  - account_list
          headers: {}
        '400':
          description: Bad Request
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '401':
          description: Unauthorized
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '404':
          description: Not Found
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '429':
          description: Too Many Requests
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '500':
          description: Internal Server Error
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
      security: []
  /api/v2/merch/onboard/apply:
    post:
      summary: 商户入网申请
      deprecated: false
      description: 创建商户信息
      operationId: apply_1
      tags:
        - 商户入网
      parameters:
        - name: X-Merch-Id
          in: header
          description: ''
          example: M24061911365700670
          schema:
            type: string
            default: M24061911365700670
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                request_id:
                  maxLength: 32
                  minLength: 1
                  type: string
                  description: 请求号，请求方系统内唯一
                contact_person:
                  description: 联系人信息
                  type: object
                  properties:
                    phone_prefix:
                      maxLength: 5
                      minLength: 0
                      type: string
                      description: 所属国家地区区号, 如：+86 或 +852
                    phone:
                      maxLength: 64
                      minLength: 0
                      type: string
                      description: 联系人电话(长度64字符)
                    email:
                      maxLength: 64
                      minLength: 0
                      type: string
                      description: 联系人邮箱(长度64字符)
                  required:
                    - phone_prefix
                    - phone
                    - email
                license:
                  type: object
                  properties:
                    region:
                      maxLength: 2
                      minLength: 0
                      type: string
                      description: 2位英文国家编码, 参考附录-国家地区代码
                    ent_name:
                      maxLength: 128
                      minLength: 0
                      type: string
                      description: 企业名称(长度128个字符)
                    ent_name_en:
                      maxLength: 200
                      minLength: 0
                      type: string
                      description: 企业英文名称(长度100个字符)
                    found_date:
                      type: string
                      description: 成立日期
                      format: date
                    registered_currency:
                      maxLength: 3
                      minLength: 0
                      type: string
                      description: 注册资本币种符号, 使用ISO-4217标准3位币种代码
                    registered_capital:
                      type: number
                      description: >-
                        注册资本，币种最小单位。没有注册资金的填0; reigon为大陆企业则是CNY, 为香港企业则是HKD,
                        为全球企业则是USD
                    address:
                      description: 企业注册地址信息
                      type: object
                      properties:
                        province:
                          type: string
                          description: 省份/州, 大陆传编码(见附件)
                          maxLength: 50
                          minLength: 0
                        city:
                          maxLength: 50
                          minLength: 0
                          type: string
                          description: 城市, 大陆传编码(见附件)
                        zipcode:
                          maxLength: 20
                          minLength: 0
                          type: string
                          description: 邮编
                        address1:
                          type: string
                          description: 地址行1
                        address2:
                          type: string
                          description: 地址行2
                      required:
                        - province
                        - city
                        - zipcode
                        - address1
                    legal_rep_name:
                      maxLength: 128
                      minLength: 0
                      type: string
                      description: region为大陆必填-大陆企业 法定代表人姓名
                    license_file_id:
                      type: integer
                      description: region为大陆必填-大陆企业 营业执照文件
                      format: int32
                    ent_type:
                      type: string
                      description: >-
                        region为大陆必填-企业类型: PERSONAL-个体工商户, OTHER-其它,
                        ENTERPRISE-企业, GOV-政府及事业单位, SOCIAL-社会组织, PN-民办非企业
                    uni_social_credit:
                      maxLength: 18
                      minLength: 0
                      type: string
                      description: region为大陆必填-大陆企业 统一社会信用代码
                    busi_from:
                      type: string
                      description: region为大陆必填-大陆企业 经营日期(起)
                      format: date
                    busi_end:
                      type: string
                      description: region为大陆选填-大陆企业 经营日期(止), 和是否长期互斥必填二选一,都传默认长期
                      format: date
                    long_term:
                      type: boolean
                      description: region为大陆选填-是否长期, 和企业经营截止日期互斥，都传默认长期
                    br_no:
                      type: string
                      description: region为香港必填-全球企业 登记证号码
                    br_file_id:
                      type: integer
                      description: region为香港必填-全球企业 公司注册证书
                      format: int32
                    annual_return_file_id:
                      type: integer
                      description: region为香港选填-香港企业 周年申报表(和法团成立表二选一)
                      format: int32
                    incorporation_form_file_id:
                      type: integer
                      description: region为香港选填-香港企业 法团成立表(和周年申报表二选一)
                      format: int32
                    br_expiry_date:
                      type: string
                      description: region为香港必填-香港企业 届满日期:yyyy-MM-dd
                      format: date
                    cr_issue_date:
                      type: string
                      description: region为香港必填-香港企业 证明书发出日期:yyyy-MM-dd
                      format: date
                    company_article_file_id:
                      type: integer
                      description: region为非大陆选填-公司章程文件
                      format: int32
                    cr_file_id:
                      type: integer
                      description: region为非大陆必填-香港/全球企业公司注册证书
                      format: int32
                    cr_no:
                      type: string
                      description: region为非大陆必填-香港企业证明书编号/全球企业登记证号码
                    share_structure_file_id:
                      type: integer
                      description: region为非大陆选填-全球企业 股权架构文件
                      format: int32
                    cr_expiry_date:
                      type: string
                      description: region为全球必填-全球企业 届满日期:yyyy-MM-dd
                      format: date
                    other_file_ids:
                      type: array
                      description: 其他附件
                      items:
                        type: integer
                        description: 其他附件
                        format: int32
                  description: 企业信息
                  required:
                    - region
                    - ent_name
                    - ent_name_en
                    - found_date
                    - registered_currency
                    - registered_capital
                    - address
                    - legal_rep_name
                    - license_file_id
                    - ent_type
                    - uni_social_credit
                    - busi_from
                    - br_no
                    - br_file_id
                    - br_expiry_date
                    - cr_issue_date
                    - cr_file_id
                    - cr_no
                    - cr_expiry_date
                business:
                  type: object
                  properties:
                    industry:
                      type: integer
                      description: 行业 数据字典 INDUSTRY(见附录)
                      format: int32
                    employee_number:
                      type: string
                      description: >-
                        企业员工人数: FIRST_LEVEL:少于5人、SECOND_LEVEL:5-20人,
                        THIRD_LEVEL:20-50人, FOURTH_LEVEL:50人以上
                    address:
                      description: 企业经营地址信息
                      type: object
                      properties:
                        province:
                          type: string
                          description: 省份/州, 大陆传编码(见附件)
                          minLength: 0
                          maxLength: 50
                        city:
                          maxLength: 50
                          minLength: 0
                          type: string
                          description: 城市, 大陆传编码(见附件)
                        zipcode:
                          maxLength: 20
                          minLength: 0
                          type: string
                          description: 邮编
                        address1:
                          type: string
                          description: 地址行1
                        address2:
                          type: string
                          description: 地址行2
                      required:
                        - province
                        - city
                        - zipcode
                        - address1
                    export_country:
                      uniqueItems: true
                      type: array
                      description: 主要出口国家(非制裁国家),数组,使用ISO3166-2标准2位国家/地区代码(见附录)
                      items:
                        type: string
                        description: 主要出口国家,数组,使用ISO3166-2标准2位国家/地区代码(见附录)
                    export_type:
                      uniqueItems: true
                      type: array
                      description: >-
                        出口类型：SELF_SUPPORT-自营出口，EXPORT-委托出口，INTERNATIONAL-国际快速，OTHER-其他
                      items:
                        type: string
                        description: >-
                          出口类型：SELF_SUPPORT-自营出口，EXPORT-委托出口，INTERNATIONAL-国际快速，OTHER-其他
                    trade_volume:
                      type: string
                      description: >-
                        月贸易额:
                        FIRST_LEVEL(0-5万美元)、SECOND_LEVEL(5-10万美元)、THIRD_LEVEL(10-25万美元)、FOURTH_LEVEL(25-50万美元)、FIFTH_LEVEL(50-100万美元)、SIXTH_LEVEL(100万美元以上)
                    website:
                      maxLength: 200
                      minLength: 0
                      type: string
                      description: 公司网站(字符长度200)
                  description: 企业经营信息
                  required:
                    - industry
                    - employee_number
                    - address
                    - export_country
                    - export_type
                    - trade_volume
                stakeholder_list:
                  type: array
                  description: 企业关联个人信息列表
                  items:
                    type: object
                    properties:
                      identity_type:
                        type: string
                        description: >-
                          身份类型：
                          LEGAL_PERSON-法人、BENEFICIARY-最终受益人、SHAREHOLDER-股东、DIRECTOR-董事
                      name:
                        maxLength: 128
                        minLength: 0
                        type: string
                        description: 姓名(长度128字符)
                      nationality:
                        maxLength: 2
                        minLength: 0
                        type: string
                        description: 国籍(ISO3166-2标准2位国家/地区代码)
                      birth_date:
                        type: string
                        description: 生日, 格式yyyy-MM-dd，如 2023-12-12
                        format: date
                      address_proof_file_id:
                        type: integer
                        description: 地址证明文件, 非中国大陆身份证，地址证明文件必填
                        format: int32
                      doc_type:
                        type: string
                        description: >-
                          身份证类型
                          ID_CARD：二代居民身份证，HK_CARD：香港永久居住证，PASSPORT：护照，MO_CARD：澳门永久居住证，HK_MO_PASS：港澳居民来往内地通行证，TW_CARD：台湾居民来往大陆通行证
                      id_number:
                        maxLength: 18
                        minLength: 0
                        type: string
                        description: 证件号码(长度18字符)
                      doc_address:
                        maxLength: 256
                        minLength: 0
                        type: string
                        description: 证件详细地址(长度256字符), 大陆身份证必填
                      doc_non_portrait_side_file_id:
                        type: integer
                        description: 证件反面文件, 除护照、台湾往来大陆通行证不需要提供，其他证件类型均需要提供
                        format: int32
                      doc_portrait_side_file_id:
                        type: integer
                        description: 证件正面文件
                        format: int32
                      eff_date_start:
                        type: string
                        description: 证件起始日期；格式yyyy-MM-dd，如 2023-12-12
                        format: date
                      eff_date_end:
                        type: string
                        description: >-
                          证件失效日期；格式yyyy-MM-dd，如 2023-12-12，和long_term二选一,
                          其它按日期格式上传
                        format: date
                      long_term:
                        type: boolean
                        description: 是否长期(大陆身份证件选填), 和eff_date_end二选一
                      share:
                        type: number
                        description: 持股比例, 百分比, 51.12%传51.12, 最多两位小数, 受益人、董事必填
                      resident_address:
                        description: 居住地址信息
                        type: object
                        properties:
                          province:
                            type: string
                            description: 省份/州, 大陆传编码(见附件)
                            minLength: 0
                            maxLength: 50
                          city:
                            maxLength: 50
                            minLength: 0
                            type: string
                            description: 城市, 大陆传编码(见附件)
                          zipcode:
                            maxLength: 20
                            minLength: 0
                            type: string
                            description: 邮编
                          address1:
                            type: string
                            description: 地址行1
                          address2:
                            type: string
                            description: 地址行2
                        required:
                          - province
                          - city
                          - zipcode
                          - address1
                    required:
                      - identity_type
                      - name
                      - nationality
                      - birth_date
                      - doc_type
                      - id_number
                      - doc_portrait_side_file_id
                      - eff_date_start
                      - resident_address
                authentication:
                  type: object
                  properties:
                    authorized_agent:
                      type: object
                      properties:
                        name:
                          maxLength: 128
                          minLength: 0
                          type: string
                          description: 姓名(长度128字符)
                        nationality:
                          maxLength: 2
                          minLength: 0
                          type: string
                          description: 国籍(ISO3166-2标准2位国家/地区代码)
                        birth_date:
                          type: string
                          description: 生日, 格式yyyy-MM-dd，如 2023-12-12
                          format: date
                        address_proof_file_id:
                          type: integer
                          description: 地址证明文件, 非中国大陆身份证，地址证明文件必填
                          format: int32
                        doc_type:
                          type: string
                          description: >-
                            身份证类型
                            ID_CARD：二代居民身份证，HK_CARD：香港永久居住证，PASSPORT：护照，MO_CARD：澳门永久居住证，HK_MO_PASS：港澳居民来往内地通行证，TW_CARD：台湾居民来往大陆通行证
                        id_number:
                          maxLength: 18
                          minLength: 0
                          type: string
                          description: 证件号码(长度18字符)
                        doc_address:
                          maxLength: 256
                          minLength: 0
                          type: string
                          description: 证件详细地址(长度256字符), 大陆身份证必填
                        doc_non_portrait_side_file_id:
                          type: integer
                          description: 证件反面文件, 除护照、台湾往来大陆通行证不需要提供，其他证件类型均需要提供
                          format: int32
                        doc_portrait_side_file_id:
                          type: integer
                          description: 证件正面文件
                          format: int32
                        eff_date_start:
                          type: string
                          description: 证件起始日期；格式yyyy-MM-dd，如 2023-12-12
                          format: date
                        eff_date_end:
                          type: string
                          description: >-
                            证件失效日期；格式yyyy-MM-dd，如 2023-12-12，和long_term二选一,
                            其它按日期格式上传
                          format: date
                        long_term:
                          type: boolean
                          description: 是否长期(大陆身份证件选填), 和eff_date_end二选一
                        resident_address:
                          description: 居住地址信息
                          type: object
                          properties:
                            province:
                              type: string
                              description: 省份/州, 大陆传编码(见附件)
                              minLength: 0
                              maxLength: 50
                            city:
                              maxLength: 50
                              minLength: 0
                              type: string
                              description: 城市, 大陆传编码(见附件)
                            zipcode:
                              maxLength: 20
                              minLength: 0
                              type: string
                              description: 邮编
                            address1:
                              type: string
                              description: 地址行1
                            address2:
                              type: string
                              description: 地址行2
                          required:
                            - province
                            - city
                            - zipcode
                            - address1
                      description: 授权代理人信息
                      required:
                        - name
                        - nationality
                        - birth_date
                        - doc_type
                        - id_number
                        - doc_portrait_side_file_id
                        - eff_date_start
                        - resident_address
                  description: 认证信息
              required:
                - request_id
                - contact_person
                - license
                - business
                - stakeholder_list
            example: ''
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/IdentityVerifyAddRes'
          headers: {}
        '400':
          description: Bad Request
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '401':
          description: Unauthorized
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '404':
          description: Not Found
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '429':
          description: Too Many Requests
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '500':
          description: Internal Server Error
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
      security: []
  /api/v2/merch/onboard/update:
    post:
      summary: 商户资料更新
      deprecated: false
      description: 商户信息更新
      operationId: update_1
      tags:
        - 商户入网
      parameters:
        - name: X-Merch-Id
          in: header
          description: ''
          example: M24061911365700670
          schema:
            type: string
            default: M24061911365700670
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                request_id:
                  maxLength: 32
                  minLength: 1
                  type: string
                  description: 请求号，请求方系统内唯一
                contact_person:
                  description: 联系人信息
                  type: object
                  properties:
                    phone_prefix:
                      maxLength: 5
                      minLength: 0
                      type: string
                      description: 所属国家地区区号, 如：+86 或 +852
                    phone:
                      maxLength: 64
                      minLength: 0
                      type: string
                      description: 联系人电话(长度64字符)
                    email:
                      maxLength: 64
                      minLength: 0
                      type: string
                      description: 联系人邮箱(长度64字符)
                  required:
                    - phone_prefix
                    - phone
                    - email
                license:
                  type: object
                  properties:
                    region:
                      maxLength: 2
                      minLength: 0
                      type: string
                      description: 2位英文国家编码, 参考附录-国家地区代码
                    ent_name:
                      maxLength: 128
                      minLength: 0
                      type: string
                      description: 企业名称(长度128个字符)
                    ent_name_en:
                      maxLength: 200
                      minLength: 0
                      type: string
                      description: 企业英文名称(长度100个字符)
                    found_date:
                      type: string
                      description: 成立日期
                      format: date
                    registered_currency:
                      maxLength: 3
                      minLength: 0
                      type: string
                      description: 注册资本币种符号, 使用ISO-4217标准3位币种代码
                    registered_capital:
                      type: number
                      description: >-
                        注册资本，币种最小单位。没有注册资金的填0; reigon为大陆企业则是CNY, 为香港企业则是HKD,
                        为全球企业则是USD
                    address:
                      description: 企业注册地址信息
                      type: object
                      properties:
                        province:
                          type: string
                          description: 省份/州, 大陆传编码(见附件)
                          minLength: 0
                          maxLength: 50
                        city:
                          maxLength: 50
                          minLength: 0
                          type: string
                          description: 城市, 大陆传编码(见附件)
                        zipcode:
                          maxLength: 20
                          minLength: 0
                          type: string
                          description: 邮编
                        address1:
                          type: string
                          description: 地址行1
                        address2:
                          type: string
                          description: 地址行2
                      required:
                        - province
                        - city
                        - zipcode
                        - address1
                    legal_rep_name:
                      maxLength: 128
                      minLength: 0
                      type: string
                      description: region为大陆必填-大陆企业 法定代表人姓名
                    license_file_id:
                      type: integer
                      description: region为大陆必填-大陆企业 营业执照文件
                      format: int32
                    ent_type:
                      type: string
                      description: >-
                        region为大陆必填-企业类型: PERSONAL-个体工商户, OTHER-其它,
                        ENTERPRISE-企业, GOV-政府及事业单位, SOCIAL-社会组织, PN-民办非企业
                    uni_social_credit:
                      maxLength: 18
                      minLength: 0
                      type: string
                      description: region为大陆必填-大陆企业 统一社会信用代码
                    busi_from:
                      type: string
                      description: region为大陆必填-大陆企业 经营日期(起)
                      format: date
                    busi_end:
                      type: string
                      description: region为大陆选填-大陆企业 经营日期(止), 和是否长期互斥必填二选一,都传默认长期
                      format: date
                    long_term:
                      type: boolean
                      description: region为大陆选填-是否长期, 和企业经营截止日期互斥，都传默认长期
                    br_no:
                      type: string
                      description: region为香港必填-全球企业 登记证号码
                    br_file_id:
                      type: integer
                      description: region为香港必填-全球企业 公司注册证书
                      format: int32
                    annual_return_file_id:
                      type: integer
                      description: region为香港选填-香港企业 周年申报表(和法团成立表二选一)
                      format: int32
                    incorporation_form_file_id:
                      type: integer
                      description: region为香港选填-香港企业 法团成立表(和周年申报表二选一)
                      format: int32
                    br_expiry_date:
                      type: string
                      description: region为香港必填-香港企业 届满日期:yyyy-MM-dd
                      format: date
                    cr_issue_date:
                      type: string
                      description: region为香港必填-香港企业 证明书发出日期:yyyy-MM-dd
                      format: date
                    company_article_file_id:
                      type: integer
                      description: region为非大陆选填-公司章程文件
                      format: int32
                    cr_file_id:
                      type: integer
                      description: region为非大陆必填-香港/全球企业公司注册证书
                      format: int32
                    cr_no:
                      type: string
                      description: region为非大陆必填-香港企业证明书编号/全球企业登记证号码
                    share_structure_file_id:
                      type: integer
                      description: region为非大陆选填-全球企业 股权架构文件
                      format: int32
                    cr_expiry_date:
                      type: string
                      description: region为全球必填-全球企业 届满日期:yyyy-MM-dd
                      format: date
                    other_file_ids:
                      type: array
                      description: 其他附件
                      items:
                        type: integer
                        description: 其他附件
                        format: int32
                  description: 企业信息
                  required:
                    - region
                    - ent_name
                    - ent_name_en
                    - found_date
                    - registered_currency
                    - registered_capital
                    - address
                    - legal_rep_name
                    - license_file_id
                    - ent_type
                    - uni_social_credit
                    - busi_from
                    - br_no
                    - br_file_id
                    - br_expiry_date
                    - cr_issue_date
                    - cr_file_id
                    - cr_no
                    - cr_expiry_date
                business:
                  type: object
                  properties:
                    industry:
                      type: integer
                      description: 行业 数据字典 INDUSTRY(见附录)
                      format: int32
                    employee_number:
                      type: string
                      description: >-
                        企业员工人数: FIRST_LEVEL:少于5人、SECOND_LEVEL:5-20人,
                        THIRD_LEVEL:20-50人, FOURTH_LEVEL:50人以上
                    address:
                      description: 企业经营地址信息
                      type: object
                      properties:
                        province:
                          type: string
                          description: 省份/州, 大陆传编码(见附件)
                          minLength: 0
                          maxLength: 50
                        city:
                          maxLength: 50
                          minLength: 0
                          type: string
                          description: 城市, 大陆传编码(见附件)
                        zipcode:
                          maxLength: 20
                          minLength: 0
                          type: string
                          description: 邮编
                        address1:
                          type: string
                          description: 地址行1
                        address2:
                          type: string
                          description: 地址行2
                      required:
                        - province
                        - city
                        - zipcode
                        - address1
                    export_country:
                      uniqueItems: true
                      type: array
                      description: 主要出口国家(非制裁国家),数组,使用ISO3166-2标准2位国家/地区代码(见附录)
                      items:
                        type: string
                        description: 主要出口国家,数组,使用ISO3166-2标准2位国家/地区代码(见附录)
                    export_type:
                      uniqueItems: true
                      type: array
                      description: >-
                        出口类型：SELF_SUPPORT-自营出口，EXPORT-委托出口，INTERNATIONAL-国际快速，OTHER-其他
                      items:
                        type: string
                        description: >-
                          出口类型：SELF_SUPPORT-自营出口，EXPORT-委托出口，INTERNATIONAL-国际快速，OTHER-其他
                    trade_volume:
                      type: string
                      description: >-
                        月贸易额:
                        FIRST_LEVEL(0-5万美元)、SECOND_LEVEL(5-10万美元)、THIRD_LEVEL(10-25万美元)、FOURTH_LEVEL(25-50万美元)、FIFTH_LEVEL(50-100万美元)、SIXTH_LEVEL(100万美元以上)
                    website:
                      maxLength: 200
                      minLength: 0
                      type: string
                      description: 公司网站(字符长度200)
                  description: 企业经营信息
                  required:
                    - industry
                    - employee_number
                    - address
                    - export_country
                    - export_type
                    - trade_volume
                stakeholder_list:
                  type: array
                  description: 企业关联个人信息列表
                  items:
                    type: object
                    properties:
                      identity_type:
                        type: string
                        description: >-
                          身份类型：
                          LEGAL_PERSON-法人、BENEFICIARY-最终受益人、SHAREHOLDER-股东、DIRECTOR-董事
                      name:
                        maxLength: 128
                        minLength: 0
                        type: string
                        description: 姓名(长度128字符)
                      nationality:
                        maxLength: 2
                        minLength: 0
                        type: string
                        description: 国籍(ISO3166-2标准2位国家/地区代码)
                      birth_date:
                        type: string
                        description: 生日, 格式yyyy-MM-dd，如 2023-12-12
                        format: date
                      address_proof_file_id:
                        type: integer
                        description: 地址证明文件, 非中国大陆身份证，地址证明文件必填
                        format: int32
                      doc_type:
                        type: string
                        description: >-
                          身份证类型
                          ID_CARD：二代居民身份证，HK_CARD：香港永久居住证，PASSPORT：护照，MO_CARD：澳门永久居住证，HK_MO_PASS：港澳居民来往内地通行证，TW_CARD：台湾居民来往大陆通行证
                      id_number:
                        maxLength: 18
                        minLength: 0
                        type: string
                        description: 证件号码(长度18字符)
                      doc_address:
                        maxLength: 256
                        minLength: 0
                        type: string
                        description: 证件详细地址(长度256字符), 大陆身份证必填
                      doc_non_portrait_side_file_id:
                        type: integer
                        description: 证件反面文件, 除护照、台湾往来大陆通行证不需要提供，其他证件类型均需要提供
                        format: int32
                      doc_portrait_side_file_id:
                        type: integer
                        description: 证件正面文件
                        format: int32
                      eff_date_start:
                        type: string
                        description: 证件起始日期；格式yyyy-MM-dd，如 2023-12-12
                        format: date
                      eff_date_end:
                        type: string
                        description: >-
                          证件失效日期；格式yyyy-MM-dd，如 2023-12-12，和long_term二选一,
                          其它按日期格式上传
                        format: date
                      long_term:
                        type: boolean
                        description: 是否长期(大陆身份证件选填), 和eff_date_end二选一
                      share:
                        type: number
                        description: 持股比例, 百分比, 51.12%传51.12, 最多两位小数, 受益人、董事必填
                      resident_address:
                        description: 居住地址信息
                        type: object
                        properties:
                          province:
                            type: string
                            description: 省份/州, 大陆传编码(见附件)
                            minLength: 0
                            maxLength: 50
                          city:
                            maxLength: 50
                            minLength: 0
                            type: string
                            description: 城市, 大陆传编码(见附件)
                          zipcode:
                            maxLength: 20
                            minLength: 0
                            type: string
                            description: 邮编
                          address1:
                            type: string
                            description: 地址行1
                          address2:
                            type: string
                            description: 地址行2
                        required:
                          - province
                          - city
                          - zipcode
                          - address1
                    required:
                      - identity_type
                      - name
                      - nationality
                      - birth_date
                      - doc_type
                      - id_number
                      - doc_portrait_side_file_id
                      - eff_date_start
                      - resident_address
                authentication:
                  type: object
                  properties:
                    authorized_agent:
                      type: object
                      properties:
                        name:
                          maxLength: 128
                          minLength: 0
                          type: string
                          description: 姓名(长度128字符)
                        nationality:
                          maxLength: 2
                          minLength: 0
                          type: string
                          description: 国籍(ISO3166-2标准2位国家/地区代码)
                        birth_date:
                          type: string
                          description: 生日, 格式yyyy-MM-dd，如 2023-12-12
                          format: date
                        address_proof_file_id:
                          type: integer
                          description: 地址证明文件, 非中国大陆身份证，地址证明文件必填
                          format: int32
                        doc_type:
                          type: string
                          description: >-
                            身份证类型
                            ID_CARD：二代居民身份证，HK_CARD：香港永久居住证，PASSPORT：护照，MO_CARD：澳门永久居住证，HK_MO_PASS：港澳居民来往内地通行证，TW_CARD：台湾居民来往大陆通行证
                        id_number:
                          maxLength: 18
                          minLength: 0
                          type: string
                          description: 证件号码(长度18字符)
                        doc_address:
                          maxLength: 256
                          minLength: 0
                          type: string
                          description: 证件详细地址(长度256字符), 大陆身份证必填
                        doc_non_portrait_side_file_id:
                          type: integer
                          description: 证件反面文件, 除护照、台湾往来大陆通行证不需要提供，其他证件类型均需要提供
                          format: int32
                        doc_portrait_side_file_id:
                          type: integer
                          description: 证件正面文件
                          format: int32
                        eff_date_start:
                          type: string
                          description: 证件起始日期；格式yyyy-MM-dd，如 2023-12-12
                          format: date
                        eff_date_end:
                          type: string
                          description: >-
                            证件失效日期；格式yyyy-MM-dd，如 2023-12-12，和long_term二选一,
                            其它按日期格式上传
                          format: date
                        long_term:
                          type: boolean
                          description: 是否长期(大陆身份证件选填), 和eff_date_end二选一
                        resident_address:
                          description: 居住地址信息
                          type: object
                          properties:
                            province:
                              type: string
                              description: 省份/州, 大陆传编码(见附件)
                              minLength: 0
                              maxLength: 50
                            city:
                              maxLength: 50
                              minLength: 0
                              type: string
                              description: 城市, 大陆传编码(见附件)
                            zipcode:
                              maxLength: 20
                              minLength: 0
                              type: string
                              description: 邮编
                            address1:
                              type: string
                              description: 地址行1
                            address2:
                              type: string
                              description: 地址行2
                          required:
                            - province
                            - city
                            - zipcode
                            - address1
                      description: 授权代理人信息
                      required:
                        - name
                        - nationality
                        - birth_date
                        - doc_type
                        - id_number
                        - doc_portrait_side_file_id
                        - eff_date_start
                        - resident_address
                  description: 认证信息
              required:
                - request_id
                - contact_person
                - license
                - business
                - stakeholder_list
            example: ''
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/IdentityVerifyAddRes'
          headers: {}
        '400':
          description: Bad Request
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '401':
          description: Unauthorized
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '404':
          description: Not Found
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '429':
          description: Too Many Requests
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '500':
          description: Internal Server Error
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
      security: []
  /api/v2/merch/onboard/inquiry:
    post:
      summary: 商户入网结果查询
      deprecated: false
      description: 商户入网结果查询
      operationId: inquiry_2
      tags:
        - 商户入网
      parameters:
        - name: X-Merch-Id
          in: header
          description: ''
          example: M24061911365700670
          schema:
            type: string
            default: M24061911365700670
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MerchOnboardInquiryReq'
            example: ''
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/IdentityVerifyStatusRes'
          headers: {}
        '400':
          description: Bad Request
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '401':
          description: Unauthorized
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '404':
          description: Not Found
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '429':
          description: Too Many Requests
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '500':
          description: Internal Server Error
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
      security: []
  /api/v2/merch/onboard/notify:
    post:
      summary: 商户入网结果(通知)
      deprecated: false
      description: 商户入网结果(通知)
      operationId: notification_2
      tags:
        - 商户入网
      parameters:
        - name: X-Merch-Id
          in: header
          description: ''
          example: M24061911365700670
          schema:
            type: string
            default: M24061911365700670
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                type:
                  type: string
                  description: >-
                    业务类型: MERCH-商户, VA-虚拟账户, INCOMING_REMITTANCE-汇入汇款,
                    CONTRACT_ORDER-合同订单, TRADE_SETTLE-解付入账, PAYEE-收款人,
                    WD_ACCOUNT-提现账户, CUR_EXCHANGE-换汇, PAYMENT-付款
                  enum:
                    - MERCH
                    - VA
                    - INCOMING_REMITTANCE
                    - CONTRACT_ORDER
                    - TRADE_SETTLE
                    - PAYEE
                    - WD_ACCOUNT
                    - FOREX
                    - PAYMENT
                version:
                  type: string
                  description: 版本号(V1、V2、...)
                data:
                  type: object
                  properties:
                    request_id:
                      maxLength: 32
                      minLength: 1
                      type: string
                      description: 请求号，请求方系统内唯一
                    merch_id:
                      type: string
                      description: 商户id
                      minLength: 0
                      maxLength: 20
                    status:
                      type: string
                      description: >-
                        身份认证状态: INIT-初始 WAIT-待审核 PASS-审核通过 REFUSED-审核未通过
                        AUTH_FAIL-授权取消
                      enum:
                        - INIT
                        - WAIT
                        - PASS
                        - REFUSED
                        - AUTH_FAIL
                    msg:
                      type: string
                      description: 结果说明
                  description: 业务数据
                  required:
                    - request_id
                    - merch_id
                    - status
              required:
                - type
                - version
                - data
            example: ''
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties: {}
          headers: {}
        '400':
          description: Bad Request
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '401':
          description: Unauthorized
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '404':
          description: Not Found
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '429':
          description: Too Many Requests
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '500':
          description: Internal Server Error
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
      security: []
  /api/v2/merch/va/apply:
    post:
      summary: 收款账户开通申请
      deprecated: false
      description: 收款账户开通申请
      operationId: apply
      tags:
        - 收款账户
      parameters:
        - name: X-Merch-Id
          in: header
          description: ''
          example: M24061911365700670
          schema:
            type: string
            default: M24061911365700670
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MerchVaCreateV2Req'
            example: ''
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: object
                properties:
                  request_id:
                    type: string
                    description: 请求号，请求方系统内唯一
                    maxLength: 32
                    minLength: 1
                  type:
                    type: string
                    description: 账户类型 LOCAL-本地,SWIFT-全球
                    enum:
                      - LOCAL
                      - GLOBAL
                  country_code:
                    type: string
                    description: 收款国家，原样返回
                  currencies:
                    uniqueItems: true
                    type: array
                    description: 收款币种，原样返回
                    items:
                      type: string
                      description: >-
                        币种: EUR-欧元, USD-美元, CNY-人民币, GBP-英镑, JPY-日元, AUD-澳元,
                        CAD-加元, SGD-新加坡元, HKD-港币, PHP-菲律宾比索, THB-泰铢, CNH-离岸人民币
                      enum:
                        - EUR
                        - USD
                        - CNY
                        - GBP
                        - JPY
                        - AUD
                        - CAD
                        - SGD
                        - HKD
                        - PHP
                        - CNH
                  account_no:
                    maxLength: 20
                    minLength: 0
                    type: string
                    description: 收款账号(长度20字符)
                  status:
                    type: string
                    description: '账户状态: ENABLED-启用, PENDING-待审核, REJECTED-审核拒绝'
                    enum:
                      - ENABLED
                      - PENDING
                      - REJECTED
                  bank_name:
                    maxLength: 64
                    minLength: 0
                    type: string
                    description: 银行名称(长度64字符)
                  bank_address:
                    maxLength: 128
                    minLength: 0
                    type: string
                    description: 银行地址(长度128字符)
                  account_holder_name:
                    maxLength: 100
                    minLength: 0
                    type: string
                    description: 账户持有者(100字符)
                  bic_swift_code:
                    maxLength: 16
                    minLength: 0
                    type: string
                    description: bic/swift_code(长度16字符)
                  routing_number:
                    type: string
                    description: routing number/ach routing number/wire routing number三返一
                required:
                  - request_id
                  - type
                  - country_code
                  - currencies
                  - account_no
                  - status
                  - bank_name
                  - bank_address
                  - account_holder_name
                  - bic_swift_code
          headers: {}
        '400':
          description: Bad Request
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '401':
          description: Unauthorized
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '404':
          description: Not Found
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '429':
          description: Too Many Requests
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '500':
          description: Internal Server Error
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
      security: []
  /api/v2/merch/va/inquiry:
    post:
      summary: 收款账号开通申请结果查询
      deprecated: false
      description: 收款账号开通申请结果查询
      operationId: inquiry
      tags:
        - 收款账户
      parameters:
        - name: X-Merch-Id
          in: header
          description: ''
          example: M24061911365700670
          schema:
            type: string
            default: M24061911365700670
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MerchVaGetV2Req'
            example: ''
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: object
                properties:
                  request_id:
                    type: string
                    description: 请求号，请求方系统内唯一
                    maxLength: 32
                    minLength: 1
                  type:
                    type: string
                    description: 账户类型 LOCAL-本地,SWIFT-全球
                    enum:
                      - LOCAL
                      - GLOBAL
                  country_code:
                    type: string
                    description: 收款国家，原样返回
                  currencies:
                    uniqueItems: true
                    type: array
                    description: 收款币种，原样返回
                    items:
                      type: string
                      description: >-
                        币种: EUR-欧元, USD-美元, CNY-人民币, GBP-英镑, JPY-日元, AUD-澳元,
                        CAD-加元, SGD-新加坡元, HKD-港币, PHP-菲律宾比索, THB-泰铢, CNH-离岸人民币
                      enum:
                        - EUR
                        - USD
                        - CNY
                        - GBP
                        - JPY
                        - AUD
                        - CAD
                        - SGD
                        - HKD
                        - PHP
                        - CNH
                  account_no:
                    maxLength: 20
                    minLength: 0
                    type: string
                    description: 收款账号(长度20字符)
                  status:
                    type: string
                    description: '账户状态: ENABLED-启用, PENDING-待审核, REJECTED-审核拒绝'
                    enum:
                      - ENABLED
                      - PENDING
                      - REJECTED
                  bank_name:
                    maxLength: 64
                    minLength: 0
                    type: string
                    description: 银行名称(长度64字符)
                  bank_address:
                    maxLength: 128
                    minLength: 0
                    type: string
                    description: 银行地址(长度128字符)
                  account_holder_name:
                    maxLength: 100
                    minLength: 0
                    type: string
                    description: 账户持有者(100字符)
                  bic_swift_code:
                    maxLength: 16
                    minLength: 0
                    type: string
                    description: bic/swift_code(长度16字符)
                  routing_number:
                    type: string
                    description: routing number/ach routing number/wire routing number三返一
                required:
                  - request_id
                  - type
                  - country_code
                  - currencies
                  - account_no
                  - status
                  - bank_name
                  - bank_address
                  - account_holder_name
                  - bic_swift_code
          headers: {}
        '400':
          description: Bad Request
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '401':
          description: Unauthorized
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '404':
          description: Not Found
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '429':
          description: Too Many Requests
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '500':
          description: Internal Server Error
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
      security: []
  /api/v2/merch/va/notify:
    post:
      summary: 收款账号开通结果(通知)
      deprecated: false
      description: 收款账号开通结果(通知)
      operationId: notification
      tags:
        - 收款账户
      parameters:
        - name: X-Merch-Id
          in: header
          description: ''
          example: M24061911365700670
          schema:
            type: string
            default: M24061911365700670
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                type:
                  type: string
                  description: >-
                    业务类型: MERCH-商户, VA-虚拟账户, INCOMING_REMITTANCE-汇入汇款,
                    CONTRACT_ORDER-合同订单, TRADE_SETTLE-解付入账, PAYEE-收款人,
                    WD_ACCOUNT-提现账户, CUR_EXCHANGE-换汇, PAYMENT-付款
                version:
                  type: string
                  description: 版本号(V1、V2、...)
                data:
                  type: object
                  properties:
                    request_id:
                      type: string
                      description: 请求号，请求方系统内唯一
                      minLength: 1
                      maxLength: 32
                    merch_id:
                      type: string
                      description: |
                        商户id
                      minLength: 1
                      maxLength: 20
                    status:
                      type: string
                      description: >-
                        账户状态: ENABLED-启用, DISABLED-禁用, PENDING-待审核,
                        REJECTED-审核拒绝
                    currencies:
                      type: array
                      items:
                        type: string
                      description: 收款币种，原样返回
                    country_code:
                      type: string
                      description: 收款国家，原样返回
                    type:
                      type: string
                      description: 账户类型 LOCAL-本地,SWIFT-全球
                    account_no:
                      type: string
                      description: 收款账号
                    bic_swift_code:
                      type: string
                      description: bic/swift_code
                    bank_name:
                      type: string
                      description: 银行名称
                    bank_address:
                      type: string
                      description: 银行地址
                    routing_number:
                      type: string
                      description: routing number/ach routing number/wire routing number三返一
                  required:
                    - merch_id
                    - request_id
                  description: 业务数据
              required:
                - type
                - data
                - version
            example:
              type: MERCH
              data:
                merch_id: example
                status: ENABLED
                currency:
                  - EUR
                country_code: example
                account_type: LOCAL
                account_no: example
                bic: example
                bank: example
                bank_name: example
                bank_address: example
                c_rsc_id: example
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties: {}
          headers: {}
        '400':
          description: Bad Request
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '401':
          description: Unauthorized
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '404':
          description: Not Found
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '429':
          description: Too Many Requests
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
        '500':
          description: Internal Server Error
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/响应'
          headers: {}
      security: []
components:
  schemas:
    CustomDecInfo:
      type: object
      properties:
        dec_method:
          type: string
          description: 申报方式:METHOD_1-未在海关报备或未纳入海关统计的电商交易订单 METHOD_2-按一般贸易方式在海关报关出口
        dec_no:
          type: string
          description: 报关单号(最长32字符)
          minLength: 0
          maxLength: 32
      required:
        - dec_method
    FxPair:
      type: object
      properties:
        sell_currency:
          type: string
          description: 卖出币种
        buy_currency:
          type: string
          description: 买入币种
        sell_amount:
          type: integer
          description: 卖出金额(币种最小单位)
        buy_amount:
          type: integer
          description: 买入金额(币种最小单位)
      required:
        - sell_currency
        - buy_currency
        - sell_amount
        - buy_amount
      description: 货币对
    AccountBalanceGetReq:
      type: object
      properties:
        currency:
          type: string
          description: >-
            币种: EUR-欧元, USD-美元, CNY-人民币, GBP-英镑, JPY-日元, AUD-澳元, CAD-加元,
            SGD-新加坡元, HKD-港币, PHP-菲律宾比索, THB-泰铢, CNH-离岸人民币
          enum:
            - EUR
            - USD
            - CNY
            - GBP
            - JPY
            - AUD
            - CAD
            - SGD
            - HKD
            - PHP
            - THB
            - CNH
    AddressDto:
      required:
        - province
        - city
        - address1
        - zipcode
      type: object
      properties:
        province:
          type: string
          description: 省份/州, 大陆传编码(见附件)
        city:
          maxLength: 50
          minLength: 0
          type: string
          description: 城市, 大陆传编码(见附件)
        zipcode:
          maxLength: 20
          minLength: 0
          type: string
          description: 邮编
        address1:
          maxLength: 50
          minLength: 0
          type: string
          description: 地址行1
        address2:
          type: string
          description: 地址行2
      description: 地址信息
    Authentication:
      type: object
      properties:
        authorized_agent:
          $ref: '#/components/schemas/AuthAgentStakeholder'
      description: 认证信息
    AvailableAmountQueryReq:
      required:
        - amount
        - currency
        - type
      type: object
      properties:
        amount:
          minimum: 1
          type: integer
          description: 金额：金额需放大 100 倍，不可以出现千位分隔符及小数点，如1020.50人民币，应填102050
          format: int64
        currency:
          type: string
          description: >-
            币种: EUR-欧元, USD-美元, CNY-人民币, GBP-英镑, JPY-日元, AUD-澳元, CAD-加元,
            SGD-新加坡元, HKD-港币, PHP-菲律宾比索, THB-泰铢, CNH-离岸人民币
          enum:
            - EUR
            - USD
            - CNY
            - GBP
            - JPY
            - AUD
            - CAD
            - SGD
            - HKD
            - PHP
            - THB
            - CNH
        type:
          type: string
          description: 付款目的 PAY-支付，WITHDRAW-提现
          enum:
            - PAY
            - WITHDRAW
    AvailableAmountQueryRes:
      required:
        - amount
        - currency
        - max_available_amount
        - min_payment_amount
        - type
      type: object
      properties:
        amount:
          type: integer
          description: 金额（原样返回）
          format: int64
        currency:
          type: string
          description: >-
            币种: EUR-欧元, USD-美元, CNY-人民币, GBP-英镑, JPY-日元, AUD-澳元, CAD-加元,
            SGD-新加坡元, HKD-港币, PHP-菲律宾比索, THB-泰铢, CNH-离岸人民币
          enum:
            - EUR
            - USD
            - CNY
            - GBP
            - JPY
            - AUD
            - CAD
            - SGD
            - HKD
            - PHP
            - THB
            - CNH
        max_available_amount:
          type: integer
          description: 最大可用付款金额，客户端可用于限制付款金额输入上限（金额放大 100 倍，不出现千位分隔符及小数点）
          format: int64
        min_payment_amount:
          type: integer
          description: 最小付款金额，客户端可用于限制付款金额输入下限（金额放大 100 倍，不出现千位分隔符及小数点）
          format: int64
        type:
          type: string
          description: 付款目的 PAY-支付，WITHDRAW-提现
          enum:
            - PAY
            - WITHDRAW
    BankAccInfo:
      required:
        - acc_name
        - acc_type
        - country
        - currency
      type: object
      properties:
        acc_holder_addr:
          maxLength: 100
          minLength: 0
          type: string
          description: 银行账户持有人地址(选填)(最长100字符)
        acc_name:
          maxLength: 100
          minLength: 1
          type: string
          description: 账户名称(最长100字符)
        acc_no:
          maxLength: 100
          minLength: 1
          type: string
          description: 银行账号，accNo和iban只需要填写一个
        acc_type:
          type: string
          description: '账户类型: PRIVATE-个人账户, COMPANY-企业对公'
          enum:
            - PRIVATE
            - COMPANY
        bank_addr:
          maxLength: 100
          minLength: 1
          type: string
          description: 开户银行详细地址(境外账户必填)(最长100字符)
        bank_head_office:
          maxLength: 100
          minLength: 0
          type: string
          description: 开户银行总行编码(境内账户必填)(最长100字符)
        bank_name:
          maxLength: 100
          minLength: 1
          type: string
          description: 开户银行名称(境外账户必填)(最长100字符)
        branch_bank:
          maxLength: 100
          minLength: 0
          type: string
          description: 开户银行分行编码(境内企业对公账户必填)(最长100字符)
        cert_no:
          maxLength: 100
          minLength: 0
          type: string
          description: 证件号码(境内个人账户必填)(最长100字符)
        cert_type:
          type: string
          description: 收款人证件类型（境内个人账户必填且为ID_CARD）：ID_CARD-身份证 PASSPORT-护照(境内账户没有该类型)
          enum:
            - ID_CARD
            - PASSPORT
        city:
          maxLength: 10
          minLength: 0
          type: string
          description: 开户银行所属城市(境内企业对公账户必填)(最长10字符)
        country:
          type: string
          description: 国家代码,使用ISO3166-2标准2位国家代码,非制裁国家（见附录）
        currency:
          type: string
          description: >-
            币种: EUR-欧元, USD-美元, CNY-人民币, GBP-英镑, JPY-日元, AUD-澳元, CAD-加元,
            SGD-新加坡元, HKD-港币, PHP-菲律宾比索, THB-泰铢, CNH-离岸人民币
          enum:
            - EUR
            - USD
            - CNY
            - GBP
            - JPY
            - AUD
            - CAD
            - SGD
            - HKD
            - PHP
            - THB
            - CNH
        district:
          maxLength: 10
          minLength: 0
          type: string
          description: 开户银行所属区(境内企业对公账户必填)(最长10字符)
        iban:
          maxLength: 100
          minLength: 1
          type: string
          description: 除英国的英镑及欧洲国家的欧元外，其它国家均不需要，accNo和iban只需要填写一个
        province:
          maxLength: 10
          minLength: 0
          type: string
          description: 开户银行所属省份(境内企业对公账户必填)(最长10字符)
        routing_number:
          maxLength: 100
          minLength: 1
          type: string
          description: 除美国（所有币种）和加拿大的加元除外，其他国家与地区均不需要上传该字段
        swift:
          maxLength: 11
          minLength: 8
          type: string
          description: 除中国的人民币不需要该字段，其它国家与地区均需要上传该字段
        uni_social_credit:
          maxLength: 100
          minLength: 0
          type: string
          description: 统一社会信用代码(境内对公账户必填)(最长100字符)
      description: 银行账户信息
    CnLicense:
      required:
        - busi_from
        - ent_name
        - ent_type
        - found_date
        - legal_rep_name
        - region
        - registered_capital
        - registered_currency
        - uni_social_credit
      type: object
      properties:
        address_info:
          $ref: '#/components/schemas/AddressDto'
        attachment_file_ids:
          type: array
          description: 其他附件
          items:
            type: integer
            description: 其他附件
            format: int32
        busi_end:
          type: string
          description: 大陆企业 经营日期(止), 和是否长期互斥必填二选一,都传默认长期
          format: date
        busi_from:
          type: string
          description: 大陆企业 经营日期(起)
          format: date
        ent_name:
          maxLength: 128
          minLength: 0
          type: string
          description: 企业名称(长度128个字符)
        ent_name_en:
          maxLength: 100
          minLength: 0
          type: string
          description: 企业英文名称(长度100个字符)
        ent_type:
          type: string
          description: >-
            企业类型: PERSONAL-个体工商户, OTHER-其它, ENTERPRISE-企业, GOV-政府及事业单位,
            SOCIAL-社会组织, PN-民办非企业
        found_date:
          type: string
          description: 成立日期
          format: date
        legal_rep_name:
          maxLength: 128
          minLength: 0
          type: string
          description: 大陆企业 法定代表人姓名
        license_file_id:
          type: integer
          description: 大陆企业 营业执照文件
          format: int32
        long_term:
          type: boolean
          description: 是否长期, 和企业经营截止日期互斥，都传默认长期
        region:
          maxLength: 2
          minLength: 0
          type: string
          description: 2位英文国家编码, 参考附录-国家地区代码
        registered_capital:
          type: number
          description: 注册资本, 标准币种单位-元, 两位小数
        registered_currency:
          maxLength: 3
          minLength: 0
          type: string
          description: 注册资本币种符号, 使用ISO-4217标准3位币种代码
        uni_social_credit:
          maxLength: 18
          minLength: 0
          type: string
          description: 大陆企业 统一社会信用代码
      description: 企业许可证信息(仅仅是展示)-大陆
    ContactPersonInfo:
      required:
        - email
        - phone
        - phone_prefix
      type: object
      properties:
        phone_prefix:
          maxLength: 5
          minLength: 0
          type: string
          description: 所属国家地区区号, 如：+86 或 +852
        phone:
          maxLength: 64
          minLength: 0
          type: string
          description: 联系人电话(长度64字符)
        email:
          maxLength: 64
          minLength: 0
          type: string
          description: 联系人邮箱(长度64字符)
      description: 联系人信息
    ContractOrderCreateReq:
      required:
        - amount
        - buyer_country
        - buyer_name
        - c_rsc_id
        - contract_attachment_ids
        - contract_id
        - currency
        - goods_info
        - invoice_attachment_ids
        - is_exchange_settle
        - logistics_info
        - order_time
      type: object
      properties:
        amount:
          type: integer
          description: 订单金额(金额放大100倍, 没有千分位)
          format: int64
        buyer_country:
          type: string
          description: 买家国家代码,使用ISO3166-2标准2位国家代码（见附录）
        buyer_name:
          maxLength: 128
          minLength: 1
          type: string
          description: 买家姓名(最长128字符)
        c_rsc_id:
          maxLength: 32
          minLength: 0
          type: string
          description: 客户侧资源id，请求方系统内唯一（长度32字符）
        contract_attachment_ids:
          maxItems: 10
          minItems: 1
          type: array
          description: 合同附件id-上传文件接口返回的id(最多10个文件)
          items:
            type: integer
            description: 合同附件id-上传文件接口返回的id(最多10个文件)
            format: int32
        contract_id:
          maxLength: 32
          minLength: 1
          type: string
          description: 合同编号(最长32字符)(只能为数字和字母)(商户下唯一)
        currency:
          type: string
          description: >-
            币种: EUR-欧元, USD-美元, CNY-人民币, GBP-英镑, JPY-日元, AUD-澳元, CAD-加元,
            SGD-新加坡元, HKD-港币, PHP-菲律宾比索, THB-泰铢, CNH-离岸人民币
          enum:
            - EUR
            - USD
            - CNY
            - GBP
            - JPY
            - AUD
            - CAD
            - SGD
            - HKD
            - PHP
            - THB
            - CNH
        goods_info:
          $ref: '#/components/schemas/GoodsInfo'
        invoice_attachment_ids:
          maxItems: 10
          minItems: 1
          type: array
          description: PI/CI/发票id-上传文件接口返回id(最多10个文件)
          items:
            type: integer
            description: PI/CI/发票id-上传文件接口返回id(最多10个文件)
            format: int32
        is_exchange_settle:
          type: boolean
          description: 是否需要结汇
        logistics_info:
          $ref: '#/components/schemas/LogisticsInfo'
        order_time:
          type: string
          description: '订单时间 格式: yyyy-MM-dd'
          format: date-time
        other_attachment_ids:
          type: array
          description: 其他附件id-上传文件接口返回的id
          items:
            type: integer
            description: 其他附件id-上传文件接口返回的id
            format: int32
        remark:
          maxLength: 128
          minLength: 0
          type: string
          description: 备注(长度128字符)
    ContractOrderGetReq:
      required:
        - c_rsc_id
      type: object
      properties:
        c_rsc_id:
          maxLength: 32
          minLength: 0
          type: string
          description: 客户侧资源id，请求方系统内唯一（长度32字符）
    ContractOrderNotification:
      required:
        - c_rsc_id
        - contract_order_id
        - merch_id
        - status
      type: object
      properties:
        c_rsc_id:
          type: string
          description: 客户侧资源id
        contract_order_id:
          type: string
          description: 合同订单编号
        merch_id:
          type: string
          description: 商户id
        reason:
          type: string
          description: 审核拒绝原因
        request_id:
          maxLength: 32
          minLength: 1
          type: string
          description: 新版接口客户侧资源id
        status:
          type: string
          description: 开放平台合同订单状态 PENDING-待审核 REJECT-未通过 PASS-已通过 ALL_RELATED-已收齐
          enum:
            - PENDING
            - REJECT
            - PASS
            - ALL_RELATED
      description: 通知消息内容
    ContractOrderUpdateReq:
      required:
        - amount
        - buyer_country
        - buyer_name
        - c_rsc_id
        - contract_attachment_ids
        - contract_id
        - currency
        - goods_info
        - invoice_attachment_ids
        - is_exchange_settle
        - logistics_info
        - order_time
      type: object
      properties:
        amount:
          type: integer
          description: 订单金额(金额放大100倍, 没有千分位)
          format: int64
        buyer_country:
          type: string
          description: 买家国家代码,使用ISO3166-2标准2位国家代码（见附录）
        buyer_name:
          maxLength: 128
          minLength: 1
          type: string
          description: 买家姓名(最长128字符)
        c_rsc_id:
          maxLength: 32
          minLength: 0
          type: string
          description: 客户侧资源id，请求方系统内唯一（长度32字符）
        contract_attachment_ids:
          maxItems: 10
          minItems: 1
          type: array
          description: 合同附件id-上传文件接口返回的id(最多10个文件)
          items:
            type: integer
            description: 合同附件id-上传文件接口返回的id(最多10个文件)
            format: int32
        contract_id:
          maxLength: 32
          minLength: 1
          type: string
          description: 合同编号(最长32字符)(只能为数字和字母)(商户下唯一)
        currency:
          type: string
          description: >-
            币种: EUR-欧元, USD-美元, CNY-人民币, GBP-英镑, JPY-日元, AUD-澳元, CAD-加元,
            SGD-新加坡元, HKD-港币, PHP-菲律宾比索, THB-泰铢, CNH-离岸人民币
          enum:
            - EUR
            - USD
            - CNY
            - GBP
            - JPY
            - AUD
            - CAD
            - SGD
            - HKD
            - PHP
            - THB
            - CNH
        goods_info:
          $ref: '#/components/schemas/GoodsInfo'
        invoice_attachment_ids:
          maxItems: 10
          minItems: 1
          type: array
          description: PI/CI/发票id-上传文件接口返回id(最多10个文件)
          items:
            type: integer
            description: PI/CI/发票id-上传文件接口返回id(最多10个文件)
            format: int32
        is_exchange_settle:
          type: boolean
          description: 是否需要结汇
        logistics_info:
          $ref: '#/components/schemas/LogisticsInfo'
        order_time:
          type: string
          description: '订单时间 格式: yyyy-MM-dd'
          format: date-time
        other_attachment_ids:
          type: array
          description: 其他附件id-上传文件接口返回的id
          items:
            type: integer
            description: 其他附件id-上传文件接口返回的id
            format: int32
        remark:
          maxLength: 128
          minLength: 0
          type: string
          description: 备注(长度128字符)
    EntBusiness:
      required:
        - employee_number
        - export_country
        - export_type
        - industry
        - trade_volume
      type: object
      properties:
        industry:
          type: integer
          description: 行业 数据字典 INDUSTRY(见附录)
          format: int32
        employee_number:
          type: string
          description: >-
            企业员工人数: FIRST_LEVEL:少于5人、SECOND_LEVEL:5-20人, THIRD_LEVEL:20-50人,
            FOURTH_LEVEL:50人以上
        address:
          $ref: '#/components/schemas/AddressDto'
        export_country:
          uniqueItems: true
          type: array
          description: 主要出口国家,数组,使用ISO3166-2标准2位国家/地区代码（见附录）
          items:
            type: string
            description: 主要出口国家,数组,使用ISO3166-2标准2位国家/地区代码（见附录）
        export_type:
          uniqueItems: true
          type: array
          description: 出口类型：SELF_SUPPORT-自营出口，EXPORT-委托出口，INTERNATIONAL-国际快速，OTHER-其他
          items:
            type: string
            description: 出口类型：SELF_SUPPORT-自营出口，EXPORT-委托出口，INTERNATIONAL-国际快速，OTHER-其他
        trade_volume:
          type: string
          description: >-
            月贸易额:
            FIRST_LEVEL(0-5万美元)、SECOND_LEVEL(5-10万美元)、THIRD_LEVEL(10-25万美元)、FOURTH_LEVEL(25-50万美元)、FIFTH_LEVEL(50-100万美元)、SIXTH_LEVEL(100万美元以上)
        website:
          maxLength: 200
          minLength: 0
          type: string
          description: 公司网站(字符长度200)
      description: 企业经营信息
    EntLicense:
      required:
        - br_expiry_date
        - br_file_id
        - br_no
        - busi_from
        - cr_expiry_date
        - cr_file_id
        - cr_issue_date
        - cr_no
        - ent_name
        - ent_type
        - found_date
        - legal_rep_name
        - license_file_id
        - region
        - registered_capital
        - registered_currency
        - uni_social_credit
      type: object
      properties:
        region:
          maxLength: 2
          minLength: 0
          type: string
          description: 2位英文国家编码, 参考附录-国家地区代码
        ent_name:
          maxLength: 128
          minLength: 0
          type: string
          description: 企业名称(长度128个字符)
        ent_name_en:
          maxLength: 200
          minLength: 0
          type: string
          description: 企业英文名称(长度100个字符)
        found_date:
          type: string
          description: 成立日期
          format: date
        registered_currency:
          maxLength: 3
          minLength: 0
          type: string
          description: 注册资本币种符号, 使用ISO-4217标准3位币种代码
        registered_capital:
          type: number
          description: 注册资本，单位标准币种, 两位小数，没有注册资金的填0; reigon为大陆企业则是元, 为香港企业则是港元, 为全球企业则是美元
        address:
          $ref: '#/components/schemas/AddressDto'
        legal_rep_name:
          maxLength: 128
          minLength: 0
          type: string
          description: region为大陆必填-大陆企业 法定代表人姓名
        license_file_id:
          type: integer
          description: region为大陆必填-大陆企业 营业执照文件
          format: int32
        ent_type:
          type: string
          description: >-
            region为大陆必填-企业类型: PERSONAL-个体工商户, OTHER-其它, ENTERPRISE-企业,
            GOV-政府及事业单位, SOCIAL-社会组织, PN-民办非企业
        uni_social_credit:
          maxLength: 18
          minLength: 0
          type: string
          description: region为大陆必填-大陆企业 统一社会信用代码
        busi_from:
          type: string
          description: region为大陆必填-大陆企业 经营日期(起)
          format: date
        busi_end:
          type: string
          description: region为大陆选填-大陆企业 经营日期(止), 和是否长期互斥必填二选一,都传默认长期
          format: date
        long_term:
          type: boolean
          description: region为大陆选填-是否长期, 和企业经营截止日期互斥，都传默认长期
        br_no:
          type: string
          description: region为香港必填-全球企业 登记证号码
        br_file_id:
          type: integer
          description: region为香港必填-全球企业 公司注册证书
          format: int32
        annual_return_file_id:
          type: integer
          description: region为香港选填-香港企业 周年申报表(和法团成立表二选一)
          format: int32
        incorporation_form_file_id:
          type: integer
          description: region为香港选填-香港企业 法团成立表(和周年申报表二选一)
          format: int32
        br_expiry_date:
          type: string
          description: region为香港必填-香港企业 届满日期:yyyy-MM-dd
          format: date
        cr_issue_date:
          type: string
          description: region为香港必填-香港企业 证明书发出日期:yyyy-MM-dd
          format: date
        company_article_file_id:
          type: integer
          description: region为非大陆选填-公司章程文件
          format: int32
        cr_file_id:
          type: integer
          description: region为非大陆必填-香港/全球企业公司注册证书
          format: int32
        cr_no:
          type: string
          description: region为非大陆必填-香港企业证明书编号/全球企业登记证号码
        share_structure_file_id:
          type: integer
          description: region为非大陆选填-全球企业 股权架构文件
          format: int32
        cr_expiry_date:
          type: string
          description: region为全球必填-全球企业 届满日期:yyyy-MM-dd
          format: date
        other_file_ids:
          type: array
          description: 其他附件
          items:
            type: integer
            description: 其他附件
            format: int32
      description: 企业许可证信息
    FileUploadResult:
      required:
        - file_id
      type: object
      properties:
        file_id:
          type: integer
          description: 文件标识符，接口文件字段按照该值传输
          format: int32
    HkLicense:
      required:
        - br_expiry_date
        - br_file_id
        - br_no
        - cr_file_id
        - cr_issue_date
        - cr_no
        - ent_name
        - ent_name_en
        - found_date
        - region
        - registered_capital
        - registered_currency
      type: object
      properties:
        address_info:
          $ref: '#/components/schemas/AddressDto'
        annual_return_file_id:
          type: integer
          description: 香港企业 周年申报表(和法团成立表二选一)
          format: int32
        attachment_file_ids:
          type: array
          description: 其他附件
          items:
            type: integer
            description: 其他附件
            format: int32
        br_expiry_date:
          type: string
          description: 香港企业 届满日期:yyyy-MM-dd
          format: date
        br_file_id:
          type: integer
          description: 全球企业 公司注册证书
          format: int32
        br_no:
          type: string
          description: 全球企业 登记证号码
        company_article_file_id:
          type: integer
          description: 公司章程文件
          format: int32
        cr_file_id:
          type: integer
          description: 香港企业 公司注册证书
          format: int32
        cr_issue_date:
          type: string
          description: 香港企业 证明书发出日期:yyyy-MM-dd
          format: date
        cr_no:
          type: string
          description: 香港企业 证明书编号
        ent_name:
          maxLength: 128
          minLength: 0
          type: string
          description: 企业名称(长度128个字符)
        ent_name_en:
          maxLength: 100
          minLength: 0
          type: string
          description: 企业英文名称(长度100个字符)
        found_date:
          type: string
          description: 成立日期
          format: date
        incorporation_form_file_id:
          type: integer
          description: 香港企业 法团成立表(和周年申报表二选一)
          format: int32
        region:
          maxLength: 2
          minLength: 0
          type: string
          description: 2位英文国家编码, 参考附录-国家地区代码
        registered_capital:
          type: number
          description: 注册资本，单位港元, 两位小数
        registered_currency:
          maxLength: 3
          minLength: 0
          type: string
          description: 注册资本币种符号, 使用ISO-4217标准3位币种代码
        share_structure_file_id:
          type: integer
          description: 全球企业 股权架构文件
          format: int32
      description: 企业许可证信息(仅仅是展示)-香港
    IdentityVerifyAddRes:
      required:
        - authorize_link
        - merch_id
      type: object
      properties:
        authorize_link:
          type: string
          description: 授权链接
          minLength: 0
          maxLength: 256
        merch_id:
          type: string
          description: 商户id
          minLength: 1
          maxLength: 20
    IntlLicense:
      required:
        - cr_expiry_date
        - cr_file_id
        - cr_no
        - ent_name
        - ent_name_en
        - found_date
        - region
        - registered_capital
        - registered_currency
      type: object
      properties:
        address_info:
          $ref: '#/components/schemas/AddressDto'
        attachment_file_ids:
          type: array
          description: 其他附件
          items:
            type: integer
            description: 其他附件
            format: int32
        company_article_file_id:
          type: integer
          description: 公司章程文件
          format: int32
        cr_expiry_date:
          type: string
          description: 全球企业 届满日期:yyyy-MM-dd
          format: date
        cr_file_id:
          type: integer
          description: 全球企业 企业注册证书
          format: int32
        cr_no:
          type: string
          description: 全球企业 登记证号码
        ent_name:
          maxLength: 128
          minLength: 0
          type: string
          description: 企业名称(长度128个字符)
        ent_name_en:
          maxLength: 100
          minLength: 0
          type: string
          description: 企业英文名称(长度100个字符)
        found_date:
          type: string
          description: 成立日期
          format: date
        region:
          maxLength: 2
          minLength: 0
          type: string
          description: 2位英文国家编码, 参考附录-国家地区代码
        registered_capital:
          type: number
          description: 注册资本，单位美元, 两位小数
        registered_currency:
          maxLength: 3
          minLength: 0
          type: string
          description: 注册资本币种符号, 使用ISO-4217标准3位币种代码
        share_structure_file_id:
          type: integer
          description: 全球企业 股权架构文件
          format: int32
      description: 企业许可证信息(仅仅是展示)-全球
    LogisticsSupplementReq:
      required:
        - c_rsc_id
        - destination
        - logistics_company_name
        - outbound_id
        - ship_date
        - shipped_file_ids
        - transport_mode
      type: object
      properties:
        c_rsc_id:
          maxLength: 32
          minLength: 0
          type: string
          description: 客户侧资源id，请求方系统内唯一（长度32字符）
        destination:
          type: string
          description: 目的地
        logistics_company_name:
          type: string
          description: 物流公司名称
        outbound_id:
          type: string
          description: 出境物流单号
        ship_date:
          type: string
          description: 发货日期
          format: date-time
        shipped_file_ids:
          maxItems: 10
          minItems: 1
          type: array
          description: 发货凭证文件ID列表
          items:
            type: integer
            description: 发货凭证文件ID列表
            format: int32
        transport_mode:
          type: string
          description: '运输方式: AIR-空运 SHIPPING-海运 EXPRESS-快递 LAND-陆运 POST-邮政 OTHER-其他'
          enum:
            - AIR
            - SHIPPING
            - EXPRESS
            - LAND
            - POST
            - OTHER
    MerchFeeRateDto:
      type: object
      properties:
        charge_type:
          type: string
          description: 收费方式：RATIO-比例，FIXED-金额，FIXED_RATIO-比例+金额
          enum:
            - RATIO
            - FIXED
            - FIXED_RATIO
        currency:
          type: string
          description: >-
            币种: EUR-欧元, USD-美元, CNY-人民币, GBP-英镑, JPY-日元, AUD-澳元, CAD-加元,
            SGD-新加坡元, HKD-港币, PHP-菲律宾比索, THB-泰铢, CNH-离岸人民币
          enum:
            - EUR
            - USD
            - CNY
            - GBP
            - JPY
            - AUD
            - CAD
            - SGD
            - HKD
            - PHP
            - THB
            - CNH
        effective_time:
          type: string
          description: 生效时间
          format: date-time
        fee_currency:
          type: string
          description: >-
            币种: EUR-欧元, USD-美元, CNY-人民币, GBP-英镑, JPY-日元, AUD-澳元, CAD-加元,
            SGD-新加坡元, HKD-港币, PHP-菲律宾比索, THB-泰铢, CNH-离岸人民币
          enum:
            - EUR
            - USD
            - CNY
            - GBP
            - JPY
            - AUD
            - CAD
            - SGD
            - HKD
            - PHP
            - THB
            - CNH
        fee_rate:
          type: number
          description: 对应费率(百分比)
        fee_rate_type:
          type: string
          description: 费率类型：PAY-付款费率，WITHDRAW-提现费率，RECV-首款费率
          enum:
            - PAY
            - WITHDRAW
            - RECV
        fixed_amount:
          type: integer
          description: 金额
          format: int64
        max_fee:
          type: integer
          description: 封顶手续费
          format: int64
        min_fee:
          type: integer
          description: 保底手续费
          format: int64
      description: 商户费率配置，数组
    MerchFeeRateRes:
      type: object
      properties:
        merch_fee_rate_dtos:
          type: array
          description: 商户费率配置，数组
          items:
            $ref: '#/components/schemas/MerchFeeRateDto'
    MerchOnboardApplyResultNotification:
      required:
        - c_rsc_id
        - merch_id
        - status
      type: object
      properties:
        c_rsc_id:
          type: string
          description: 客户侧资源id
        merch_id:
          type: string
          description: 商户id
        msg:
          type: string
          description: 结果说明
        request_id:
          maxLength: 32
          minLength: 1
          type: string
          description: 请求号，请求方系统内唯一
        status:
          type: string
          description: '身份认证状态: INIT-初始 WAIT-待审核 PASS-审核通过 REFUSED-审核未通过 AUTH_FAIL-授权取消'
          enum:
            - INIT
            - WAIT
            - PASS
            - REFUSED
            - AUTH_FAIL
      description: 通知消息内容
    MerchOnboardCreateReq:
      required:
        - business
        - contact_person
        - license
        - request_id
        - stakeholder_list
      type: object
      properties:
        request_id:
          maxLength: 32
          minLength: 1
          type: string
          description: 请求号，请求方系统内唯一
        contact_person:
          $ref: '#/components/schemas/ContactPersonInfo'
          description: 联系人信息
        license:
          type: object
          properties:
            region:
              maxLength: 2
              minLength: 0
              type: string
              description: 2位英文国家编码, 参考附录-国家地区代码
            ent_name:
              maxLength: 128
              minLength: 0
              type: string
              description: 企业名称(长度128个字符)
            ent_name_en:
              maxLength: 200
              minLength: 0
              type: string
              description: 企业英文名称(长度100个字符)
            found_date:
              type: string
              description: 成立日期
              format: date
            registered_currency:
              maxLength: 3
              minLength: 0
              type: string
              description: 注册资本币种符号, 使用ISO-4217标准3位币种代码
            registered_capital:
              type: number
              description: >-
                注册资本，单位标准币种, 两位小数，没有注册资金的填0; reigon为大陆企业则是元, 为香港企业则是港元,
                为全球企业则是美元
            address:
              $ref: '#/components/schemas/AddressDto'
            legal_rep_name:
              maxLength: 128
              minLength: 0
              type: string
              description: region为大陆必填-大陆企业 法定代表人姓名
            license_file_id:
              type: integer
              description: region为大陆必填-大陆企业 营业执照文件
              format: int32
            ent_type:
              type: string
              description: >-
                region为大陆必填-企业类型: PERSONAL-个体工商户, OTHER-其它, ENTERPRISE-企业,
                GOV-政府及事业单位, SOCIAL-社会组织, PN-民办非企业
            uni_social_credit:
              maxLength: 18
              minLength: 0
              type: string
              description: region为大陆必填-大陆企业 统一社会信用代码
            busi_from:
              type: string
              description: region为大陆必填-大陆企业 经营日期(起)
              format: date
            busi_end:
              type: string
              description: region为大陆选填-大陆企业 经营日期(止), 和是否长期互斥必填二选一,都传默认长期
              format: date
            long_term:
              type: boolean
              description: region为大陆选填-是否长期, 和企业经营截止日期互斥，都传默认长期
            br_no:
              type: string
              description: region为香港必填-全球企业 登记证号码
            br_file_id:
              type: integer
              description: region为香港必填-全球企业 公司注册证书
              format: int32
            annual_return_file_id:
              type: integer
              description: region为香港选填-香港企业 周年申报表(和法团成立表二选一)
              format: int32
            incorporation_form_file_id:
              type: integer
              description: region为香港选填-香港企业 法团成立表(和周年申报表二选一)
              format: int32
            br_expiry_date:
              type: string
              description: region为香港必填-香港企业 届满日期:yyyy-MM-dd
              format: date
            cr_issue_date:
              type: string
              description: region为香港必填-香港企业 证明书发出日期:yyyy-MM-dd
              format: date
            company_article_file_id:
              type: integer
              description: region为非大陆选填-公司章程文件
              format: int32
            cr_file_id:
              type: integer
              description: region为非大陆必填-香港/全球企业公司注册证书
              format: int32
            cr_no:
              type: string
              description: region为非大陆必填-香港企业证明书编号/全球企业登记证号码
            share_structure_file_id:
              type: integer
              description: region为非大陆选填-全球企业 股权架构文件
              format: int32
            cr_expiry_date:
              type: string
              description: region为全球必填-全球企业 届满日期:yyyy-MM-dd
              format: date
            other_file_ids:
              type: array
              description: 其他附件
              items:
                type: integer
                description: 其他附件
                format: int32
          description: 企业信息
          required:
            - region
            - ent_name
            - found_date
            - registered_currency
            - registered_capital
            - legal_rep_name
            - license_file_id
            - ent_type
            - uni_social_credit
            - busi_from
            - br_no
            - br_file_id
            - br_expiry_date
            - cr_issue_date
            - cr_file_id
            - cr_no
            - cr_expiry_date
        business:
          type: object
          properties:
            industry:
              type: integer
              description: 行业 数据字典 INDUSTRY(见附录)
              format: int32
            employee_number:
              type: string
              description: >-
                企业员工人数: FIRST_LEVEL:少于5人、SECOND_LEVEL:5-20人, THIRD_LEVEL:20-50人,
                FOURTH_LEVEL:50人以上
            address:
              $ref: '#/components/schemas/AddressDto'
            export_country:
              uniqueItems: true
              type: array
              description: 主要出口国家,数组,使用ISO3166-2标准2位国家/地区代码（见附录）
              items:
                type: string
                description: 主要出口国家,数组,使用ISO3166-2标准2位国家/地区代码（见附录）
            export_type:
              uniqueItems: true
              type: array
              description: 出口类型：SELF_SUPPORT-自营出口，EXPORT-委托出口，INTERNATIONAL-国际快速，OTHER-其他
              items:
                type: string
                description: 出口类型：SELF_SUPPORT-自营出口，EXPORT-委托出口，INTERNATIONAL-国际快速，OTHER-其他
            trade_volume:
              type: string
              description: >-
                月贸易额:
                FIRST_LEVEL(0-5万美元)、SECOND_LEVEL(5-10万美元)、THIRD_LEVEL(10-25万美元)、FOURTH_LEVEL(25-50万美元)、FIFTH_LEVEL(50-100万美元)、SIXTH_LEVEL(100万美元以上)
            website:
              maxLength: 200
              minLength: 0
              type: string
              description: 公司网站(字符长度200)
          description: 企业经营信息
          required:
            - industry
            - employee_number
            - export_country
            - export_type
            - trade_volume
        stakeholder_list:
          type: array
          description: 企业关联个人信息列表
          items:
            type: object
            properties:
              identity_type:
                type: string
                description: >-
                  身份类型：
                  LEGAL_PERSON-法人、BENEFICIARY-最终受益人、SHAREHOLDER-股东、DIRECTOR-董事
              name:
                maxLength: 128
                minLength: 0
                type: string
                description: 姓名(长度128字符)
              nationality:
                maxLength: 2
                minLength: 0
                type: string
                description: 国籍（ISO3166-2标准2位国家/地区代码）
              birth_date:
                type: string
                description: 生日, 格式yyyy-MM-dd，如 2023-12-12
                format: date
              address_proof_file_id:
                type: integer
                description: 地址证明文件, 非中国大陆身份证，地址证明文件必填
                format: int32
              doc_type:
                type: string
                description: >-
                  身份证类型
                  ID_CARD：二代居民身份证，HK_CARD：香港永久居住证，PASSPORT：护照，MO_CARD：澳门永久居住证，HK_MO_PASS：港澳居民来往内地通行证，TW_CARD：台湾居民来往大陆通行证
              id_number:
                maxLength: 18
                minLength: 0
                type: string
                description: 证件号码(长度18字符)
              doc_address:
                maxLength: 256
                minLength: 0
                type: string
                description: 证件详细地址(长度256字符), 大陆身份证必填
              doc_non_portrait_side_file_id:
                type: integer
                description: 证件反面文件, 除护照、台湾往来大陆通行证不需要提供，其他证件类型均需要提供
                format: int32
              doc_portrait_side_file_id:
                type: integer
                description: 证件正面文件
                format: int32
              eff_date_start:
                type: string
                description: 证件起始日期；格式yyyy-MM-dd，如 2023-12-12
                format: date
              eff_date_end:
                type: string
                description: 证件失效日期；格式yyyy-MM-dd，如 2023-12-12，和long_term二选一, 其它按日期格式上传
                format: date
              long_term:
                type: boolean
                description: 是否长期(大陆身份证件选填), 和eff_date_end二选一
              share:
                type: number
                description: 持股比例, 百分比, 51.12%传51.12, 最多两位小数, 最终受益人、股东必填
              resident_address:
                $ref: '#/components/schemas/AddressDto'
            required:
              - identity_type
              - name
              - birth_date
              - doc_type
              - id_number
              - doc_portrait_side_file_id
              - eff_date_start
        authentication:
          type: object
          properties:
            authorized_agent:
              type: object
              properties:
                name:
                  maxLength: 128
                  minLength: 0
                  type: string
                  description: 姓名(长度128字符)
                nationality:
                  maxLength: 2
                  minLength: 0
                  type: string
                  description: 国籍（ISO3166-2标准2位国家/地区代码）
                birth_date:
                  type: string
                  description: 生日, 格式yyyy-MM-dd，如 2023-12-12
                  format: date
                address_proof_file_id:
                  type: integer
                  description: 地址证明文件, 非中国大陆身份证，地址证明文件必填
                  format: int32
                doc_type:
                  type: string
                  description: >-
                    身份证类型
                    ID_CARD：二代居民身份证，HK_CARD：香港永久居住证，PASSPORT：护照，MO_CARD：澳门永久居住证，HK_MO_PASS：港澳居民来往内地通行证，TW_CARD：台湾居民来往大陆通行证
                id_number:
                  maxLength: 18
                  minLength: 0
                  type: string
                  description: 证件号码(长度18字符)
                doc_address:
                  maxLength: 256
                  minLength: 0
                  type: string
                  description: 证件详细地址(长度256字符), 大陆身份证必填
                doc_non_portrait_side_file_id:
                  type: integer
                  description: 证件反面文件, 除护照、台湾往来大陆通行证不需要提供，其他证件类型均需要提供
                  format: int32
                doc_portrait_side_file_id:
                  type: integer
                  description: 证件正面文件
                  format: int32
                eff_date_start:
                  type: string
                  description: 证件起始日期；格式yyyy-MM-dd，如 2023-12-12
                  format: date
                eff_date_end:
                  type: string
                  description: 证件失效日期；格式yyyy-MM-dd，如 2023-12-12，和long_term二选一, 其它按日期格式上传
                  format: date
                long_term:
                  type: boolean
                  description: 是否长期(大陆身份证件选填), 和eff_date_end二选一
                resident_address:
                  $ref: '#/components/schemas/AddressDto'
              required:
                - name
                - birth_date
                - doc_type
                - id_number
                - doc_portrait_side_file_id
                - eff_date_start
          description: 认证信息
    MerchOnboardInquiryReq:
      required:
        - request_id
      type: object
      properties:
        request_id:
          maxLength: 32
          minLength: 1
          type: string
          description: 请求号，请求方系统内唯一
    MerchOnboardUpdateReq:
      required:
        - business
        - contact_person
        - license
        - request_id
        - stakeholder_list
      type: object
      properties:
        request_id:
          maxLength: 32
          minLength: 1
          type: string
          description: 请求号，请求方系统内唯一
        contact_person:
          $ref: '#/components/schemas/ContactPersonInfo'
          description: 联系人信息
        license:
          type: object
          properties:
            region:
              maxLength: 2
              minLength: 0
              type: string
              description: 2位英文国家编码, 参考附录-国家地区代码
            ent_name:
              maxLength: 128
              minLength: 0
              type: string
              description: 企业名称(长度128个字符)
            ent_name_en:
              maxLength: 200
              minLength: 0
              type: string
              description: 企业英文名称(长度100个字符)
            found_date:
              type: string
              description: 成立日期
              format: date
            registered_currency:
              maxLength: 3
              minLength: 0
              type: string
              description: 注册资本币种符号, 使用ISO-4217标准3位币种代码
            registered_capital:
              type: number
              description: >-
                注册资本，单位标准币种, 两位小数，没有注册资金的填0; reigon为大陆企业则是元, 为香港企业则是港元,
                为全球企业则是美元
            address:
              $ref: '#/components/schemas/AddressDto'
            legal_rep_name:
              maxLength: 128
              minLength: 0
              type: string
              description: region为大陆必填-大陆企业 法定代表人姓名
            license_file_id:
              type: integer
              description: region为大陆必填-大陆企业 营业执照文件
              format: int32
            ent_type:
              type: string
              description: >-
                region为大陆必填-企业类型: PERSONAL-个体工商户, OTHER-其它, ENTERPRISE-企业,
                GOV-政府及事业单位, SOCIAL-社会组织, PN-民办非企业
            uni_social_credit:
              maxLength: 18
              minLength: 0
              type: string
              description: region为大陆必填-大陆企业 统一社会信用代码
            busi_from:
              type: string
              description: region为大陆必填-大陆企业 经营日期(起)
              format: date
            busi_end:
              type: string
              description: region为大陆选填-大陆企业 经营日期(止), 和是否长期互斥必填二选一,都传默认长期
              format: date
            long_term:
              type: boolean
              description: region为大陆选填-是否长期, 和企业经营截止日期互斥，都传默认长期
            br_no:
              type: string
              description: region为香港必填-全球企业 登记证号码
            br_file_id:
              type: integer
              description: region为香港必填-全球企业 公司注册证书
              format: int32
            annual_return_file_id:
              type: integer
              description: region为香港选填-香港企业 周年申报表(和法团成立表二选一)
              format: int32
            incorporation_form_file_id:
              type: integer
              description: region为香港选填-香港企业 法团成立表(和周年申报表二选一)
              format: int32
            br_expiry_date:
              type: string
              description: region为香港必填-香港企业 届满日期:yyyy-MM-dd
              format: date
            cr_issue_date:
              type: string
              description: region为香港必填-香港企业 证明书发出日期:yyyy-MM-dd
              format: date
            company_article_file_id:
              type: integer
              description: region为非大陆选填-公司章程文件
              format: int32
            cr_file_id:
              type: integer
              description: region为非大陆必填-香港/全球企业公司注册证书
              format: int32
            cr_no:
              type: string
              description: region为非大陆必填-香港企业证明书编号/全球企业登记证号码
            share_structure_file_id:
              type: integer
              description: region为非大陆选填-全球企业 股权架构文件
              format: int32
            cr_expiry_date:
              type: string
              description: region为全球必填-全球企业 届满日期:yyyy-MM-dd
              format: date
            other_file_ids:
              type: array
              description: 其他附件
              items:
                type: integer
                description: 其他附件
                format: int32
          description: 企业信息
          required:
            - region
            - ent_name
            - found_date
            - registered_currency
            - registered_capital
            - legal_rep_name
            - license_file_id
            - ent_type
            - uni_social_credit
            - busi_from
            - br_no
            - br_file_id
            - br_expiry_date
            - cr_issue_date
            - cr_file_id
            - cr_no
            - cr_expiry_date
        business:
          type: object
          properties:
            industry:
              type: integer
              description: 行业 数据字典 INDUSTRY(见附录)
              format: int32
            employee_number:
              type: string
              description: >-
                企业员工人数: FIRST_LEVEL:少于5人、SECOND_LEVEL:5-20人, THIRD_LEVEL:20-50人,
                FOURTH_LEVEL:50人以上
            address:
              $ref: '#/components/schemas/AddressDto'
            export_country:
              uniqueItems: true
              type: array
              description: 主要出口国家,数组,使用ISO3166-2标准2位国家/地区代码（见附录）
              items:
                type: string
                description: 主要出口国家,数组,使用ISO3166-2标准2位国家/地区代码（见附录）
            export_type:
              uniqueItems: true
              type: array
              description: 出口类型：SELF_SUPPORT-自营出口，EXPORT-委托出口，INTERNATIONAL-国际快速，OTHER-其他
              items:
                type: string
                description: 出口类型：SELF_SUPPORT-自营出口，EXPORT-委托出口，INTERNATIONAL-国际快速，OTHER-其他
            trade_volume:
              type: string
              description: >-
                月贸易额:
                FIRST_LEVEL(0-5万美元)、SECOND_LEVEL(5-10万美元)、THIRD_LEVEL(10-25万美元)、FOURTH_LEVEL(25-50万美元)、FIFTH_LEVEL(50-100万美元)、SIXTH_LEVEL(100万美元以上)
            website:
              maxLength: 200
              minLength: 0
              type: string
              description: 公司网站(字符长度200)
          description: 企业经营信息
          required:
            - industry
            - employee_number
            - export_country
            - export_type
            - trade_volume
        stakeholder_list:
          type: array
          description: 企业关联个人信息列表
          items:
            type: object
            properties:
              identity_type:
                type: string
                description: >-
                  身份类型：
                  LEGAL_PERSON-法人、BENEFICIARY-最终受益人、SHAREHOLDER-股东、DIRECTOR-董事
              name:
                maxLength: 128
                minLength: 0
                type: string
                description: 姓名(长度128字符)
              nationality:
                maxLength: 2
                minLength: 0
                type: string
                description: 国籍（ISO3166-2标准2位国家/地区代码）
              birth_date:
                type: string
                description: 生日, 格式yyyy-MM-dd，如 2023-12-12
                format: date
              address_proof_file_id:
                type: integer
                description: 地址证明文件, 非中国大陆身份证，地址证明文件必填
                format: int32
              doc_type:
                type: string
                description: >-
                  身份证类型
                  ID_CARD：二代居民身份证，HK_CARD：香港永久居住证，PASSPORT：护照，MO_CARD：澳门永久居住证，HK_MO_PASS：港澳居民来往内地通行证，TW_CARD：台湾居民来往大陆通行证
              id_number:
                maxLength: 18
                minLength: 0
                type: string
                description: 证件号码(长度18字符)
              doc_address:
                maxLength: 256
                minLength: 0
                type: string
                description: 证件详细地址(长度256字符), 大陆身份证必填
              doc_non_portrait_side_file_id:
                type: integer
                description: 证件反面文件, 除护照、台湾往来大陆通行证不需要提供，其他证件类型均需要提供
                format: int32
              doc_portrait_side_file_id:
                type: integer
                description: 证件正面文件
                format: int32
              eff_date_start:
                type: string
                description: 证件起始日期；格式yyyy-MM-dd，如 2023-12-12
                format: date
              eff_date_end:
                type: string
                description: 证件失效日期；格式yyyy-MM-dd，如 2023-12-12，和long_term二选一, 其它按日期格式上传
                format: date
              long_term:
                type: boolean
                description: 是否长期(大陆身份证件选填), 和eff_date_end二选一
              share:
                type: number
                description: 持股比例, 百分比, 51.12%传51.12, 最多两位小数, 受益人、董事必填
              resident_address:
                $ref: '#/components/schemas/AddressDto'
            required:
              - identity_type
              - name
              - birth_date
              - doc_type
              - id_number
              - doc_portrait_side_file_id
              - eff_date_start
        authentication:
          type: object
          properties:
            authorized_agent:
              type: object
              properties:
                name:
                  maxLength: 128
                  minLength: 0
                  type: string
                  description: 姓名(长度128字符)
                nationality:
                  maxLength: 2
                  minLength: 0
                  type: string
                  description: 国籍（ISO3166-2标准2位国家/地区代码）
                birth_date:
                  type: string
                  description: 生日, 格式yyyy-MM-dd，如 2023-12-12
                  format: date
                address_proof_file_id:
                  type: integer
                  description: 地址证明文件, 非中国大陆身份证，地址证明文件必填
                  format: int32
                doc_type:
                  type: string
                  description: >-
                    身份证类型
                    ID_CARD：二代居民身份证，HK_CARD：香港永久居住证，PASSPORT：护照，MO_CARD：澳门永久居住证，HK_MO_PASS：港澳居民来往内地通行证，TW_CARD：台湾居民来往大陆通行证
                id_number:
                  maxLength: 18
                  minLength: 0
                  type: string
                  description: 证件号码(长度18字符)
                doc_address:
                  maxLength: 256
                  minLength: 0
                  type: string
                  description: 证件详细地址(长度256字符), 大陆身份证必填
                doc_non_portrait_side_file_id:
                  type: integer
                  description: 证件反面文件, 除护照、台湾往来大陆通行证不需要提供，其他证件类型均需要提供
                  format: int32
                doc_portrait_side_file_id:
                  type: integer
                  description: 证件正面文件
                  format: int32
                eff_date_start:
                  type: string
                  description: 证件起始日期；格式yyyy-MM-dd，如 2023-12-12
                  format: date
                eff_date_end:
                  type: string
                  description: 证件失效日期；格式yyyy-MM-dd，如 2023-12-12，和long_term二选一, 其它按日期格式上传
                  format: date
                long_term:
                  type: boolean
                  description: 是否长期(大陆身份证件选填), 和eff_date_end二选一
                resident_address:
                  $ref: '#/components/schemas/AddressDto'
              required:
                - name
                - birth_date
                - doc_type
                - id_number
                - doc_portrait_side_file_id
                - eff_date_start
          description: 认证信息
    MerchPayeeNotification:
      required:
        - c_rsc_id
        - merch_id
        - payee_id
        - status
      type: object
      properties:
        c_rsc_id:
          type: string
          description: 客户侧资源id
        merch_id:
          type: string
          description: 商户id
        msg:
          type: string
          description: 结果说明，失败时不为空
        payee_id:
          type: string
          description: 收款人id
        request_id:
          maxLength: 32
          minLength: 1
          type: string
          description: 新版接口客户侧资源id
        status:
          type: string
          description: 付款人审核状态 PENDING-待审核 NORMAL-正常 REJECTED-审核未通过
          enum:
            - PENDING
            - NORMAL
            - REJECTED
      description: 通知消息内容
    MerchVaCreateReq:
      required:
        - account_type
        - area_code
        - c_rsc_id
        - remark_name
      type: object
      properties:
        account_type:
          type: string
          description: 账户类型 LOCAL-本地,GLOBAL-全球
          enum:
            - LOCAL
            - GLOBAL
        area_code:
          type: string
          description: 收款国家/地区,使用ISO3166-2标准2位国家/地区代码(全球账户目前只支持HK,本地账户支持的收款国家见附件)
        c_rsc_id:
          maxLength: 32
          minLength: 0
          type: string
          description: 客户侧资源id，请求方系统内唯一（长度32字符）
        remark_name:
          maxLength: 20
          minLength: 0
          type: string
          description: 账户备注名(长度20字符)
    MerchVaGetReq:
      required:
        - c_rsc_id
      type: object
      properties:
        c_rsc_id:
          maxLength: 32
          minLength: 0
          type: string
          description: 客户侧资源id，请求方系统内唯一（长度32字符）
    NotificationDtoContractOrderNotification:
      required:
        - data
        - type
      type: object
      properties:
        data:
          $ref: '#/components/schemas/ContractOrderNotification'
        type:
          type: string
          description: >-
            业务类型: MERCH-商户, VA-虚拟账户, INCOMING_REMITTANCE-汇入汇款,
            CONTRACT_ORDER-合同订单, TRADE_SETTLE-解付入账, PAYEE-收款人, WD_ACCOUNT-提现账户,
            CUR_EXCHANGE-换汇, PAYMENT-付款
          enum:
            - MERCH
            - VA
            - INCOMING_REMITTANCE
            - CONTRACT_ORDER
            - TRADE_SETTLE
            - PAYEE
            - WD_ACCOUNT
            - FOREX
            - PAYMENT
    NotificationDtoMerchOnboardApplyResultNotification:
      required:
        - data
        - type
      type: object
      properties:
        data:
          $ref: '#/components/schemas/MerchOnboardApplyResultNotification'
        type:
          type: string
          description: >-
            业务类型: MERCH-商户, VA-虚拟账户, INCOMING_REMITTANCE-汇入汇款,
            CONTRACT_ORDER-合同订单, TRADE_SETTLE-解付入账, PAYEE-收款人, WD_ACCOUNT-提现账户,
            CUR_EXCHANGE-换汇, PAYMENT-付款
          enum:
            - MERCH
            - VA
            - INCOMING_REMITTANCE
            - CONTRACT_ORDER
            - TRADE_SETTLE
            - PAYEE
            - WD_ACCOUNT
            - FOREX
            - PAYMENT
    NotificationDtoMerchPayeeNotification:
      required:
        - data
        - type
      type: object
      properties:
        data:
          $ref: '#/components/schemas/MerchPayeeNotification'
        type:
          type: string
          description: >-
            业务类型: MERCH-商户, VA-虚拟账户, INCOMING_REMITTANCE-汇入汇款,
            CONTRACT_ORDER-合同订单, TRADE_SETTLE-解付入账, PAYEE-收款人, WD_ACCOUNT-提现账户,
            CUR_EXCHANGE-换汇, PAYMENT-付款
          enum:
            - MERCH
            - VA
            - INCOMING_REMITTANCE
            - CONTRACT_ORDER
            - TRADE_SETTLE
            - PAYEE
            - WD_ACCOUNT
            - FOREX
            - PAYMENT
    NotificationDtoWithdrawalAccountNotification:
      required:
        - data
        - type
      type: object
      properties:
        data:
          $ref: '#/components/schemas/WithdrawalAccountNotification'
        type:
          type: string
          description: >-
            业务类型: MERCH-商户, VA-虚拟账户, INCOMING_REMITTANCE-汇入汇款,
            CONTRACT_ORDER-合同订单, TRADE_SETTLE-解付入账, PAYEE-收款人, WD_ACCOUNT-提现账户,
            CUR_EXCHANGE-换汇, PAYMENT-付款
          enum:
            - MERCH
            - VA
            - INCOMING_REMITTANCE
            - CONTRACT_ORDER
            - TRADE_SETTLE
            - PAYEE
            - WD_ACCOUNT
            - FOREX
            - PAYMENT
    OpenPlatformCommonReq:
      required:
        - c_rsc_id
      type: object
      properties:
        c_rsc_id:
          maxLength: 32
          minLength: 0
          type: string
          description: 客户侧资源id，请求方系统内唯一（长度32字符）
    PayeeCreateReq:
      required:
        - bank_acc_info
        - c_rsc_id
        - payee_info
      type: object
      properties:
        attachment_ids:
          maxItems: 7
          minItems: 0
          type: array
          description: 附件文件id 最多7个
          items:
            type: integer
            description: 附件文件id 最多7个
            format: int32
        bank_acc_info:
          $ref: '#/components/schemas/BankAccInfo'
        c_rsc_id:
          maxLength: 32
          minLength: 0
          type: string
          description: 客户侧资源id，请求方系统内唯一（长度32字符）
        contract_file_path_id:
          type: integer
          description: 合同文件-上传文件接口返回的id(合同/PI/物流文件必传其一)
          format: int32
        logistics_file_path_id:
          type: integer
          description: 物流文件-上传文件接口返回的id(合同/PI/物流文件必传其一)
          format: int32
        payee_info:
          $ref: '#/components/schemas/PayeeInfo'
        pi_file_path_id:
          type: integer
          description: PI文件id-上传文件接口返回的id(合同/PI/物流文件必传其一)
          format: int32
    PayeeGetReq:
      required:
        - c_rsc_id
      type: object
      properties:
        c_rsc_id:
          maxLength: 32
          minLength: 0
          type: string
          description: 客户侧资源id，请求方系统内唯一（长度32字符）
    PayeeGetRes:
      required:
        - payee_id
        - status
      type: object
      properties:
        msg:
          type: string
          description: 结果说明，失败时不为空
        payee_id:
          type: string
          description: 收款人id, 仅创建成功并审核通过后返回；付款时可通过指定收款人 id 发起付款
        status:
          type: string
          description: 付款人审核状态 PENDING-待审核 NORMAL-正常 REJECTED-审核未通过
          enum:
            - PENDING
            - NORMAL
            - REJECTED
    PayeeInfo:
      required:
        - country
        - payee_type
      type: object
      properties:
        country:
          type: string
          description: 国家代码,使用ISO3166-2标准2位国家代码,非制裁国家（见附录）
        email:
          maxLength: 100
          minLength: 0
          type: string
          description: 联系人邮箱(最长100字符)
        name:
          maxLength: 100
          minLength: 0
          type: string
          description: 联系人姓名(最长100字符)
        nick_name:
          maxLength: 100
          minLength: 0
          type: string
          description: 昵称(最长100字符)
        payee_first_name:
          maxLength: 100
          minLength: 1
          type: string
          description: 收款人first name(境外收款人必填)(最长100字符)
        payee_last_name:
          maxLength: 100
          minLength: 1
          type: string
          description: 收款人last name(境外收款人必填)(最长100字符)
        payee_name:
          maxLength: 100
          minLength: 1
          type: string
          description: 收款人姓名(境内收款人必填)(最长100字符)
        payee_type:
          type: string
          description: >-
            收款类型 PFG-货款 LWF-物流仓储费 ASF-广告服务费 TSF-技术服务费 CSF-咨询服务费 OTHER-其他
            数据字典:PAYEE_TYPE
          enum:
            - PFG
            - LWF
            - ASF
            - TSF
            - CSF
            - OTHER
        payee_type_desc:
          maxLength: 100
          minLength: 0
          type: string
          description: 收款类型说明,其他收款类型的时候需要填(最长100字符)
        phone:
          pattern: ^1[3-9]\d{9}$
          type: string
          description: 联系人电话(最长11位)
        website:
          maxLength: 100
          minLength: 0
          type: string
          description: 网站(最长100字符)
      description: 收款人信息
    PayeeUpdateReq:
      required:
        - bank_acc_info
        - c_rsc_id
        - payee_info
      type: object
      properties:
        attachment_ids:
          maxItems: 7
          minItems: 0
          type: array
          description: 附件文件id 最多7个
          items:
            type: integer
            description: 附件文件id 最多7个
            format: int32
        bank_acc_info:
          $ref: '#/components/schemas/BankAccInfo'
        c_rsc_id:
          maxLength: 32
          minLength: 0
          type: string
          description: 客户侧资源id，请求方系统内唯一（长度32字符）
        contract_file_path_id:
          type: integer
          description: 合同文件-上传文件接口返回的id(合同/PI/物流文件必传其一)
          format: int32
        logistics_file_path_id:
          type: integer
          description: 物流文件-上传文件接口返回的id(合同/PI/物流文件必传其一)
          format: int32
        payee_info:
          $ref: '#/components/schemas/PayeeInfo'
        pi_file_path_id:
          type: integer
          description: PI文件id-上传文件接口返回的id(合同/PI/物流文件必传其一)
          format: int32
    PaymentConfirmReq:
      required:
        - c_rsc_id
        - confirm_token
        - postscript
      type: object
      properties:
        c_rsc_id:
          maxLength: 32
          minLength: 0
          type: string
          description: 客户侧资源id，请求方系统内唯一（长度32字符）
        confirm_token:
          type: string
          description: 按照<预下单接口>返回原值上传
        postscript:
          maxLength: 64
          minLength: 0
          type: string
          description: 附言，银行打款备注（长度64字符）
    PaymentConfirmRes:
      required:
        - status
      type: object
      properties:
        status:
          type: string
          description: 支付状态：PROCESSING-处理中，SUCCEEDED-已处理，FAILED-失败
          enum:
            - PROCESSING
            - SUCCEEDED
            - FAILED
    PaymentPreorderReq:
      required:
        - amount
        - currency
        - target_id
        - to_account_type
        - type
      type: object
      properties:
        amount:
          minimum: 1
          type: integer
          description: 汇出（定额付）/收到（定额收）金额，金额需放大 100 倍，不可以出现千位分隔符及小数点，如1020.50人民币，应填102050
          format: int64
        currency:
          type: string
          description: >-
            币种: EUR-欧元, USD-美元, CNY-人民币, GBP-英镑, JPY-日元, AUD-澳元, CAD-加元,
            SGD-新加坡元, HKD-港币, PHP-菲律宾比索, THB-泰铢, CNH-离岸人民币
          enum:
            - EUR
            - USD
            - CNY
            - GBP
            - JPY
            - AUD
            - CAD
            - SGD
            - HKD
            - PHP
            - THB
            - CNH
        target_id:
          maxLength: 32
          minLength: 0
          type: string
          description: 付款目标id：当type=PAY时, 为收款人id; 当type=WITHDRAW时, 为提现账户id（长度32字符）
        to_account_type:
          type: string
          description: 付款方式：FIX_PAY-定额付，FIX_RECEIVE-定额收
          enum:
            - FIX_PAY
            - FIX_RECEIVE
        type:
          type: string
          description: 付款目的 PAY-支付，WITHDRAW-提现
          enum:
            - PAY
            - WITHDRAW
    PaymentPreorderRes:
      required:
        - confirm_token
        - exchange_rate
        - expire_time
        - fee_amount
        - payment_amount
        - payment_currency
        - receive_amount
        - receive_currency
        - to_account_type
        - type
      type: object
      properties:
        confirm_token:
          maxLength: 32
          minLength: 0
          type: string
          description: 付款确认token，若确认付款按该值上传
        exchange_rate:
          type: number
          description: 汇率（1付款货币=XXX到款货币, 保留6位小数）
        expire_time:
          type: string
          description: 付款确认token过期时间
          format: date-time
        fee_amount:
          type: integer
          description: 手续费(币种为付款货币)
          format: int64
        payment_amount:
          type: integer
          description: 付款金额（原样返回）
          format: int64
        payment_currency:
          type: string
          description: >-
            币种: EUR-欧元, USD-美元, CNY-人民币, GBP-英镑, JPY-日元, AUD-澳元, CAD-加元,
            SGD-新加坡元, HKD-港币, PHP-菲律宾比索, THB-泰铢, CNH-离岸人民币
          enum:
            - EUR
            - USD
            - CNY
            - GBP
            - JPY
            - AUD
            - CAD
            - SGD
            - HKD
            - PHP
            - THB
            - CNH
        receive_amount:
          type: integer
          description: 到款金额（收款方收到金额）
          format: int64
        receive_currency:
          type: string
          description: >-
            币种: EUR-欧元, USD-美元, CNY-人民币, GBP-英镑, JPY-日元, AUD-澳元, CAD-加元,
            SGD-新加坡元, HKD-港币, PHP-菲律宾比索, THB-泰铢, CNH-离岸人民币
          enum:
            - EUR
            - USD
            - CNY
            - GBP
            - JPY
            - AUD
            - CAD
            - SGD
            - HKD
            - PHP
            - THB
            - CNH
        to_account_type:
          type: string
          description: 付款方式：FIX_PAY-定额付，FIX_RECEIVE-定额收
          enum:
            - FIX_PAY
            - FIX_RECEIVE
        type:
          type: string
          description: 付款目的 PAY-支付，WITHDRAW-提现
          enum:
            - PAY
            - WITHDRAW
    WithdrawalAccountCreateReq:
      required:
        - acc_type
        - bank_card_no
        - bank_code
        - c_rsc_id
      type: object
      properties:
        acc_type:
          type: string
          description: '账户类型: PRIVATE-个人账户, COMPANY-企业对公'
          enum:
            - PRIVATE
            - COMPANY
        bank_card_no:
          type: string
          description: 银行卡号(商户下唯一)
        bank_code:
          type: string
          description: 银行编码(见附件银行编码)
        branch_bank_code:
          type: string
          description: 分行编码(见附件分行编码)
        c_rsc_id:
          maxLength: 32
          minLength: 0
          type: string
          description: 客户侧资源id，请求方系统内唯一（长度32字符）
        license_pic_path_id:
          type: integer
          description: 开户许可证图片id-上传文件接口返回的id
          format: int32
        phone:
          pattern: ^1[3-9]\d{9}$
          type: string
          description: 银行预留手机号(长度11位)
        proof_file_path_id:
          type: integer
          description: 开户流水账单图片id-上传文件接口返回的id
          format: int32
    WithdrawalAccountGetRes:
      required:
        - status
        - wdl_acc_id
      type: object
      properties:
        msg:
          type: string
          description: 结果说明，失败时不为空
        status:
          type: string
          description: '审核状态: UNDER_REVIEW-审核中 REFUSE-审核未通过 PASS-审核通过 PASS_UNUSED-审核通过未使用'
          enum:
            - UNDER_REVIEW
            - REFUSE
            - PASS
            - PASS_UNUSED
        wdl_acc_id:
          type: string
          description: 提现账户id
    WithdrawalAccountNotification:
      required:
        - c_rsc_id
        - merch_id
        - status
        - wdl_acc_id
      type: object
      properties:
        c_rsc_id:
          type: string
          description: 客户侧资源id
        merch_id:
          type: string
          description: 商户id
        msg:
          type: string
          description: 结果说明，失败时不为空
        request_id:
          maxLength: 32
          minLength: 1
          type: string
          description: 新版接口客户侧资源id
        status:
          type: string
          description: '审核状态: UNDER_REVIEW-审核中 REFUSE-审核未通过 PASS-审核通过 PASS_UNUSED-审核通过未使用'
          enum:
            - UNDER_REVIEW
            - REFUSE
            - PASS
            - PASS_UNUSED
        wdl_acc_id:
          type: string
          description: 提现账户id
      description: 通知消息内容
    WithdrawalAccountReq:
      required:
        - c_rsc_id
      type: object
      properties:
        c_rsc_id:
          maxLength: 32
          minLength: 0
          type: string
          description: 客户侧资源id，请求方系统内唯一（长度32字符）
    WithdrawalAccountRes:
      required:
        - status
      type: object
      properties:
        msg:
          type: string
          description: 结果说明，失败时不为空
        status:
          type: string
          description: '审核状态: UNDER_REVIEW-审核中 REFUSE-审核未通过 PASS-审核通过 PASS_UNUSED-审核通过未使用'
          enum:
            - UNDER_REVIEW
            - REFUSE
            - PASS
            - PASS_UNUSED
        wdl_acc_id:
          type: string
          description: 提现账户id
    WithdrawalAccountUpdateReq:
      required:
        - acc_type
        - bank_card_no
        - bank_code
        - c_rsc_id
      type: object
      properties:
        acc_type:
          type: string
          description: '账户类型: PRIVATE-个人账户, COMPANY-企业对公'
          enum:
            - PRIVATE
            - COMPANY
        bank_card_no:
          type: string
          description: 银行卡号(商户下唯一)
        bank_code:
          type: string
          description: 银行编码(见附件银行编码)
        branch_bank_code:
          type: string
          description: 分行编码(见附件分行编码)
        c_rsc_id:
          maxLength: 32
          minLength: 0
          type: string
          description: 客户侧资源id，请求方系统内唯一（长度32字符）
        license_pic_path_id:
          type: integer
          description: 开户许可证图片id-上传文件接口返回的id
          format: int32
        phone:
          pattern: ^1[3-9]\d{9}$
          type: string
          description: 银行预留手机号(长度11位)
        proof_file_path_id:
          type: integer
          description: 开户流水账单图片id-上传文件接口返回的id
          format: int32
    响应:
      required:
        - ret_code
        - ret_msg
      type: object
      properties:
        ret_code:
          type: string
          description: 代表请求处理的结果
        ret_msg:
          type: string
          description: 代表请求处理的结果消息
      description: 基础的响应
    MerchVaApplyResultNotification:
      required:
        - c_rsc_id
        - merch_id
      type: object
      properties:
        account_no:
          type: string
          description: 收款账号
        account_type:
          type: string
          description: 账户类型 LOCAL-本地,GLOBAL-全球
          enum:
            - LOCAL
            - GLOBAL
        ach_routing_number:
          type: string
          description: achRoutingNumber
        bank:
          type: string
          description: 银行
        bank_address:
          type: string
          description: 银行地址
        bank_name:
          type: string
          description: 银行名称
        bic:
          type: string
          description: bic/swift_code
        c_rsc_id:
          type: string
          description: 客户侧资源id
        country_code:
          type: string
          description: 收款国家，原样返回
        currency:
          uniqueItems: true
          type: array
          description: 收款币种，原样返回
          items:
            type: string
            description: >-
              币种: EUR-欧元, USD-美元, CNY-人民币, GBP-英镑, JPY-日元, AUD-澳元, CAD-加元,
              SGD-新加坡元, HKD-港币, PHP-菲律宾比索, THB-泰铢, CNH-离岸人民币
            enum:
              - EUR
              - USD
              - CNY
              - GBP
              - JPY
              - AUD
              - CAD
              - SGD
              - HKD
              - PHP
              - THB
              - CNH
        merch_id:
          type: string
          description: 商户id
        request_id:
          maxLength: 32
          minLength: 1
          type: string
          description: 新版接口客户侧资源id
        routing_number:
          type: string
          description: routingNumber
        status:
          type: string
          description: '账户状态: ENABLED-启用, DISABLED-禁用, PENDING-待审核, REJECTED-审核拒绝'
          enum:
            - ENABLED
            - DISABLED
            - PENDING
            - REJECTED
        wire_routing_number:
          type: string
          description: wireRoutingNumber
      description: 通知消息内容
    NotificationDtoMerchVaApplyResultNotification:
      required:
        - data
        - type
      type: object
      properties:
        data:
          $ref: '#/components/schemas/MerchVaApplyResultNotification'
        type:
          type: string
          description: >-
            业务类型: MERCH-商户, VA-虚拟账户, INCOMING_REMITTANCE-汇入汇款,
            CONTRACT_ORDER-合同订单, TRADE_SETTLE-解付入账, PAYEE-收款人, WD_ACCOUNT-提现账户,
            CUR_EXCHANGE-换汇, PAYMENT-付款
          enum:
            - MERCH
            - VA
            - INCOMING_REMITTANCE
            - CONTRACT_ORDER
            - TRADE_SETTLE
            - PAYEE
            - WD_ACCOUNT
            - FOREX
            - PAYMENT
    WdAccV2Info:
      required:
        - contact_phone_region
        - country
        - payee_type
      type: object
      properties:
        address:
          type: string
          description: 银行账户持有人地址(选填)
        cert_no:
          maxLength: 100
          minLength: 0
          type: string
          description: 证件号码(境内个人账户必填)(最长100字符)
        cert_type:
          type: string
          description: 收款人证件类型（境内个人账户必填）：ID_CARD-身份证 PASSPORT-护照
          enum:
            - ID_CARD
            - PASSPORT
        city:
          type: string
          description: 城市(境外必填)
        contact_email:
          maxLength: 100
          minLength: 0
          type: string
          description: 联系人邮箱(最长100字符)
        contact_name:
          maxLength: 100
          minLength: 0
          type: string
          description: 联系人姓名(最长100字符)
        contact_phone:
          pattern: ^1[3-9]\d{9}$
          type: string
          description: 联系人电话(最长11位)
        contact_phone_region:
          maxLength: 3
          minLength: 0
          type: string
          description: 冠码(长度不超过3个字符)
        country:
          type: string
          description: 国家代码,使用ISO3166-2标准2位国家代码,非制裁国家（见附录）
        nick_name:
          maxLength: 100
          minLength: 0
          type: string
          description: 昵称(最长100字符)
        payee_first_name:
          maxLength: 100
          minLength: 1
          type: string
          description: 收款人first name(境外收款人必填)(最长100字符)
        payee_last_name:
          maxLength: 100
          minLength: 1
          type: string
          description: 收款人last name(境外收款人必填)(最长100字符)
        payee_name:
          maxLength: 100
          minLength: 1
          type: string
          description: 收款人姓名(境内收款人必填)(最长100字符)
        payee_type:
          type: string
          description: >-
            收款类型 PFG-货款 LWF-物流仓储费 ASF-广告服务费 TSF-技术服务费 CSF-咨询服务费 OTHER-其他
            数据字典:PAYEE_TYPE
          enum:
            - PFG
            - LWF
            - ASF
            - TSF
            - CSF
            - OTHER
        payee_type_desc:
          maxLength: 100
          minLength: 0
          type: string
          description: 收款类型说明,其他收款类型的时候需要填(最长100字符)
        province:
          type: string
          description: 州/省(美国/加拿大/墨西哥必填)
        uni_social_credit:
          maxLength: 100
          minLength: 0
          type: string
          description: 统一社会信用代码(境内对公账户必填)(最长100字符)
        website:
          maxLength: 100
          minLength: 0
          type: string
          description: 网站(最长100字符)
        zip_code:
          type: string
          description: 邮编(境外必填)
      description: 提现账户信息
    WithdrawalAccountCreateV2Req:
      required:
        - request_id
      type: object
      properties:
        request_id:
          maxLength: 32
          minLength: 1
          type: string
          description: 请求号，请求方系统内唯一
        wd_acc_v2_info:
          $ref: '#/components/schemas/WdAccV2Info'
        bank_acc_v2_info:
          $ref: '#/components/schemas/BankAccV2Info'
        license_pic_path_id:
          type: integer
          description: 开户许可证图片id-上传文件接口返回的id
          format: int32
        proof_file_path_id:
          type: integer
          description: 开户流水账单图片id-上传文件接口返回的id
          format: int32
    WithdrawalAccountUpdateV2Req:
      required:
        - request_id
      type: object
      properties:
        bank_acc_v2_info:
          $ref: '#/components/schemas/BankAccV2Info'
        license_pic_path_id:
          type: integer
          description: 开户许可证图片id-上传文件接口返回的id
          format: int32
        proof_file_path_id:
          type: integer
          description: 开户流水账单图片id-上传文件接口返回的id
          format: int32
        request_id:
          maxLength: 32
          minLength: 1
          type: string
          description: 客户侧资源id，请求方系统内唯一（长度32字符）
        wd_acc_v2_info:
          $ref: '#/components/schemas/WdAccV2Info'
    ContractOrderGetV2Req:
      required:
        - request_id
      type: object
      properties:
        request_id:
          maxLength: 32
          minLength: 1
          type: string
          description: 请求号，请求方系统内唯一
    ContractOrderNotificationV2:
      required:
        - contract_order_id
        - merch_id
        - request_id
        - status
      type: object
      properties:
        request_id:
          maxLength: 32
          minLength: 1
          type: string
          description: 请求号，请求方系统内唯一
        merch_id:
          type: string
          description: 商户id
        contract_order_id:
          type: string
          description: 合同订单编号
        status:
          type: string
          description: 开放平台合同订单状态 PENDING-待审核 REJECT-未通过 PASS-已通过 ALL_RELATED-已收齐
          enum:
            - PENDING
            - REJECT
            - PASS
            - ALL_RELATED
        reason:
          type: string
          description: 审核拒绝原因
      description: 通知消息内容
    NotificationDtoContractOrderNotificationV2:
      required:
        - data
        - type
      type: object
      properties:
        type:
          type: string
          description: >-
            业务类型: MERCH-商户, VA-虚拟账户, INCOMING_REMITTANCE-汇入汇款,
            CONTRACT_ORDER-合同订单, TRADE_SETTLE-解付入账, PAYEE-收款人, WD_ACCOUNT-提现账户,
            CUR_EXCHANGE-换汇, PAYMENT-付款
          enum:
            - MERCH
            - VA
            - INCOMING_REMITTANCE
            - CONTRACT_ORDER
            - TRADE_SETTLE
            - PAYEE
            - WD_ACCOUNT
            - FOREX
            - PAYMENT
        data:
          $ref: '#/components/schemas/ContractOrderNotificationV2'
    OpenPlatformCommonV2Req:
      required:
        - request_id
      type: object
      properties:
        request_id:
          maxLength: 32
          minLength: 1
          type: string
          description: 请求号，请求方系统内唯一
    PaymentConfirmV2Req:
      required:
        - confirm_token
        - postscript
        - request_id
      type: object
      properties:
        request_id:
          maxLength: 32
          minLength: 1
          type: string
          description: 请求号，请求方系统内唯一
        confirm_token:
          type: string
          description: 按照<预下单接口>返回原值上传
        postscript:
          maxLength: 64
          minLength: 0
          type: string
          description: 附言，银行打款备注（长度64字符）
    MerchVaGetV2Req:
      required:
        - request_id
      type: object
      properties:
        request_id:
          maxLength: 32
          minLength: 1
          type: string
          description: 请求号，请求方系统内唯一
    IdentityVerifyStatusRes:
      required:
        - merch_id
        - status
      type: object
      properties:
        merch_id:
          type: string
          description: 商户id
          minLength: 1
          maxLength: 20
        status:
          type: string
          description: '身份认证状态: INIT-初始 WAIT-待审核 PASS-审核通过 REFUSED-审核未通过 AUTH_FAIL-授权取消'
          enum:
            - INIT
            - WAIT
            - PASS
            - REFUSED
            - AUTH_FAIL
        msg:
          type: string
          description: 结果说明，失败时不为空
    MerchOnboardApplyResultNotificationV2:
      required:
        - merch_id
        - request_id
        - status
      type: object
      properties:
        request_id:
          maxLength: 32
          minLength: 1
          type: string
          description: 请求号，请求方系统内唯一
        merch_id:
          type: string
          description: 商户id
          minLength: 0
          maxLength: 20
        status:
          type: string
          description: '身份认证状态: INIT-初始 WAIT-待审核 PASS-审核通过 REFUSED-审核未通过 AUTH_FAIL-授权取消'
          enum:
            - INIT
            - WAIT
            - PASS
            - REFUSED
            - AUTH_FAIL
        msg:
          type: string
          description: 结果说明
      description: 通知消息内容
    MerchVaCreateV2Req:
      required:
        - type
        - currency
        - region
        - request_id
        - remark_name
      type: object
      properties:
        request_id:
          maxLength: 32
          minLength: 1
          type: string
          description: 请求号，请求方系统内唯一
        region:
          type: string
          description: 收款国家/地区,使用ISO3166-2标准2位国家/地区代码(全球账户目前只支持HK,本地账户支持的收款国家见附件)
        type:
          type: string
          description: 账户类型 LOCAL-本地,SWIFT-全球
          enum:
            - LOCAL
            - SWIFT
        currency:
          type: string
          description: '收款账户币种类型, 单币种: 使用ISO-4217标准3位币种代码, 多币种: MUL'
        remark_name:
          type: string
          description: 收款账户备注名
          minLength: 1
          maxLength: 20
    MerchVaApplyRes:
      required:
        - account_no
        - type
        - bank_address
        - bank_name
        - bic_swift_code
        - request_id
        - country_code
        - currencies
        - account_holder_name
        - status
      type: object
      properties:
        request_id:
          type: string
          description: 请求号，请求方系统内唯一
          maxLength: 32
          minLength: 1
        type:
          type: string
          description: 账户类型 LOCAL-本地,SWIFT-全球
          enum:
            - LOCAL
            - GLOBAL
        country_code:
          type: string
          description: 收款国家，原样返回
        currencies:
          uniqueItems: true
          type: array
          description: 收款币种，原样返回
          items:
            type: string
            description: >-
              币种: EUR-欧元, USD-美元, CNY-人民币, GBP-英镑, JPY-日元, AUD-澳元, CAD-加元,
              SGD-新加坡元, HKD-港币, PHP-菲律宾比索, THB-泰铢, CNH-离岸人民币
            enum:
              - EUR
              - USD
              - CNY
              - GBP
              - JPY
              - AUD
              - CAD
              - SGD
              - HKD
              - PHP
              - CNH
        account_no:
          maxLength: 20
          minLength: 0
          type: string
          description: 收款账号(长度20字符)
        status:
          type: string
          description: '账户状态: ENABLED-启用, PENDING-待审核, REJECTED-审核拒绝'
          enum:
            - ENABLED
            - DISABLED
            - PENDING
            - REJECTED
        bank_name:
          maxLength: 64
          minLength: 0
          type: string
          description: 银行名称(长度64字符)
        bank_address:
          maxLength: 128
          minLength: 0
          type: string
          description: 银行地址(长度128字符)
        account_holder_name:
          maxLength: 100
          minLength: 0
          type: string
          description: 账户持有者(100字符)
        bic_swift_code:
          maxLength: 16
          minLength: 0
          type: string
          description: bic/swift_code(长度16字符)
        routing_number:
          type: string
          description: routing number/ach routing number/wire routing number三返一
    AttachmentInfos:
      type: object
      properties:
        other_file_ids:
          maxItems: 7
          minItems: 0
          type: array
          description: 附件文件id 最多7个
          items:
            type: integer
            description: 附件文件id 最多7个
            format: int32
        contract_file_id:
          type: integer
          description: 合同文件-上传文件接口返回的id(合同/PI/物流文件必传其一)
          format: int32
        logistics_file_id:
          type: integer
          description: 物流文件-上传文件接口返回的id(合同/PI/物流文件必传其一)
          format: int32
        pi_file_id:
          type: integer
          description: PI文件id-上传文件接口返回的id(合同/PI/物流文件必传其一)
          format: int32
      description: 材料、附件信息
    PayeeCreateV2Req:
      required:
        - bank_acc
        - beneficiary
        - type
        - request_id
      type: object
      properties:
        request_id:
          maxLength: 32
          minLength: 1
          type: string
          description: 请求号，请求方系统内唯一
        type:
          type: string
          description: '目的(必填): PAYMENT-收款、WITHDRAWAL-提现'
        beneficiary:
          type: object
          properties:
            purpose:
              type: string
              description: >-
                收款类型 PFG-货款 LWF-物流仓储费 ASF-广告服务费 TSF-技术服务费 CSF-咨询服务费 OTHER-其他
                数据字典:PAYEE_TYPE
              enum:
                - PFG
                - LWF
                - ASF
                - TSF
                - CSF
                - OTHER
            purpose_desc:
              maxLength: 100
              minLength: 0
              type: string
              description: 收款类型说明,其他收款类型的时候需要填(最长100字符)，purpose为OTHER时必填
            country:
              type: string
              description: 国家代码,使用ISO3166-2标准2位国家代码,非制裁国家(见附录)
            industry:
              type: integer
              description: 主营行业(见附件)，对公账户且为收款人时必填
              format: int32
            nick_name:
              maxLength: 100
              minLength: 0
              type: string
              description: 账户昵称(最长100字符)
            first_name:
              maxLength: 100
              minLength: 1
              type: string
              description: 受益人first name(境外收款人对私必填)(最长100字符)
            last_name:
              maxLength: 100
              minLength: 1
              type: string
              description: 受益人last name(境外收款人对私必填)(最长100字符)
            doc_type:
              type: string
              description: 证件类型(境内个人账户必填), 境内个人账户必填且为ID_CARD
            id_number:
              maxLength: 100
              minLength: 0
              type: string
              description: 证件号码(境内个人账户必填)(最长100字符)
            uni_social_credit:
              maxLength: 18
              minLength: 0
              type: string
              description: 统一社会信用代码(境内对公账户必填)(最长18字符)
            address:
              type: object
              properties:
                province:
                  type: string
                  description: 州/省(美国/加拿大/墨西哥且银行币种账户非CNY必填)
                city:
                  maxLength: 50
                  minLength: 0
                  type: string
                  description: 城市(境外必填)
                zipcode:
                  maxLength: 20
                  minLength: 0
                  type: string
                  description: 邮编(境外必填)
                address1:
                  maxLength: 50
                  minLength: 0
                  type: string
                  description: 银行账户持有人地址(境外必填)
                address2:
                  type: string
                  description: 地址行2
              description: 受益人地址信息
              required:
                - province
                - city
                - zipcode
                - address1
          description: 收款人信息
          required:
            - purpose
            - country
        bank_acc:
          description: 银行账户信息
          type: object
          properties:
            country:
              maxLength: 2
              minLength: 0
              type: string
              description: 国家代码,使用ISO3166-2标准2位国家代码,非制裁国家（见附录）
            currency:
              type: string
              description: >-
                币种: EUR-欧元, USD-美元, CNY-人民币, GBP-英镑, JPY-日元, AUD-澳元, CAD-加元,
                SGD-新加坡元, HKD-港币, PHP-菲律宾比索, THB-泰铢, CNH-离岸人民币
              enum:
                - EUR
                - USD
                - CNY
                - GBP
                - JPY
                - AUD
                - CAD
                - SGD
                - HKD
                - PHP
                - THB
                - CNH
            acc_name:
              maxLength: 100
              minLength: 1
              type: string
              description: 账户名称(最长100字符)
            acc_type:
              type: string
              description: '账户类型: PRIVATE-个人账户, COMPANY-企业对公'
              enum:
                - PRIVATE
                - COMPANY
            acc_no:
              maxLength: 100
              minLength: 0
              type: string
              description: 银行账号，accNo和iban二选一
            payment_type:
              type: string
              description: 支付清算网络：LOCAL-本地支付，SWIFT-国际支付
              enum:
                - LOCAL
                - SWIFT
            routing_code_type1:
              type: string
              description: >-
                LOCAL清算网络时必须(随业务发展后会扩展枚举值）：ABA、SORT_CODE、BANK_CODE(境内详见银行编码附件，境外如加拿大如实填写)
            routing_code_value1:
              type: string
              description: routingCodeType1不为空时必须
            routing_code_type2:
              type: string
              description: >-
                LOCAL清算网络子类型(随业务发展后会扩展枚举值）：BRANCH_BANK_CODE(境内详见银行编码附件，境外如加拿大如实填写)
            routing_code_value2:
              type: string
              description: routingCodeType2不为空时必须
            iban:
              maxLength: 50
              minLength: 0
              type: string
              description: IBAN，欧元区账户特有，accNo和iban二选一
            bic_swift:
              type: string
              description: swift code或bic，SWIFT清算网络时其它国家与地区均需要上传该字段(只支持8位或11位)
              maxLength: 11
              minLength: 8
              examples:
                - string
            bank_acc_type:
              type: string
              description: 银行账户类型 CHECKING-支票 SAVINGS-储蓄卡
              enum:
                - CHECKING
                - SAVINGS
            bank_addr:
              maxLength: 100
              minLength: 0
              type: string
              description: 开户银行详细地址(境外账户必填)(最长100字符)
            bank_name:
              maxLength: 100
              minLength: 0
              type: string
              description: 开户银行名称(境外账户必填; 最长100字符)
            branch_bank_name:
              maxLength: 100
              minLength: 0
              type: string
              description: 开户银行支行名称(最长100字符)
            phone:
              type: string
              description: 银行预留手机号(大陆人民币对私提现)
              maxLength: 11
              minLength: 11
              examples:
                - string
            province:
              maxLength: 10
              minLength: 0
              type: string
              description: 开户银行所属省份(境内企业对公账户必填, 见附件)
            city:
              maxLength: 10
              minLength: 0
              type: string
              description: 开户银行所属城市(境内企业对公账户必填, 见附件)
            district:
              maxLength: 10
              minLength: 0
              type: string
              description: 开户银行所属区(境内企业对公账户必填, 见附件)
          required:
            - country
            - currency
            - acc_name
            - acc_type
            - payment_type
        attachment:
          description: 其他文件附件
          type: object
          properties:
            other_file_ids:
              maxItems: 7
              minItems: 0
              type: array
              description: 附件文件id 最多7个
              items:
                type: integer
                description: 附件文件id 最多7个
                format: int32
            contract_file_id:
              type: integer
              description: 合同文件-上传文件接口返回的id(合同/PI/物流文件必传其一)
              format: int32
            logistics_file_id:
              type: integer
              description: 物流文件-上传文件接口返回的id(合同/PI/物流文件必传其一)
              format: int32
            pi_file_id:
              type: integer
              description: PI文件id-上传文件接口返回的id(合同/PI/物流文件必传其一)
              format: int32
    PayeeV2Info:
      required:
        - country
        - purpose
      type: object
      properties:
        purpose:
          type: string
          description: >-
            收款类型 PFG-货款 LWF-物流仓储费 ASF-广告服务费 TSF-技术服务费 CSF-咨询服务费 OTHER-其他
            数据字典:PAYEE_TYPE
          enum:
            - PFG
            - LWF
            - ASF
            - TSF
            - CSF
            - OTHER
        purpose_desc:
          maxLength: 100
          minLength: 0
          type: string
          description: 收款类型说明,其他收款类型的时候需要填(最长100字符)，purpose为OTHER时必填
        country:
          type: string
          description: 国家代码,使用ISO3166-2标准2位国家代码,非制裁国家(见附录)
        industry:
          type: integer
          description: 主营行业(见附件)，对公账户且为收款人时必填
          format: int32
        nick_name:
          maxLength: 100
          minLength: 0
          type: string
          description: 账户昵称(最长100字符)
        first_name:
          maxLength: 100
          minLength: 1
          type: string
          description: 受益人first name(境外收款人对私必填)(最长100字符)
        last_name:
          maxLength: 100
          minLength: 1
          type: string
          description: 受益人last name(境外收款人对私必填)(最长100字符)
        doc_type:
          type: string
          description: 证件类型(境内个人账户必填), 境内个人账户必填且为ID_CARD
        id_number:
          maxLength: 100
          minLength: 0
          type: string
          description: 证件号码(境内个人账户必填)(最长100字符)
        uni_social_credit:
          maxLength: 18
          minLength: 0
          type: string
          description: 统一社会信用代码(境内对公账户必填)(最长18字符)
        address:
          type: object
          properties:
            province:
              type: string
              description: 州/省(美国/加拿大/墨西哥且银行币种账户非CNY必填)
            city:
              maxLength: 50
              minLength: 0
              type: string
              description: 城市(境外必填)
            zipcode:
              maxLength: 20
              minLength: 0
              type: string
              description: 邮编(境外必填)
            address1:
              maxLength: 50
              minLength: 0
              type: string
              description: 银行账户持有人地址(境外必填)
            address2:
              type: string
              description: 地址行2
          required:
            - province
            - city
            - address1
            - zipcode
          description: 受益人地址信息
      description: 收款人信息
    PayeeRes:
      required:
        - status
      type: object
      properties:
        msg:
          type: string
          description: 结果说明，失败时不为空
        payee_id:
          type: string
          description: 收款人id, 仅创建成功并审核通过后返回；付款时可通过指定收款人 id 发起付款
          minLength: 0
          maxLength: 20
        status:
          type: string
          description: 付款人审核状态 PENDING-待审核 NORMAL-正常 REJECTED-审核未通过
          enum:
            - PENDING
            - NORMAL
            - REJECTED
    PayeeUpdateV2Req:
      required:
        - bank_acc
        - beneficiary
        - type
        - request_id
      type: object
      properties:
        request_id:
          maxLength: 32
          minLength: 1
          type: string
          description: 请求号，请求方系统内唯一
        type:
          type: string
          description: '目的(必填): PAYMENT-收款、WITHDRAWAL-提现'
        beneficiary:
          $ref: '#/components/schemas/PayeeV2Info'
        bank_acc:
          $ref: '#/components/schemas/BankAccV2Info'
        attachment:
          $ref: '#/components/schemas/AttachmentInfos'
    MerchPayeeNotificationV2:
      required:
        - merch_id
        - payee_id
        - type
        - request_id
        - status
      type: object
      properties:
        request_id:
          maxLength: 32
          minLength: 1
          type: string
          description: 请求号，请求方系统内唯一
        merch_id:
          type: string
          description: 商户id
          minLength: 1
          maxLength: 20
        type:
          type: string
          description: '目的(必填): PAYMENT-收款、WITHDRAWAL-提现'
        payee_id:
          type: string
          description: 收款人id
          minLength: 1
          maxLength: 20
        status:
          type: string
          description: 付款人审核状态 PENDING-待审核 NORMAL-正常 REJECTED-审核未通过
          enum:
            - PENDING
            - NORMAL
            - REJECTED
        msg:
          type: string
          description: 结果说明，失败时不为空
      description: 通知消息内容
    Account:
      required:
        - balance
        - currency
      type: object
      properties:
        balance:
          type: integer
          description: 余额(币种最小单位)
          format: int64
        currency:
          type: string
          description: >-
            币种: EUR-欧元, USD-美元, CNY-人民币, GBP-英镑, JPY-日元, AUD-澳元, CAD-加元,
            SGD-新加坡元, HKD-港币, PHP-菲律宾比索, CNH-离岸人民币
          enum:
            - EUR
            - USD
            - CNY
            - GBP
            - JPY
            - AUD
            - CAD
            - SGD
            - HKD
            - PHP
            - CNH
      description: 列表
    IncomingRemittanceNotification:
      required:
        - amount
        - currency
        - order_no
        - merch_id
        - recv_account
        - recv_time
      type: object
      properties:
        merch_id:
          type: string
          description: 收款商户id
          minLength: 1
          maxLength: 20
        order_no:
          type: string
          description: paykka收款单号
        amount:
          type: integer
          description: 汇入汇款金额, 最小币种单位
          format: int64
        currency:
          type: string
          description: >-
            币种: EUR-欧元, USD-美元, CNY-人民币, GBP-英镑, JPY-日元, AUD-澳元, CAD-加元,
            SGD-新加坡元, HKD-港币, PHP-菲律宾比索, THB-泰铢, CNH-离岸人民币
          enum:
            - EUR
            - USD
            - CNY
            - GBP
            - JPY
            - AUD
            - CAD
            - SGD
            - HKD
            - PHP
            - THB
            - CNH
        payer:
          type: string
          description: 付款人
        payment_account:
          type: string
          description: 付款账号
        payer_bank_bic:
          type: string
          description: 付款银行BIC
        payer_bank_name:
          type: string
          description: 付款人银行名称
        payee:
          type: string
          description: 收款人
        recv_account:
          type: string
          description: 收款账号
        recv_time:
          type: string
          description: 收款时间
          format: date-time
        remark:
          type: string
          description: 附言
      description: 通知消息内容
    NotificationDtoIncomingRemittanceNotification:
      required:
        - data
        - type
        - version
      type: object
      properties:
        type:
          type: string
          description: >-
            业务类型: MERCH-商户, VA-虚拟账户, INCOMING_REMITTANCE-汇入汇款,
            CONTRACT_ORDER-合同订单, TRADE_SETTLE-解付入账, PAYEE-收款人, WD_ACCOUNT-提现账户,
            CUR_EXCHANGE-换汇, PAYMENT-付款
          enum:
            - MERCH
            - VA
            - INCOMING_REMITTANCE
            - CONTRACT_ORDER
            - TRADE_SETTLE
            - PAYEE
            - WD_ACCOUNT
            - FOREX
            - PAYMENT
        version:
          type: string
          description: 版本号(V1、V2、...)
        data:
          type: object
          properties:
            merch_id:
              type: string
              description: 收款商户id
              minLength: 1
              maxLength: 20
            order_no:
              type: string
              description: paykka收款单号
            amount:
              type: integer
              description: 汇入汇款金额, 最小币种单位
              format: int64
            currency:
              type: string
              description: >-
                币种: EUR-欧元, USD-美元, CNY-人民币, GBP-英镑, JPY-日元, AUD-澳元, CAD-加元,
                SGD-新加坡元, HKD-港币, PHP-菲律宾比索, CNH-离岸人民币
              enum:
                - EUR
                - USD
                - CNY
                - GBP
                - JPY
                - AUD
                - CAD
                - SGD
                - HKD
                - PHP
                - CNH
            payer:
              type: string
              description: 付款人
            payment_account:
              type: string
              description: 付款账号
            payer_bank_bic:
              type: string
              description: 付款银行BIC
            payer_bank_name:
              type: string
              description: 付款人银行名称
            payee:
              type: string
              description: 收款人
            recv_account:
              type: string
              description: 收款账号
            recv_time:
              type: string
              description: 收款时间
              format: date-time
            remark:
              type: string
              description: 附言
          required:
            - merch_id
            - order_no
            - amount
            - currency
            - recv_account
            - recv_time
    GoodsInfo:
      required:
        - category
        - name
        - custom_dec_info
        - url
      type: object
      properties:
        category:
          type: integer
          description: 商品分类(支持的商品品类见附件)
          format: int32
        name:
          maxLength: 128
          minLength: 1
          type: string
          description: 商品名称(最长128字符)
        quantity:
          type: integer
          description: 商品数量
          format: int64
        url:
          type: string
          description: 商品网址
          maxLength: 256
          minLength: 1
        custom_dec_info:
          type: object
          properties:
            dec_method:
              type: string
              description: 申报方式:METHOD_1-未在海关报备或未纳入海关统计的电商交易订单 METHOD_2-按一般贸易方式在海关报关出口
            dec_no:
              type: string
              description: 报关单号(最长32字符)
              minLength: 0
              maxLength: 32
          required:
            - dec_method
          description: 报关信息
      description: 商品信息
    ContractOrderCreateV2Req:
      required:
        - amount
        - buyer_country
        - buyer_name
        - contract_file_ids
        - contract_no
        - currency
        - goods_info
        - invoice_file_ids
        - is_exchange_settle
        - logistics_info
        - order_date
        - request_id
      type: object
      properties:
        request_id:
          maxLength: 32
          minLength: 1
          type: string
          description: 请求号，请求方系统内唯一
        buyer_country:
          type: string
          description: 买家国家代码,使用ISO3166-2标准2位国家代码(见附录)
        buyer_name:
          maxLength: 128
          minLength: 1
          type: string
          description: 买家姓名(最长128字符)
        amount:
          type: integer
          description: 订单金额(币种最小单位)
          format: int64
        currency:
          type: string
          description: >-
            币种: EUR-欧元, USD-美元, CNY-人民币, GBP-英镑, JPY-日元, AUD-澳元, CAD-加元,
            SGD-新加坡元, HKD-港币, PHP-菲律宾比索, CNH-离岸人民币
          enum:
            - EUR
            - USD
            - CNY
            - GBP
            - JPY
            - AUD
            - CAD
            - SGD
            - HKD
            - PHP
            - CNH
        contract_no:
          maxLength: 32
          minLength: 1
          type: string
          description: 合同编号(最长32字符)(只能为数字和字母)(商户下唯一)
        contract_file_ids:
          maxItems: 10
          minItems: 1
          type: array
          description: 合同附件id-上传文件接口返回的id(最多10个文件)
          items:
            type: integer
            description: 合同附件id-上传文件接口返回的id(最多10个文件)
            format: int32
        goods_info:
          type: object
          properties:
            category:
              type: integer
              description: 商品分类(支持的商品品类见附件)
              format: int32
            name:
              maxLength: 128
              minLength: 1
              type: string
              description: 商品名称(最长128字符)
            quantity:
              type: integer
              description: 商品数量
              format: int64
            url:
              type: string
              description: 商品网址
              maxLength: 256
              minLength: 1
            custom_dec_info:
              type: object
              properties:
                dec_method:
                  type: string
                  description: 申报方式:METHOD_1-未在海关报备或未纳入海关统计的电商交易订单 METHOD_2-按一般贸易方式在海关报关出口
                dec_no:
                  type: string
                  description: 报关单号(最长32字符)
                  minLength: 0
                  maxLength: 32
              required:
                - dec_method
              description: 报关信息
          description: 商品信息
          required:
            - category
            - name
            - url
            - custom_dec_info
        invoice_file_ids:
          maxItems: 10
          minItems: 1
          type: array
          description: PI/CI/发票id-上传文件接口返回id(最多10个文件)
          items:
            type: integer
            description: PI/CI/发票id-上传文件接口返回id(最多10个文件)
            format: int32
        is_exchange_settle:
          type: boolean
          description: 是否需要结汇
        logistics_info:
          $ref: '#/components/schemas/LogisticsInfo'
        order_date:
          type: string
          description: '订单时间 格式: yyyy-MM-dd'
          format: date
        remark:
          maxLength: 128
          minLength: 0
          type: string
          description: 备注(长度128字符)
        other_file_ids:
          type: array
          description: 其他附件id-上传文件接口返回的id
          items:
            type: integer
            description: 其他附件id-上传文件接口返回的id
            format: int32
    LogisticsInfo:
      required:
        - ship_status
        - transaction_type
      type: object
      properties:
        buyer_type:
          type: string
          description: NEW-新买家;OLD-老买家
          enum:
            - NEW
            - OLD
        destination:
          maxLength: 256
          minLength: 1
          type: string
          description: 目的地 已发货时必传(最长256字符)
        expected_ship_date:
          type: string
          description: 预期发货日期 未发货时必传 格式:yyyy-MM-dd
          format: date-time
        freight_arrange_file_ids:
          maxItems: 10
          minItems: 1
          type: array
          description: 货运安排沟通记录id-上传文件接口返回id (最多10个文件)
          items:
            type: integer
            description: 货运安排沟通记录id-上传文件接口返回id 物流状态=UNSHIPPED时必传(最多10个文件)
            format: int32
        latest_order_file_ids:
          maxItems: 10
          minItems: 1
          type: array
          description: 商户与该买家最近一笔交易的报关单或出境物流凭证id-上传文件接口返回id 老买家时必传(最多10个文件)
          items:
            type: integer
            description: 商户与该买家最近一笔交易的报关单或出境物流凭证id-上传文件接口返回id 老买家时必传(最多10个文件)
            format: int32
        logistics_company_name:
          maxLength: 256
          minLength: 1
          type: string
          description: 物流公司名称 已发货时必传(最长256字符)
        outbound_no:
          maxLength: 32
          minLength: 1
          type: string
          description: 出境物流单号 已发货时必传((最长32字符)
        inquiry_records_file_ids:
          maxItems: 10
          minItems: 1
          type: array
          description: 询盘下单沟通记录-上传文件接口返回的id (最多10个文件)
          items:
            type: integer
            description: 询盘下单沟通记录-上传文件接口返回的id 物流状态=UNSHIPPED时必传(最多10个文件)
            format: int32
        ship_date:
          type: string
          description: 发货日期 已发货时必传 格式:yyyy-MM-dd
          format: date-time
        ship_status:
          type: string
          description: '物流状态: SHIPPED-已发货 UNSHIPPED-未发货'
          enum:
            - SHIPPED
            - UNSHIPPED
        shipped_file_ids:
          maxItems: 10
          minItems: 1
          type: array
          description: 发货凭证id-上传文件接口返回的id 已发货时必传(最多10个文件)
          items:
            type: integer
            description: 发货凭证id-上传文件接口返回的id 已发货时必传(最多10个文件)
            format: int32
        transaction_type:
          type: string
          description: >-
            成交方式: EXW-工厂交货 FCA-货交承运人 FAS-船边交货 FOB-船上交货 CFR-成本加运费 CIF-成本、保险加运费
            CPT-运费付至 DDP-完税后交货 DAF-边境交货 DDU-未完税交货 DEQ-目的港码头交货 DES-目的港船上交货
          enum:
            - EXW
            - FCA
            - FAS
            - FOB
            - CFR
            - CIF
            - CPT
            - DDP
            - DAF
            - DDU
            - DEQ
            - DES
        transport_type:
          type: string
          description: '运输方式: AIR-空运 SHIPPING-海运 EXPRESS-快递 LAND-陆运 POST-邮政 OTHER-其他'
          enum:
            - AIR
            - SHIPPING
            - EXPRESS
            - LAND
            - POST
            - OTHER
      description: 物流信息
    ContractOrderCreateRes:
      required:
        - contract_order_no
        - status
      type: object
      properties:
        contract_order_no:
          type: string
          description: 平台合同订单id
          minLength: 1
          maxLength: 32
        status:
          type: string
          description: '开放平台合同订单状态: RELATABLE-可关联、ALL_RELATED-已关联'
          enum:
            - RELATABLE
            - ALL_RELATED
    ContractOrderGetRes:
      required:
        - contract_order_no
        - status
      type: object
      properties:
        contract_order_no:
          type: string
          description: 订单编号
          minLength: 1
          maxLength: 32
        status:
          type: string
          description: 开放平台合同订单状态 RELATABLE-可关联 ALL_RELATED-已关联
          enum:
            - RELATABLE
            - ALL_RELATED
    ContractOrderUpdateV2Req:
      required:
        - amount
        - buyer_country
        - buyer_name
        - contract_file_ids
        - contract_no
        - currency
        - goods_info
        - invoice_file_ids
        - is_exchange_settle
        - logistics_info
        - order_date
        - request_id
      type: object
      properties:
        request_id:
          maxLength: 32
          minLength: 1
          type: string
          description: 请求号，请求方系统内唯一
        buyer_name:
          maxLength: 128
          minLength: 1
          type: string
          description: 买家姓名(最长128字符)
        buyer_country:
          type: string
          description: 买家国家代码,使用ISO3166-2标准2位国家代码(见附录)
        amount:
          type: integer
          description: 订单金额(币种最小单位)
          format: int64
        currency:
          type: string
          description: >-
            币种: EUR-欧元, USD-美元, CNY-人民币, GBP-英镑, JPY-日元, AUD-澳元, CAD-加元,
            SGD-新加坡元, HKD-港币, PHP-菲律宾比索, CNH-离岸人民币
          enum:
            - EUR
            - USD
            - CNY
            - GBP
            - JPY
            - AUD
            - CAD
            - SGD
            - HKD
            - PHP
            - CNH
        contract_file_ids:
          maxItems: 10
          minItems: 1
          type: array
          description: 合同附件id-上传文件接口返回的id(最多10个文件)
          items:
            type: integer
            description: 合同附件id-上传文件接口返回的id(最多10个文件)
            format: int32
        contract_no:
          maxLength: 32
          minLength: 1
          type: string
          description: 合同编号(最长32字符)(只能为数字和字母)(商户下唯一)
        goods_info:
          type: object
          properties:
            category:
              type: integer
              description: 商品分类(支持的商品品类见附件)
              format: int32
            name:
              maxLength: 128
              minLength: 1
              type: string
              description: 商品名称(最长128字符)
            quantity:
              type: integer
              description: 商品数量
              format: int64
            url:
              type: string
              description: 商品网址
              maxLength: 256
              minLength: 1
            custom_dec_info:
              type: object
              properties:
                dec_method:
                  type: string
                  description: 申报方式:METHOD_1-未在海关报备或未纳入海关统计的电商交易订单 METHOD_2-按一般贸易方式在海关报关出口
                dec_no:
                  type: string
                  description: 报关单号(最长32字符)
                  minLength: 0
                  maxLength: 32
              required:
                - dec_method
              description: 报关信息
          description: 商品信息
          required:
            - category
            - name
            - url
            - custom_dec_info
        invoice_file_ids:
          maxItems: 10
          minItems: 1
          type: array
          description: PI/CI/发票id-上传文件接口返回id(最多10个文件)
          items:
            type: integer
            description: PI/CI/发票id-上传文件接口返回id(最多10个文件)
            format: int32
        is_exchange_settle:
          type: boolean
          description: 是否需要结汇
        logistics_info:
          type: object
          properties:
            buyer_type:
              type: string
              description: NEW-新买家;OLD-老买家
              enum:
                - NEW
                - OLD
            destination:
              maxLength: 256
              minLength: 1
              type: string
              description: 目的地 已发货时必传(最长256字符)
            expected_ship_date:
              type: string
              description: 预期发货日期 未发货时必传 格式:yyyy-MM-dd
              format: date-time
            freight_arrange_file_ids:
              maxItems: 10
              minItems: 1
              type: array
              description: 货运安排沟通记录id-上传文件接口返回id (最多10个文件)
              items:
                type: integer
                description: 货运安排沟通记录id-上传文件接口返回id 物流状态=UNSHIPPED时必传(最多10个文件)
                format: int32
            latest_order_file_ids:
              maxItems: 10
              minItems: 1
              type: array
              description: 商户与该买家最近一笔交易的报关单或出境物流凭证id-上传文件接口返回id 老买家时必传(最多10个文件)
              items:
                type: integer
                description: 商户与该买家最近一笔交易的报关单或出境物流凭证id-上传文件接口返回id 老买家时必传(最多10个文件)
                format: int32
            logistics_company_name:
              maxLength: 256
              minLength: 1
              type: string
              description: 物流公司名称 已发货时必传(最长256字符)
            outbound_no:
              maxLength: 32
              minLength: 1
              type: string
              description: 出境物流单号 已发货时必传((最长32字符)
            inquiry_records_file_ids:
              maxItems: 10
              minItems: 1
              type: array
              description: 询盘下单沟通记录-上传文件接口返回的id (最多10个文件)
              items:
                type: integer
                description: 询盘下单沟通记录-上传文件接口返回的id 物流状态=UNSHIPPED时必传(最多10个文件)
                format: int32
            ship_date:
              type: string
              description: 发货日期 已发货时必传 格式:yyyy-MM-dd
              format: date-time
            ship_status:
              type: string
              description: '物流状态: SHIPPED-已发货 UNSHIPPED-未发货'
              enum:
                - SHIPPED
                - UNSHIPPED
            shipped_file_ids:
              maxItems: 10
              minItems: 1
              type: array
              description: 发货凭证id-上传文件接口返回的id 已发货时必传(最多10个文件)
              items:
                type: integer
                description: 发货凭证id-上传文件接口返回的id 已发货时必传(最多10个文件)
                format: int32
            transaction_type:
              type: string
              description: >-
                成交方式: EXW-工厂交货 FCA-货交承运人 FAS-船边交货 FOB-船上交货 CFR-成本加运费
                CIF-成本、保险加运费 CPT-运费付至 DDP-完税后交货 DAF-边境交货 DDU-未完税交货 DEQ-目的港码头交货
                DES-目的港船上交货
              enum:
                - EXW
                - FCA
                - FAS
                - FOB
                - CFR
                - CIF
                - CPT
                - DDP
                - DAF
                - DDU
                - DEQ
                - DES
            transport_type:
              type: string
              description: '运输方式: AIR-空运 SHIPPING-海运 EXPRESS-快递 LAND-陆运 POST-邮政 OTHER-其他'
              enum:
                - AIR
                - SHIPPING
                - EXPRESS
                - LAND
                - POST
                - OTHER
          description: 物流信息
          required:
            - ship_status
            - transaction_type
        order_date:
          type: string
          description: '订单时间 格式: yyyy-MM-dd'
          format: date
        remark:
          maxLength: 128
          minLength: 0
          type: string
          description: 备注(长度128字符)
        other_file_ids:
          type: array
          description: 其他附件id-上传文件接口返回的id
          items:
            type: integer
            description: 其他附件id-上传文件接口返回的id
            format: int32
    LogisticsSupplementV2Req:
      required:
        - destination
        - logistics_company_name
        - outbound_no
        - request_id
        - ship_date
        - shipped_file_ids
        - transport_type
      type: object
      properties:
        request_id:
          maxLength: 32
          minLength: 1
          type: string
          description: 请求号，请求方系统内唯一
        logistics_company_name:
          type: string
          description: 物流公司名称
        transport_type:
          type: string
          description: '运输方式: AIR-空运 SHIPPING-海运 EXPRESS-快递 LAND-陆运 POST-邮政 OTHER-其他'
          enum:
            - AIR
            - SHIPPING
            - EXPRESS
            - LAND
            - POST
            - OTHER
        outbound_no:
          type: string
          description: 出境物流单号
        destination:
          type: string
          description: 目的地
        ship_date:
          type: string
          description: '发货日期(时间格式: yyyy-MM-dd)'
          format: date
        shipped_file_ids:
          maxItems: 10
          minItems: 1
          type: array
          description: 发货凭证文件ID列表
          items:
            type: integer
            description: 发货凭证文件ID列表
            format: int32
    LogisticsSupplementRes:
      required:
        - status
      type: object
      properties:
        status:
          type: string
          description: '开放平台合同订单状态: RELATABLE-可关联、ALL_RELATED-已关联'
          enum:
            - RELATABLE
            - ALL_RELATED
    TradeSettleApplyReq:
      required:
        - recv_order_no
        - relate_list
      type: object
      properties:
        recv_order_no:
          type: string
          description: 收款单号(汇入汇款通知的单号)
          minLength: 1
          maxLength: 32
        relate_list:
          maxItems: 2147483647
          minItems: 1
          type: array
          description: 关联合同订单列表 至少关联一个
          items:
            $ref: '#/components/schemas/Relate'
    TradeSettleApplyRes:
      required:
        - status
      type: object
      properties:
        status:
          type: string
          description: >-
            状态(PENDING_RELATE-待关联订单、PENDING_REVIEW-审核中、CREDITED-已入账、PENDING_REFUND-退款中、REJECTED-审核未通过、REFUNDED-已退款)
          enum:
            - PENDING_RELATE
            - PENDING_REVIEW
            - CREDITED
            - REJECTED
            - PENDING_REFUND
            - REFUNDED
      description: 解付入账结果
    TradeSettleInquiryReq:
      type: object
      properties:
        recv_order_no:
          type: string
          description: 收款单id(汇入汇款通知的单号)
          minLength: 0
          maxLength: 32
      required:
        - recv_order_no
    TradeSettleInquiryRes:
      required:
        - status
      type: object
      properties:
        reason:
          type: string
          description: 最近一次审核驳回原因
        refund_remark:
          type: string
          description: 退款备注
        status:
          type: string
          description: >-
            状态(PENDING_RELATE-待关联订单、PENDING_REVIEW-审核中、CREDITED-已入账、PENDING_REFUND-退款中、REJECTED-审核未通过、REFUNDED-已退款)
          enum:
            - PENDING_RELATE
            - PENDING_REVIEW
            - CREDITED
            - REJECTED
            - PENDING_REFUND
            - REFUNDED
    TradeSettleNotification:
      required:
        - merch_id
        - recv_order_no
        - status
      type: object
      properties:
        merch_id:
          type: string
          description: 商户id
          minLength: 1
          maxLength: 20
        reason:
          type: string
          description: 最近一次审核驳回原因
        recv_order_no:
          type: string
          description: 收款单id(汇入汇款通知的单号)
          minLength: 1
          maxLength: 32
        status:
          type: string
          description: >-
            状态(PENDING_RELATE-待关联订单、PENDING_REVIEW-审核中、CREDITED-已入账、PENDING_REFUND-退款中、REJECTED-审核未通过、REFUNDED-已退款)
          enum:
            - PENDING_RELATE
            - PENDING_REVIEW
            - CREDITED
            - REJECTED
            - PENDING_REFUND
            - REFUNDED
      description: 通知消息内容
    NotificationDtoTradeSettleNotification:
      required:
        - data
        - type
        - version
      type: object
      properties:
        type:
          type: string
          description: >-
            业务类型: MERCH-商户, VA-虚拟账户, INCOMING_REMITTANCE-汇入汇款,
            CONTRACT_ORDER-合同订单, TRADE_SETTLE-解付入账, PAYEE-收款人, WD_ACCOUNT-提现账户,
            CUR_EXCHANGE-换汇, PAYMENT-付款
          enum:
            - MERCH
            - VA
            - INCOMING_REMITTANCE
            - CONTRACT_ORDER
            - TRADE_SETTLE
            - PAYEE
            - WD_ACCOUNT
            - FOREX
            - PAYMENT
        version:
          type: string
          description: 版本号(V1、V2、...)
        data:
          $ref: '#/components/schemas/TradeSettleNotification'
    Relate:
      required:
        - amount
        - contract_order_no
      type: object
      properties:
        amount:
          type: integer
          description: 本次入账金额(币种最小单位)
          format: int64
        contract_order_no:
          type: string
          description: 平台合同编号(创建合同订单接口返回)
          minLength: 1
          maxLength: 32
      description: 关联合同订单列表 至少关联一个
    AccountBalanceRes:
      required:
        - account_list
      type: object
      properties:
        account_list:
          type: array
          description: 列表
          items:
            type: object
            properties:
              balance:
                type: integer
                description: 余额(币种最小单位)
                format: int64
              currency:
                type: string
                description: >-
                  币种: EUR-欧元, USD-美元, CNY-人民币, GBP-英镑, JPY-日元, AUD-澳元, CAD-加元,
                  SGD-新加坡元, HKD-港币, PHP-菲律宾比索, CNH-离岸人民币
                enum:
                  - EUR
                  - USD
                  - CNY
                  - GBP
                  - JPY
                  - AUD
                  - CAD
                  - SGD
                  - HKD
                  - PHP
                  - CNH
            required:
              - balance
              - currency
    PayeeInquiryV2Req:
      required:
        - request_id
        - type
      type: object
      properties:
        request_id:
          maxLength: 32
          minLength: 1
          type: string
          description: 请求号，请求方系统内唯一
        type:
          type: string
          description: '目的(必填): PAYMENT-收款、WITHDRAWAL-提现'
    BankAccV2Info:
      required:
        - acc_name
        - acc_type
        - country
        - currency
        - payment_type
      type: object
      properties:
        country:
          type: string
          description: 国家代码,使用ISO3166-2标准2位国家代码,非制裁国家(见附录)
          maxLength: 2
          minLength: 0
          examples:
            - string
        currency:
          type: string
          description: >-
            币种: EUR-欧元, USD-美元, CNY-人民币, GBP-英镑, JPY-日元, AUD-澳元, CAD-加元,
            SGD-新加坡元, HKD-港币, PHP-菲律宾比索, THB-泰铢, CNH-离岸人民币
          enum:
            - EUR
            - USD
            - CNY
            - GBP
            - JPY
            - AUD
            - CAD
            - SGD
            - HKD
            - PHP
            - THB
            - CNH
        acc_name:
          maxLength: 100
          minLength: 1
          type: string
          description: 账户名称(最长100字符)
        acc_type:
          type: string
          description: '账户类型: PRIVATE-个人账户, COMPANY-企业对公'
          enum:
            - PRIVATE
            - COMPANY
        acc_no:
          maxLength: 100
          minLength: 0
          type: string
          description: 银行账号，accNo和iban二选一
        payment_type:
          type: string
          description: 支付清算网络：LOCAL-本地支付，SWIFT-国际支付
          enum:
            - LOCAL
            - SWIFT
        routing_code_type1:
          type: string
          description: >-
            LOCAL清算网络时必须(随业务发展后会扩展枚举值）：ABA、SORT_CODE、BANK_CODE(境内详见银行编码附件，境外如加拿大如实填写)
        routing_code_value1:
          type: string
          description: routingCodeType1不为空时必须
        routing_code_type2:
          type: string
          description: LOCAL清算网络子类型(随业务发展后会扩展枚举值）：BRANCH_BANK_CODE(境内详见银行编码附件，境外如加拿大如实填写)
        routing_code_value2:
          type: string
          description: routingCodeType2不为空时必须
        iban:
          maxLength: 50
          minLength: 0
          type: string
          description: IBAN，欧元区账户特有，accNo和iban二选一
        bic_swift:
          type: string
          description: swift code或bic，SWIFT清算网络时其它国家与地区均需要上传该字段(只支持8位或11位)
          maxLength: 11
          minLength: 8
          examples:
            - string
        bank_acc_type:
          type: string
          description: 银行账户类型 CHECKING-支票 SAVINGS-储蓄卡
          enum:
            - CHECKING
            - SAVINGS
        bank_addr:
          maxLength: 100
          minLength: 0
          type: string
          description: 开户银行详细地址(境外账户必填)(最长100字符)
        bank_name:
          maxLength: 100
          minLength: 0
          type: string
          description: 开户银行名称(境外账户必填; 最长100字符)
        branch_bank_name:
          maxLength: 100
          minLength: 0
          type: string
          description: 开户银行支行名称(最长100字符)
        phone:
          type: string
          description: 银行预留手机号(大陆人民币对私提现)
          maxLength: 11
          minLength: 11
          examples:
            - string
        province:
          maxLength: 10
          minLength: 0
          type: string
          description: 开户银行所属省份(境内企业对公账户必填, 见附件)
        city:
          maxLength: 10
          minLength: 0
          type: string
          description: 开户银行所属城市(境内企业对公账户必填, 见附件)
        district:
          maxLength: 10
          minLength: 0
          type: string
          description: 开户银行所属区(境内企业对公账户必填, 见附件)
      description: 银行账户信息
    ContractOrderUpdateRes:
      required:
        - status
      type: object
      properties:
        status:
          type: string
          description: '开放平台合同订单状态: RELATABLE-可关联、ALL_RELATED-已关联'
          enum:
            - RELATABLE
            - ALL_RELATED
    NotificationDtoMerchOnboardApplyResultNotificationV2:
      required:
        - data
        - type
        - version
      type: object
      properties:
        type:
          type: string
          description: >-
            业务类型: MERCH-商户, VA-虚拟账户, INCOMING_REMITTANCE-汇入汇款,
            CONTRACT_ORDER-合同订单, TRADE_SETTLE-解付入账, PAYEE-收款人, WD_ACCOUNT-提现账户,
            CUR_EXCHANGE-换汇, PAYMENT-付款
          enum:
            - MERCH
            - VA
            - INCOMING_REMITTANCE
            - CONTRACT_ORDER
            - TRADE_SETTLE
            - PAYEE
            - WD_ACCOUNT
            - FOREX
            - PAYMENT
        version:
          type: string
          description: 版本号(V1、V2、...)
        data:
          $ref: '#/components/schemas/MerchOnboardApplyResultNotificationV2'
    NotificationDtoMerchPayeeNotificationV2:
      required:
        - data
        - type
        - version
      type: object
      properties:
        type:
          type: string
          description: >-
            业务类型: MERCH-商户, VA-虚拟账户, INCOMING_REMITTANCE-汇入汇款,
            CONTRACT_ORDER-合同订单, TRADE_SETTLE-解付入账, PAYEE-收款人, WD_ACCOUNT-提现账户,
            CUR_EXCHANGE-换汇, PAYMENT-付款
          enum:
            - MERCH
            - VA
            - INCOMING_REMITTANCE
            - CONTRACT_ORDER
            - TRADE_SETTLE
            - PAYEE
            - WD_ACCOUNT
            - FOREX
            - PAYMENT
        version:
          type: string
          description: 版本号(V1、V2、...)
        data:
          $ref: '#/components/schemas/MerchPayeeNotificationV2'
    EntStakeholder:
      required:
        - birth_date
        - doc_portrait_side_file_id
        - doc_type
        - eff_date_start
        - id_number
        - identity_type
        - name
      type: object
      properties:
        identity_type:
          type: string
          description: 身份类型： LEGAL_PERSON-法人、BENEFICIARY-最终受益人、SHAREHOLDER-股东、DIRECTOR-董事
        name:
          maxLength: 128
          minLength: 0
          type: string
          description: 姓名(长度128字符)
        nationality:
          maxLength: 2
          minLength: 0
          type: string
          description: 国籍（ISO3166-2标准2位国家/地区代码）
        birth_date:
          type: string
          description: 生日, 格式yyyy-MM-dd，如 2023-12-12
          format: date
        address_proof_file_id:
          type: integer
          description: 地址证明文件, 非中国大陆身份证，地址证明文件必填
          format: int32
        doc_type:
          type: string
          description: >-
            身份证类型
            ID_CARD：二代居民身份证，HK_CARD：香港永久居住证，PASSPORT：护照，MO_CARD：澳门永久居住证，HK_MO_PASS：港澳居民来往内地通行证，TW_CARD：台湾居民来往大陆通行证
        id_number:
          maxLength: 18
          minLength: 0
          type: string
          description: 证件号码(长度18字符)
        doc_address:
          maxLength: 256
          minLength: 0
          type: string
          description: 证件详细地址(长度256字符), 大陆身份证必填
        doc_non_portrait_side_file_id:
          type: integer
          description: 证件反面文件, 除护照、台湾往来大陆通行证不需要提供，其他证件类型均需要提供
          format: int32
        doc_portrait_side_file_id:
          type: integer
          description: 证件正面文件
          format: int32
        eff_date_start:
          type: string
          description: 证件起始日期；格式yyyy-MM-dd，如 2023-12-12
          format: date
        eff_date_end:
          type: string
          description: 证件失效日期；格式yyyy-MM-dd，如 2023-12-12，和long_term二选一, 其它按日期格式上传
          format: date
        long_term:
          type: boolean
          description: 是否长期(大陆身份证件选填), 和eff_date_end二选一
        share:
          type: number
          description: 持股比例, 百分比, 51.12%传51.12, 最多两位小数, 受益人、董事必填
        resident_address:
          $ref: '#/components/schemas/AddressDto'
      description: 企业关联个人信息列表
    AuthAgentStakeholder:
      required:
        - birth_date
        - doc_portrait_side_file_id
        - doc_type
        - eff_date_start
        - id_number
        - name
      type: object
      properties:
        name:
          maxLength: 128
          minLength: 0
          type: string
          description: 姓名(长度128字符)
        nationality:
          maxLength: 2
          minLength: 0
          type: string
          description: 国籍（ISO3166-2标准2位国家/地区代码）
        birth_date:
          type: string
          description: 生日, 格式yyyy-MM-dd，如 2023-12-12
          format: date
        address_proof_file_id:
          type: integer
          description: 地址证明文件, 非中国大陆身份证，地址证明文件必填
          format: int32
        doc_type:
          type: string
          description: >-
            身份证类型
            ID_CARD：二代居民身份证，HK_CARD：香港永久居住证，PASSPORT：护照，MO_CARD：澳门永久居住证，HK_MO_PASS：港澳居民来往内地通行证，TW_CARD：台湾居民来往大陆通行证
        id_number:
          maxLength: 18
          minLength: 0
          type: string
          description: 证件号码(长度18字符)
        doc_address:
          maxLength: 256
          minLength: 0
          type: string
          description: 证件详细地址(长度256字符), 大陆身份证必填
        doc_non_portrait_side_file_id:
          type: integer
          description: 证件反面文件, 除护照、台湾往来大陆通行证不需要提供，其他证件类型均需要提供
          format: int32
        doc_portrait_side_file_id:
          type: integer
          description: 证件正面文件
          format: int32
        eff_date_start:
          type: string
          description: 证件起始日期；格式yyyy-MM-dd，如 2023-12-12
          format: date
        eff_date_end:
          type: string
          description: 证件失效日期；格式yyyy-MM-dd，如 2023-12-12，和long_term二选一, 其它按日期格式上传
          format: date
        long_term:
          type: boolean
          description: 是否长期(大陆身份证件选填), 和eff_date_end二选一
        resident_address:
          $ref: '#/components/schemas/AddressDto'
      description: 授权代理人信息
  securitySchemes: {}
servers: []
security: []
