payapi-spec/consumeapi.yaml

components:
  schemas:
    QrcodePayInitRequest:
      type: object
      title: QrCode请求初始化
      required:
        - qrcode
        - transDate
        - transTime
        - shopaccno
        - billno
      properties:
        qrcode:
          type: string
          title: QrCode
        transDate:
          $ref: 'definitions.yaml#/components/schemas/TransDate'
        transTime:
          $ref: 'definitions.yaml#/components/schemas/TransTime'
        shopaccno:
          $ref: 'definitions.yaml#/components/schemas/ShopAccNo'
        billno:
          $ref: 'definitions.yaml#/components/schemas/Refno'
        qrcodeFormat:
          $ref: 'definitions.yaml#/components/schemas/QrcodeFormat'

    QrcodePayInitResponse:
      type: object
      title: QrCode请求初始化应答
      properties:
        anonymous:
          title: 是否匿名用户
          type: boolean
        userid:
          title: 用户ID（非匿名）
          type: string
        username:
          title: 用户名（非匿名）
          type: string
        sourcetype:
          title: 支付方式
          type: string
    QrcodePayConfirmRequest:
      type: object
      title: Qrcode消费确认请求
      properties:
        billno:
          $ref: 'definitions.yaml#/components/schemas/Refno'
        shopaccno:
          $ref: 'definitions.yaml#/components/schemas/ShopAccNo'
        transDate:
          $ref: 'definitions.yaml#/components/schemas/TransDate'
        transTime:
          $ref: 'definitions.yaml#/components/schemas/TransTime'
        dtltype:
          type: string
          title: 交易类型
        amount:
          type: integer
          format: int32
          title: 交易金额
        userid:
          type: string
          title: 用户ID（非匿名）
        anonymous:
          type: boolean
          title: 是否匿名
        qrcode:
          type: string
          title: QrCode
        qrcodeFormat:
          $ref: 'definitions.yaml#/components/schemas/QrcodeFormat'
    QrcodePayConfirmResponse:
      type: object
      title: QrCode消费确认返回
      properties:
        refno:
          $ref: 'definitions.yaml#/components/schemas/Refno'
        hostDate:
          $ref: 'definitions.yaml#/components/schemas/TransDate'
        hostTime:
          $ref: 'definitions.yaml#/components/schemas/TransTime'
        description:
          type: string
          title: 交易描述
        result:
          title: 交易结果
          $ref: 'definitions.yaml#/components/schemas/TransResult'
        amount:
          type: integer
          format: int32
          title: 消费金额
    RefundRequest:
      type: object
      title: 退款申请
      required:
        - billno
        - transDate
        - transTime
        - refno
        - amount
        - shopaccno
      properties:
        billno:
          title: 退款申请订单号
          $ref: 'definitions.yaml#/components/schemas/Refno'
        transDate:
          $ref: 'definitions.yaml#/components/schemas/TransDate'
        transTime:
          $ref: 'definitions.yaml#/components/schemas/TransTime'
        refno:
          title: 退款申请原始订单交易参考号
          $ref: 'definitions.yaml#/components/schemas/Refno'
        shopaccno:
          $ref: 'definitions.yaml#/components/schemas/ShopAccNo'
        amount:
          type: integer
          title: 退款金额, 正式
    RefundResponse:
      type: object
      title: 退款申请应答
      properties:
        billno:
          title: 退款申请订单号
          $ref: 'definitions.yaml#/components/schemas/Refno'
        hostDate:
          $ref: 'definitions.yaml#/components/schemas/TransDate'
        hostTime:
          $ref: 'definitions.yaml#/components/schemas/TransTime'
        refno:
          title: 退款申请原始订单交易参考号
          $ref: 'definitions.yaml#/components/schemas/Refno'
        refundAmount:
          type: integer
          format: int32
          title: 退款金额
        leftAmount:
          type: integer
          format: int32
          title: 原流水剩余金额
        result:
          title: 退款处理结果
          $ref: 'definitions.yaml#/components/schemas/TransResult'

  paths:
    qrcodePayInit:
      parameters:
        - $ref: definitions.yaml#/components/headers/TenantId
      post:
        operationId: qrcodePayInit
        tags:
          - pos
        requestBody:
          description: QrCode 初始化
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/QrcodePayInitRequest'

        responses:
          '200':
            description: 初始化成功
            content:
              application/json:
                schema:
                  $ref: '#/components/schemas/QrcodePayInitResponse'
          '500':
            $ref: 'definitions.yaml#/components/responses/CommonError'
    qrcodePayConfirm:
      parameters:
        - $ref: definitions.yaml#/components/headers/TenantId
      post:
        operationId: qrcodePayConfirm
        tags:
          - pos
        requestBody:
          description: Qrcode确认
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/QrcodePayConfirmRequest'
        responses:
          '200':
            description: 交易成功
            content:
              application/json:
                schema:
                  $ref: '#/components/schemas/QrcodePayConfirmResponse'
          '409':
            description: 交易正忙，稍后重试
            content:
              application/json:
                schema:
                  $ref: 'definitions.yaml#/components/schemas/ErrorResponse'
          '500':
            $ref: 'definitions.yaml#/components/responses/CommonError'
    qrcodePayQuery:
      parameters:
        - $ref: 'definitions.yaml#/components/headers/TenantId'
        - name: refno
          in: path
          description: 系统交易参考号
          required: true
          schema:
            type: string
            title: 系统交易参考号
      get:
        description: 根据系统交易参考号查询流水状态
        tags:
          - pos
        operationId: qrcodePayQuery
        responses:
          '200':
            description: 查询成功
            content:
              application/json:
                schema:
                  $ref: '#/components/schemas/QrcodePayConfirmResponse'
          '500':
            $ref: 'definitions.yaml#/components/responses/CommonError'
    refund:
      parameters:
        - $ref: 'definitions.yaml#/components/headers/TenantId'
      post:
        description: 退款交易
        tags:
          - pos
        operationId: refund
        requestBody:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RefundRequest'
        responses:
          '200':
            description: 退款申请成功，等待查询
            content:
              application/json:
                schema:
                  $ref: '#/components/schemas/RefundResponse'
          '409':
            description: |
              退款申请失败，订单号已存在或正在退款中
            content:
              application/json:
                schema:
                  $ref: 'definitions.yaml#/components/schemas/ErrorResponse'
          '500':
            $ref: 'definitions.yaml#/components/responses/CommonError'
    refundQuery:
      parameters:
        - $ref: 'definitions.yaml#/components/headers/TenantId'
        - name: refno
          in: path
          description: 系统交易参考号
          required: true
          schema:
            type: string
            title: 系统交易参考号
      get:
        description: 退款申请查询
        tags:
          - pos
        operationId: refundQuery
        responses:
          '200':
            description: 退款申请查询成功
            content:
              application/json:
                schema:
                  $ref: '#/components/schemas/RefundResponse'
          '404':
            description: 退款申请订单不存在
            content:
              application/json:
                schema:
                  $ref: 'definitions.yaml#/components/schemas/ErrorResponse'
          '500':
            $ref: 'definitions.yaml#/components/responses/CommonError'