partner.yaml

# NOTE:
# エントリーポイントについて、x-pokepay-allow-server-side: true がついているものはサーバーサイドで正しいことが保証されているが
# それ以外は存在しないか間違っているので注意

openapi: '3.0.1'

info:
  description: >-
    Partner APIs

  title:  Partner APIs
  version: 24.3.26

tags:
  - name: Transaction
  - name: Transfer
  - name: Check
    description: |
      店舗ユーザが発行し、エンドユーザーがポケペイアプリから読み取ることでチャージ取引が発生するQRコードです。

      チャージQRコードを解析すると次のようなURLになります(URLは環境によって異なります)。

      `https://www-sandbox.pokepay.jp/checks/xxxxxxxx-xxxx-xxxxxxxxx-xxxxxxxxxxxx`

      QRコードを読み取る方法以外にも、このURLリンクを直接スマートフォン(iOS/Android)上で開くことによりアプリが起動して取引が行われます。(注意: 上記URLはsandbox環境であるため、アプリもsandbox環境のものである必要があります) 上記URL中の `xxxxxxxx-xxxx-xxxxxxxxx-xxxxxxxxxxxx` の部分がチャージQRコードのIDです。
  - name: Bill
    description: 支払いQRコード
  - name: Cashtray
    description: |
      Cashtrayは支払いとチャージ両方に使えるQRコードで、店舗ユーザとエンドユーザーの間の主に店頭などでの取引のために用いられます。
      Cashtrayによる取引では、エンドユーザーがQRコードを読み取った時点で即時取引が作られ、ユーザに対して受け取り確認画面は表示されません。
      Cashtrayはワンタイムで、一度読み取りに成功するか、取引エラーになると失効します。
      また、Cashtrayには有効期限があり、デフォルトでは30分で失効します。

  - name: Customer
  - name: Organization
  - name: Shop
  - name: User
  - name: Account
  - name: Private Money
  - name: Bulk
  - name: Event
  - name: Campaign
  - name: Webhook
    description: |
      Webhookは特定のワーカータスクでの処理が完了した事を通知します。
      WebHookにはURLとタスク名、有効化されているかを設定することが出来ます。
      通知はタスク完了時、事前に設定したURLにPOSTリクエストを行います。
  - name: Coupon
    description: |
      Couponは支払い時に指定し、支払い処理の前にCouponに指定の方法で値引き処理を行います。
      Couponは特定店舗で利用できるものや利用可能期間、配信条件などを設定できます。
  - name: UserDevice
    description: |
      UserDeviceはユーザー毎のデバイスを管理します。
      あるユーザーが使っている端末を区別する必要がある場合に用いられます。
      これが必要な理由はBank Payを用いたチャージを行う場合は端末を区別できることが要件としてあるためです。
  - name: BankPay
    description: |
      BankPayを用いた銀行からのチャージ取引などのAPIを提供しています。
  - name: SevenBankATMSession
    description: |
      セブンATMチャージの取引内容を照会するAPIを提供しています。

components:
  schemas:
    Pong:
      x-pokepay-schema-type: "response"
      properties:
        pong:
          x-pokepay-csharp-property-name: "Value"
          type: string
          pattern: '^ok$'
    Echo:
      x-pokepay-schema-type: "response"
      properties:
        status:
          type: string
          pattern: '^ok$'
        message:
          type: string
    Pagination:
      x-pokepay-schema-type: "response"
      properties:
        current:
          type: integer
        per_page:
          type: integer
          minimum: 1
        max_page:
          type: integer
          minimum: 1
        has_prev:
          type: boolean
        has_next:
          type: boolean
    AdminUserWithShopsAndPrivateMoneys:
      x-pokepay-schema-type: "response"
      properties:
        id:
          type: string
          format: uuid
        role:
          type: string
          pattern: '^(SERVICE|ORGANIZATION|SHOP)-(MANAGER|STAFF)$'
        email:
          type: string
          format: email
        name:
          type: string
        is_active:
          type: boolean
        organization:
          $ref: '#/components/schemas/Organization'
        shops:
          type: array
          items:
            $ref: '#/components/schemas/User'
        private_moneys:
          type: array
          items:
            $ref: '#/components/schemas/PrivateMoney'
    Account:
      x-pokepay-schema-type: "response"
      properties:
        id:
          type: string
          format: uuid
          title: 'ウォレットID'
        name:
          type: string
          title: 'ウォレット名'
        is_suspended:
          type: boolean
          title: 'ウォレットが凍結されているかどうか'
        status:
          type: string
          enum: [active, suspended, pre-closed, closed]
        private_money:
          $ref: '#/components/schemas/PrivateMoney'
          title: '設定マネー情報'
    AccountWithUser:
      x-pokepay-schema-type: "response"
      properties:
        id:
          type: string
          format: uuid
        name:
          type: string
        is_suspended:
          type: boolean
        status:
          type: string
          enum: [active, suspended, pre-closed, closed]
        private_money:
          $ref: '#/components/schemas/PrivateMoney'
        user:
          $ref: '#/components/schemas/User'
    AccountDetail:
      x-pokepay-schema-type: "response"
      properties:
        id:
          type: string
          format: uuid
        name:
          type: string
        is_suspended:
          type: boolean
        status:
          type: string
          enum: [active, suspended, pre-closed, closed]
        balance:
          type: number
          format: decimal
        money_balance:
          type: number
          format: decimal
        point_balance:
          type: number
          format: decimal
        point_debt:
          type: number
          format: decimal
        private_money:
          $ref: '#/components/schemas/PrivateMoney'
        user:
          $ref: '#/components/schemas/User'
        external_id:
          type: string
          nullable: true
          maxLength: 50
    ShopAccount:
      x-pokepay-schema-type: "response"
      properties:
        id:
          type: string
          format: uuid
          title: 'ウォレットID'
        name:
          type: string
          title: 'ウォレット名'
        is_suspended:
          type: boolean
          title: 'ウォレットが凍結されているかどうか'
        can_transfer_topup:
          type: boolean
          title: 'チャージ可能かどうか'
        private_money:
          $ref: '#/components/schemas/PrivateMoney'
          title: '設定マネー情報'
    AccountDeleted:
      x-pokepay-schema-type: "response"
      properties: {}
    AccountBalance:
      x-pokepay-schema-type: "response"
      properties:
        expires_at:
          type: string
          format: date-time
        money_amount:
          type: number
          format: decimal
        point_amount:
          type: number
          format: decimal
    Bill:
      x-pokepay-schema-type: "response"
      properties:
        id:
          type: string
          format: uuid
          title: 支払いQRコードのID
        amount:
          type: number
          format: decimal
          nullable: true
          title: 支払い額
          description: 支払い額。支払い額未指定の場合は支払い時に任意金額を入力できます。
        max_amount:
          type: number
          format: decimal
          nullable: true
          title: 支払い額を範囲指定した場合の上限
          description: 支払い額に任意金額を入力する際の上限です。
        min_amount:
          type: number
          format: decimal
          nullable: true
          title: 支払い額を範囲指定した場合の下限
          description: 支払い額に任意金額を入力する際の下限です。
        description:
          type: string
          title: 支払いQRコードの説明文(アプリ上で取引の説明文として表示される)
        account:
          $ref: '#/components/schemas/AccountWithUser'
          title: 支払いQRコード発行ウォレット
          description: 支払いQRコードを発行した店舗のウォレットです。ユーザやマネーの情報を含みます。
        is_disabled:
          type: boolean
          title: 無効化されているかどうか
        token:
          type: string
          title: 支払いQRコードを解析したときに出てくるURL
    Check:
      x-pokepay-schema-type: "response"
      properties:
        id:
          type: string
          format: uuid
          title: チャージQRコードのID
        created_at:
          type: string
          format: date-time
          title: チャージQRコードの作成日時
        amount:
          type: number
          format: decimal
          deprecated: true
          title: チャージマネー額
        money_amount:
          type: number
          format: decimal
          title: チャージマネー額
        point_amount:
          type: number
          format: decimal
          title: チャージポイント額
        description:
          type: string
          title: チャージQRコードの説明文(アプリ上で取引の説明文として表示される)
        user:
          $ref: '#/components/schemas/User'
          title: 送金元ユーザ情報
        is_onetime:
          type: boolean
          title: 使用回数が一回限りかどうか
        is_disabled:
          type: boolean
          title: 無効化されているかどうか
        expires_at:
          type: string
          format: date-time
          title: チャージQRコード自体の失効日時
        last_used_at:
          type: string
          format: date-time
          nullable: true
        private_money:
          $ref: '#/components/schemas/PrivateMoney'
          title: 対象マネー情報
        usage_limit:
          type: integer
          minimum: 1
          nullable: true
          title: 一回限りでない場合の最大読み取り回数
        usage_count:
          type: number
          nullable: true
          title: 一回限りでない場合の現在までに読み取られた回数
        point_expires_at:
          type: string
          format: date-time
          nullable: true
          title: ポイント有効期限(絶対日数指定)
        point_expires_in_days:
          type: integer
          minimum: 0
          nullable: true
          title: ポイント有効期限(相対日数指定)
        token:
          type: string
          title: チャージQRコードを解析したときに出てくるURL
    PaginatedChecks:
      x-pokepay-schema-type: "response"
      properties:
        rows:
          type: array
          items:
            $ref: '#/components/schemas/Check'
        count:
          type: integer
          minimum: 0
        pagination:
          $ref: '#/components/schemas/Pagination'
    CpmToken:
      x-pokepay-schema-type: "response"
      type: object
      properties:
        cpm_token:
          x-pokepay-csharp-property-name: "Token"
          type: string
          minLength: 22
          maxLength: 22
        account:
          $ref: '#/components/schemas/AccountDetail'
        transaction:
          $ref: '#/components/schemas/Transaction'
          nullable: true
        event:
          $ref: '#/components/schemas/ExternalTransaction'
          nullable: true
        scopes:
          type: array
          title: 許可された取引種別
          description: エンドユーザーがCPMトークンを生成する際に指定する、CPMトークンに許可された取引の種別。
          items:
            type: string
            enum: [payment, topup, external-transaction]
        expires_at:
          type: string
          format: date-time
          title: CPMトークンの失効日時
        metadata:
          type: string
          format: json
          title: エンドユーザー側メタデータ
          description: |-
            取引作成時に店舗側から指定されるメタデータです。
            全てのkeyとvalueが文字列であるようなフラットな構造のJSON文字列です。

    Cashtray:
      x-pokepay-schema-type: "response"
      properties:
        id:
          type: string
          format: uuid
          title: Cashtray自体のIDです。
        amount:
          type: number
          format: decimal
          title: 取引金額
          description: Cashtrayの取引金額です。正の数ならチャージ、負の数なら支払いとなります。
        description:
          type: string
          title: Cashtrayの説明文
          description: Cashtrayの説明文です。アプリ上で取引の説明文として表示されます。
        account:
          $ref: '#/components/schemas/AccountWithUser'
          title: 発行店舗のウォレット
          description: Cashtrayを発行した店舗ユーザーのウォレット情報です。ユーザやマネーの情報を含みます。
        expires_at:
          type: string
          format: date-time
          title: Cashtrayの失効日時
        canceled_at:
          type: string
          format: date-time
          nullable: true
          title: Cashtrayの無効化日時。NULLの場合は無効化されていません
        token:
          type: string
          title: CashtrayのQRコードを解析したときに出てくるURL

    CashtrayWithResult:
      x-pokepay-schema-type: "response"
      properties:
        id:
          type: string
          format: uuid
          title: CashtrayのID
          description: Cashtray自体のIDです。
        amount:
          type: number
          format: decimal
          title: 取引金額
          description: Cashtrayの取引金額です。正の数ならチャージ、負の数なら支払いとなります。
        description:
          type: string
          title: Cashtrayの説明文(アプリ上で取引の説明文として表示される)
        account:
          $ref: '#/components/schemas/AccountWithUser'
          title: 発行店舗のウォレット
          description: Cashtrayを発行した店舗ユーザーのウォレット情報です。ユーザやマネーの情報を含みます。
        expires_at:
          type: string
          format: date-time
          title: Cashtrayの失効日時
        canceled_at:
          type: string
          format: date-time
          nullable: true
          title: Cashtrayの無効化日時。NULLの場合は無効化されていません
        token:
          type: string
          title: CashtrayのQRコードを解析したときに出てくるURL
        attempt:
          $ref: '#/components/schemas/CashtrayAttempt'
          title: Cashtray読み取り結果
          description: Cashtrayをエンドユーザーが読み取った結果です。Cashtrayがまだ誰にも読み取られていない場合はNULLになります。
          nullable: true
        transaction:
          $ref: '#/components/schemas/Transaction'
          title: 取引結果
          description: Cashtrayをエンドユーザーが読み取った結果としてできた取引です。Cashtrayがまだ誰にも読み取られていない場合、またはエラーにより取引が完了しなかった場合はNULLになります。
          nullable: true

    CashtrayAttempt:
      x-pokepay-schema-type: "response"
      properties:
        account:
          $ref: '#/components/schemas/AccountWithUser'
          title: エンドユーザーのウォレット
          description: |-
            Cashtrayを読み取ったエンドユーザーのウォレット情報です。ユーザやマネーの情報を含みます。
            この際、エンドユーザーがCashtrayを発行した店舗ウォレットのマネーを持っていない場合、この値はNULLになります。
          nullable: true
        status_code:
          type: number
          title: ステータスコード
          description: エンドユーザーによるCashtrayの読み取りリクエストに対するレスポンスのHTTPステータスコードです。
        error_type:
          type: string
          title: エラー型
          description: 取引中に発生したエラーの型名です。エラーが発生しなかった場合は空文字となります。
        error_message:
          type: string
          title: エラーメッセージ
          description: 取引中に発生したエラーの説明文です。エラーが発生しなかった場合は空文字となります。
        created_at:
          type: string
          format: date-time
          title: Cashtray読み取り記録の作成日時
          description: エンドユーザーによるCashtrayの読み取りリクエストに対する記録(CashtrayAttempt)の作成日時です。これによりエンドユーザーがCashtrayをいつ読み取ったかが分かります。

    User:
      x-pokepay-schema-type: "response"
      properties:
        id:
          type: string
          format: uuid
          title: 'ユーザー (または店舗) ID'
        name:
          type: string
          title: 'ユーザー (または店舗) 名'
        is_merchant:
          type: boolean
          title: '店舗ユーザーかどうか'
    PrivateMoney:
      x-pokepay-schema-type: "response"
      properties:
        id:
          type: string
          format: uuid
          title: 'マネーID'
        name:
          type: string
          maxLength: 256
          title: 'マネー名'
        unit:
          type: string
          title: 'マネー単位 (例: 円)'
        is_exclusive:
          type: boolean
          title: '会員制のマネーかどうか'
        description:
          type: string
          title: 'マネー説明文'
        oneline_message:
          type: string
          title: 'マネーの要約'
        organization:
          title: 'マネーを発行した組織'
          $ref: '#/components/schemas/Organization'
        max_balance:
          type: number
          format: decimal
          title: 'ウォレットの上限金額'
        transfer_limit:
          type: number
          format: decimal
          title: 'マネーの取引上限額'
        money_topup_transfer_limit:
          type: number
          format: decimal
          title: 'マネーチャージ取引上限額'
        type:
          type: string
          enum: [own, third-party]
          title: 'マネー種別 (自家型=own, 第三者型=third-party)'
        expiration_type:
          type: string
          enum: [static, last-update, last-topup-update]
          title: '有効期限種別 (チャージ日起算=static, 最終利用日起算=last-update, 最終チャージ日起算=last-topup-update)'
        enable_topup_by_member:
          type: boolean
          nullable: true
          deprecated: true
          description: 'このパラメータは未使用につき廃止されます'
        display_money_and_point:
          type: string
          enum: [both, money-only, point-only]
    Organization:
      x-pokepay-schema-type: "response"
      properties:
        code:
          type: string
          maxLength: 32
          title: '組織コード'
        name:
          type: string
          maxLength: 256
          title: '組織名'
    Transaction:
      x-pokepay-schema-type: "response"
      properties:
        id:
          type: string
          format: uuid
          title: '取引ID'
        type:
          type: string
          title: '取引種別'
          description: |
            各取引種別の値の意味は以下の通りです。
            - topup: チャージ
            - payment: 支払い
            - transfer: 個人間送金
            - exchange: マネー間交換
            - cashback: ウォレット退会時の払い戻し処理
            - expire: ウォレット退会時の残高失効処理
          enum: [topup, payment, transfer, exchange, cashback, expire]
        is_modified:
          type: boolean
          title: '返金された取引かどうか'
        sender:
          $ref: '#/components/schemas/User'
          title: '送金者情報'
        sender_account:
          $ref: '#/components/schemas/Account'
          title: '送金ウォレット情報'
        receiver:
          $ref: '#/components/schemas/User'
          title: '受取者情報'
        receiver_account:
          $ref: '#/components/schemas/Account'
          title: '受取ウォレット情報'
        amount:
          type: number
          title: '取引総額 (マネー額 + ポイント額)'
        money_amount:
          type: number
          title: '取引マネー額'
        point_amount:
          type: number
          title: '取引ポイント額(キャンペーン付与ポイント合算)'
          description: |
            取引のポイント額です。
            キャンペーンによるポイント付与額との合算値なので、元々の取引のポイント額のみを取り出したいときは `raw_point_amount` を参照してください。
            チャージ取引の場合、point_amount = raw_point_amount + campaign_point_amount
            支払い取引の場合、point_amount = raw_point_amount - campaign_point_amount
            が成立します。
        raw_point_amount:
          type: number
          title: '取引ポイント額'
          description: |
            取引のポイント額です。
            キャンペーンによるポイント付与額を含まない、元々の取引で支払われたポイント額を表します。
          nullable: true
        campaign_point_amount:
          type: number
          title: 'キャンペーンによるポイント付与額'
          nullable: true
        done_at:
          type: string
          format: date-time
          title: '取引日時'
        description:
          type: string
          title: '取引説明文'
    TransactionDetail:
      x-pokepay-schema-type: "response"
      properties:
        id:
          type: string
          format: uuid
          title: '取引ID'
        type:
          type: string
          title: '取引種別'
          description: |
            各取引種別の値の意味は以下の通りです。
            - topup: チャージ
            - payment: 支払い
            - transfer: 個人間送金
            - exchange: マネー間交換
            - cashback: ウォレット退会時の払い戻し処理
            - expire: ウォレット退会時の残高失効処理
          enum: [topup, payment, transfer, exchange, cashback, expire]
        is_modified:
          type: boolean
          title: '返金された取引かどうか'
        sender:
          $ref: '#/components/schemas/User'
          title: '送金者情報'
        sender_account:
          $ref: '#/components/schemas/Account'
          title: '送金ウォレット情報'
        receiver:
          $ref: '#/components/schemas/User'
          title: '受取者情報'
        receiver_account:
          $ref: '#/components/schemas/Account'
          title: '受取ウォレット情報'
        amount:
          type: number
          title: '取引総額 (マネー額 + ポイント額)'
        money_amount:
          type: number
          title: '取引マネー額'
        point_amount:
          type: number
          title: '取引ポイント額(キャンペーン付与ポイント合算)'
          description: |
            取引のポイント額です。
            キャンペーンによるポイント付与額との合算値なので、元々の取引のポイント額のみを取り出したいときは `raw_point_amount` を参照してください。
            チャージ取引の場合、point_amount = raw_point_amount + campaign_point_amount
            支払い取引の場合、point_amount = raw_point_amount - campaign_point_amount
            が成立します。
        raw_point_amount:
          type: number
          title: '取引ポイント額'
          description: |
            取引のポイント額です。
            キャンペーンによるポイント付与額を含まない、元々の取引で支払われたポイント額を表します。
        campaign_point_amount:
          type: number
          title: 'キャンペーンによるポイント付与額'
        done_at:
          type: string
          format: date-time
          title: '取引日時'
        description:
          type: string
          title: '取引説明文'
        transfers:
          type: array
          items:
            $ref: '#/components/schemas/Transfer'
    BillTransaction:
      x-pokepay-schema-type: "response"
      properties:
        transaction:
          $ref: '#/components/schemas/Transaction'
        bill:
          $ref: '#/components/schemas/Bill'
    ShopWithMetadata:
      x-pokepay-schema-type: "response"
      properties:
        id:
          type: string
          format: uuid
          title: 店舗ID
        name:
          type: string
          title: 店舗名
        organization_code:
          type: string
          maxLength: 256
          title: 組織コード
        status:
          type: string
          enum: [active, disabled]
          title: '店舗の状態'
        postal_code:
          type: string
          nullable: true
          title: '店舗の郵便番号'
        address:
          type: string
          nullable: true
          title: '店舗の住所'
        tel:
          type: string
          nullable: true
          title: '店舗の電話番号'
        email:
          type: string
          nullable: true
          format: email
          maxLength: 256
          title: '店舗のメールアドレス'
        external_id:
          type: string
          nullable: true
          maxLength: 36
          title: '店舗の外部ID'
    ShopWithAccounts:
      x-pokepay-schema-type: "response"
      properties:
        id:
          type: string
          format: uuid
          title: 店舗ID
        name:
          type: string
          title: 店舗名
        organization_code:
          type: string
          maxLength: 256
          title: 組織コード
        status:
          type: string
          enum: [active, disabled]
          title: '店舗の状態'
        postal_code:
          type: string
          nullable: true
          title: '店舗の郵便番号'
        address:
          type: string
          nullable: true
          title: '店舗の住所'
        tel:
          type: string
          nullable: true
          title: '店舗の電話番号'
        email:
          type: string
          nullable: true
          format: email
          maxLength: 256
          title: '店舗のメールアドレス'
        external_id:
          type: string
          nullable: true
          maxLength: 36
          title: '店舗の外部ID'
        accounts:
          type: array
          items:
            $ref: '#/components/schemas/ShopAccount'
    BulkTransaction:
      x-pokepay-schema-type: "response"
      properties:
        id:
          type: string
          format: uuid
        request_id:
          type: string
          title: リクエストID
        name:
          type: string
          title: バルク取引管理用の名前
        description:
          type: string
          title: バルク取引管理用の説明文
        status:
          type: string
          enum:
            - submitted
            - examining
            - queued
            - processing
            - error
            - done
          title: バルク取引の状態
        error:
          type: string
          nullable: true
          title: バルク取引のエラー種別
        error_lineno:
          type: integer
          nullable: true
          title: バルク取引のエラーが発生した行番号
        submitted_at:
          type: string
          format: date-time
          title: バルク取引が登録された日時
        updated_at:
          type: string
          format: date-time
          title: バルク取引が更新された日時
    BulkTransactionJob:
      x-pokepay-schema-type: "response"
      properties:
        id:
          type: integer
        bulk_transaction:
          $ref: '#/components/schemas/BulkTransaction'
        type:
          type: string
          enum:
            - payment
            - topup
          title: 取引種別
        sender_account_id:
          type: string
          format: uuid
        receiver_account_id:
          type: string
          format: uuid
        money_amount:
          type: number
          format: decimal
          minimum: 0
        point_amount:
          type: number
          format: decimal
          minimum: 0
        description:
          type: string
          title: バルク取引ジョブ管理用の説明文
        bear_point_account_id:
          type: string
          format: uuid
        point_expires_at:
          type: string
          format: date-time
          nullable: true
          title: ポイント有効期限
        status:
          type: string
          enum:
            - queued
            - processing
            - done
            - error
          title: バルク取引ジョブの状態
        error:
          type: string
          nullable: true
          title: バルク取引のエラー種別
        lineno:
          type: integer
          nullable: true
          title: バルク取引のエラーが発生した行番号
        transaction_id:
          type: string
          format: uuid
          nullable: true
        created_at:
          type: string
          format: date-time
          title: バルク取引ジョブが登録された日時
        updated_at:
          type: string
          format: date-time
          title: バルク取引ジョブが更新された日時
    PaginatedBulkTransactionJob:
      x-pokepay-schema-type: "response"
      properties:
        rows:
          type: array
          items:
            $ref: '#/components/schemas/BulkTransactionJob'
        count:
          type: integer
          minimum: 0
        pagination:
          $ref: '#/components/schemas/Pagination'
    AccountWithoutPrivateMoneyDetail:
      x-pokepay-schema-type: "response"
      properties:
        id:
          type: string
          format: uuid
        name:
          type: string
        is_suspended:
          type: boolean
        status:
          type: string
          enum: [active, suspended, pre-closed, closed]
        private_money_id:
          type: string
          format: uuid
        user:
          $ref: '#/components/schemas/User'
    Transfer:
      x-pokepay-schema-type: "response"
      properties:
        id:
          type: string
          format: uuid
        sender_account:
          $ref: '#/components/schemas/AccountWithoutPrivateMoneyDetail'
        receiver_account:
          $ref: '#/components/schemas/AccountWithoutPrivateMoneyDetail'
        amount:
          type: number
          format: decimal
          minimum: 0
        money_amount:
          type: number
          format: decimal
          minimum: 0
        point_amount:
          type: number
          format: decimal
          minimum: 0
        done_at:
          type: string
          format: date-time
        type:
          type: string
          enum: [topup, payment, refund-topup, refund-payment, transfer, exchange-inflow, exchange-outflow, refund-exchange-inflow, refund-exchange-outflow, campaign-topup, refund-campaign, use-coupon, refund-coupon, cashback, expire]
        description:
          type: string
        transaction_id:
          type: string
          format: uuid
    ExternalTransaction:
      x-pokepay-schema-type: "response"
      properties:
        id:
          type: string
          format: uuid
          title: ポケペイ外部取引ID
        is_modified:
          type: boolean
          title: 返金された取引かどうか
        sender:
          $ref: '#/components/schemas/User'
          title: 送金者情報
        sender_account:
          $ref: '#/components/schemas/Account'
          title: 送金ウォレット情報
        receiver:
          $ref: '#/components/schemas/User'
          title: 受取者情報
        receiver_account:
          $ref: '#/components/schemas/Account'
          title: 受取ウォレット情報
        amount:
          type: number
          title: 決済額
        done_at:
          type: string
          format: date-time
          title: 取引日時
        description:
          type: string
          title: 取引説明文
    ExternalTransactionDetail:
      x-pokepay-schema-type: "response"
      properties:
        id:
          type: string
          format: uuid
          title: ポケペイ外部取引ID
        is_modified:
          type: boolean
          title: 返金された取引かどうか
        sender:
          $ref: '#/components/schemas/User'
          title: 送金者情報
        sender_account:
          $ref: '#/components/schemas/Account'
          title: 送金ウォレット情報
        receiver:
          $ref: '#/components/schemas/User'
          title: 受取者情報
        receiver_account:
          $ref: '#/components/schemas/Account'
          title: 受取ウォレット情報
        amount:
          type: number
          title: 決済額
        done_at:
          type: string
          format: date-time
          title: 取引日時
        description:
          type: string
          title: 取引説明文
        transaction:
          $ref: '#/components/schemas/TransactionDetail'
          nullable: true
          title: 関連ポケペイ取引詳細
          description: |
            ポケペイ外取引と連動して作られたポケペイ取引の取引詳細です。
            例えば、キャンペーンによるポイント付与取引やキャンセル状況などの情報が含まれます。
            ポケペイ取引が存在しない場合はnullが設定されます。

    Products:
      type: array
      items:
        type: object
        properties:
          jan_code:
            type: string
            maxLength: 64
          classification_code:
            type: string
            maxLength: 64
          name:
            type: string
            maxLength: 256
          unit_price:
            type: number
            minimum: 0
          price:
            type: number
            minimum: 0
          quantity:
            type: integer
            minimum: 1
          is_discounted:
            type: boolean
          other:
            type: string
            format: json
        example: |-
          {"jan_code":"abc",
           "name":"name1",
           "unit_price":100,
           "price": 100,
           "quantity": 1,
           "is_discounted": false,
           "other":"{}"}
      title: '商品情報データ'
      description:  |-
        一つの取引に含まれる商品情報データです。
        以下の内容からなるJSONオブジェクトの配列で指定します。

        - `jan_code`: JANコード。64字以下の文字列
        - `name`: 商品名。256字以下の文字列
        - `unit_price`: 商品単価。0以上の数値
        - `price`: 全体の金額(例: 商品単価 × 個数)。0以上の数値
        - `quantity`: 商品の個数。この値が指定された場合、priceから算出される個数よりも優先されます。
        - `is_discounted`: 賞味期限が近いなどの理由で商品が値引きされているかどうかのフラグ。boolean
        - `other`: その他商品に関する情報。JSONオブジェクトで指定します。

    Product:
      x-pokepay-schema-type: "response"
      properties:
        jan_code:
          type: string
          maxLength: 64
        name:
          type: string
          maxLength: 256
        unit_price:
          type: number
          minimum: 0
        price:
          type: number
          minimum: 0
        quantity:
          type: integer
          minimum: 1
          nullable: true
        is_discounted:
          type: boolean
        other:
          type: string
          format: json

    OrganizationSummary:
      x-pokepay-schema-type: "response"
      properties:
        count:
          type: integer
        money_amount:
          type: number
          format: decimal
          minimum: 0
        money_count:
          type: integer
        point_amount:
          type: number
          format: decimal
          minimum: 0
        raw_point_amount:
          type: number
          format: decimal
          minimum: 0
        campaign_point_amount:
          type: number
          format: decimal
          minimum: 0
        point_count:
          type: integer
    PrivateMoneyOrganizationSummary:
      x-pokepay-schema-type: "response"
      properties:
        organization_code:
          type: string
          pattern: '^[a-zA-Z0-9-]*$'
          maxLength: 32
        topup:
          $ref: '#/components/schemas/OrganizationSummary'
        payment:
          $ref: '#/components/schemas/OrganizationSummary'
    PaginatedPrivateMoneyOrganizationSummaries:
      x-pokepay-schema-type: "response"
      properties:
        rows:
          type: array
          items:
            $ref: '#/components/schemas/PrivateMoneyOrganizationSummary'
        count:
          type: integer
          minimum: 0
        pagination:
          $ref: '#/components/schemas/Pagination'
    PrivateMoneySummary:
      x-pokepay-schema-type: "response"
      properties:
        topup_amount:
          type: number
          format: decimal
        refunded_topup_amount:
          type: number
          format: decimal
        payment_amount:
          type: number
          format: decimal
        refunded_payment_amount:
          type: number
          format: decimal
        added_point_amount:
          type: number
          format: decimal
        topup_point_amount:
          type: number
          format: decimal
        campaign_point_amount:
          type: number
          format: decimal
        refunded_added_point_amount:
          type: number
          format: decimal
        exchange_inflow_amount:
          type: number
          format: decimal
        exchange_outflow_amount:
          type: number
          format: decimal
        transaction_count:
          type: integer
    UserStatsOperation:
      x-pokepay-schema-type: "response"
      properties:
        id:
          title: '集計処理ID'
          type: string
          format: uuid
        from:
          title: '集計期間の開始時刻'
          type: string
          format: date-time
        to:
          title: '集計期間の終了時刻'
          type: string
          format: date-time
        status:
          title: '集計処理の実行ステータス'
          type: string
          enum: [submitted, preprocessing, pending, processing, successed, error]
        error_reason:
          title: 'エラーとなった理由'
          type: string
          nullable: true
          example: null
        done_at:
          title: '集計処理の完了時刻'
          type: string
          format: date-time
          nullable: true
          example: null
        file_url:
          title: '集計結果のCSVのダウンロードURL'
          type: string
          nullable: true
          example: 'https://pokepay.s3.ap-northeast-1.amazonaws.com/user-stats/1CB9DC40-788F-423F-A2BF-6A5D72FB5B81.csv'
        requested_at:
          title: '集計リクエストを行った時刻'
          type: string
          format: date-time

    UserDevice:
      x-pokepay-schema-type: "response"
      properties:
        id:
          type: string
          format: uuid
          title: 'デバイスID'
        user:
          $ref: '#/components/schemas/User'
          title: 'デバイスを使用するユーザ'
        is_active:
          type: boolean
          title: 'デバイスが有効か'
        metadata:
          type: string
          format: json
          title: 'デバイスのメタデータ'

    BankRegisteringInfo:
      x-pokepay-schema-type: "response"
      properties:
        redirect_url:
          type: string
        paytree_customer_number:
          type: string
          nullable: true

    Bank:
      x-pokepay-schema-type: "response"
      properties:
        id:
          type: string
          format: uuid
        private_money:
          $ref: '#/components/schemas/PrivateMoney'
        bank_name:
          type: string
        bank_code:
          type: string
        branch_number:
          type: string
        branch_name:
          type: string
        deposit_type:
          type: string
        masked_account_number:
          type: string
        account_name:
          type: string

    Banks:
      x-pokepay-schema-type: "response"
      properties:
        rows:
          type: array
          items:
            $ref: '#/components/schemas/Bank'
        count:
          type: integer
          minimum: 0

    BankDeleted:
      x-pokepay-schema-type: "response"
      properties: {}

    PaginatedTransaction:
      x-pokepay-schema-type: "response"
      properties:
        rows:
          type: array
          items:
            $ref: '#/components/schemas/Transaction'
        count:
          type: integer
          minimum: 0
        pagination:
          $ref: '#/components/schemas/Pagination'
    PaginatedTransactionV2:
      x-pokepay-schema-type: "response"
      properties:
        rows:
          type: array
          items:
            $ref: '#/components/schemas/Transaction'
        per_page:
          type: integer
        count:
          type: integer
        next_page_cursor_id:
          type: string
          format: uuid
          nullable: true
          description: |-
            次ページ取得するためのID。

            実際にはrows末尾
        prev_page_cursor_id:
          type: string
          format: uuid
          nullable: true
          description: |-
            前ページ取得するためのID。

            実際にはrows先頭
    PaginatedBillTransaction:
      x-pokepay-schema-type: "response"
      properties:
        rows:
          type: array
          items:
            $ref: '#/components/schemas/BillTransaction'
        per_page:
          type: integer
        count:
          type: integer
        next_page_cursor_id:
          type: string
          format: uuid
          nullable: true
          description: |-
            次ページ取得するためのID。次ページ取得するためのID。
            実際にはrows末尾
        prev_page_cursor_id:
          type: string
          format: uuid
          nullable: true
          description: |-
            前ページ取得するためのID。

            実際にはrows先頭
    PaginatedTransfers:
      x-pokepay-schema-type: "response"
      properties:
        rows:
          type: array
          items:
            $ref: '#/components/schemas/Transfer'
        count:
          type: integer
          minimum: 0
        pagination:
          $ref: '#/components/schemas/Pagination'

    PaginatedTransfersV2:
      x-pokepay-schema-type: "response"
      properties:
        rows:
          type: array
          items:
            $ref: '#/components/schemas/Transfer'
        per_page:
          type: integer
        count:
          type: integer
        next_page_cursor_id:
          type: string
          format: uuid
          nullable: true
          description: |-
            次ページ取得するためのID。

            実際にはrows末尾
        prev_page_cursor_id:
          type: string
          format: uuid
          nullable: true
          description: |-
            前ページ取得するためのID。

            実際にはrows先頭

    PaginatedAccounts:
      x-pokepay-schema-type: "response"
      properties:
        rows:
          type: array
          items:
            $ref: '#/components/schemas/Account'
        count:
          type: integer
          minimum: 0
        pagination:
          $ref: '#/components/schemas/Pagination'
    PaginatedAccountWithUsers:
      x-pokepay-schema-type: "response"
      properties:
        rows:
          type: array
          items:
            $ref: '#/components/schemas/AccountWithUser'
        count:
          type: integer
          minimum: 0
        pagination:
          $ref: '#/components/schemas/Pagination'
    PaginatedAccountDetails:
      x-pokepay-schema-type: "response"
      properties:
        rows:
          type: array
          items:
            $ref: '#/components/schemas/AccountDetail'
        count:
          type: integer
          minimum: 0
        pagination:
          $ref: '#/components/schemas/Pagination'
    PaginatedAccountBalance:
      x-pokepay-schema-type: "response"
      properties:
        rows:
          type: array
          items:
            $ref: '#/components/schemas/AccountBalance'
        count:
          type: integer
          minimum: 0
        pagination:
          $ref: '#/components/schemas/Pagination'
    PaginatedShops:
      x-pokepay-schema-type: "response"
      properties:
        rows:
          type: array
          items:
            $ref: '#/components/schemas/ShopWithMetadata'
        count:
          type: integer
          minimum: 0
        pagination:
          $ref: '#/components/schemas/Pagination'
    PaginatedBills:
      x-pokepay-schema-type: "response"
      properties:
        rows:
          type: array
          items:
            $ref: '#/components/schemas/Bill'
        count:
          type: integer
          minimum: 0
        pagination:
          $ref: '#/components/schemas/Pagination'
    PaginatedPrivateMoneys:
      x-pokepay-schema-type: "response"
      properties:
        rows:
          type: array
          items:
            $ref: '#/components/schemas/PrivateMoney'
        count:
          type: integer
          minimum: 0
        pagination:
          $ref: '#/components/schemas/Pagination'
    Campaign:
      x-pokepay-schema-type: "response"
      properties:
        id:
          type: string
          format: uuid
          title: 'キャンペーンID'
        name:
          type: string
          maxLength: 256
          title: 'キャペーン名'
        applicable_shops:
          type: array
          title: 'キャンペーン適用対象の店舗リスト'
          nullable: true
          items:
            $ref: '#/components/schemas/User'
        is_exclusive:
          type: boolean
          title: 'キャンペーンの重複を許すかどうかのフラグ'
        starts_at:
          type: string
          format: date-time
          title: 'キャンペーン開始日時'
        ends_at:
          type: string
          format: date-time
          title: 'キャンペーン終了日時'
        point_expires_at:
          type: string
          format: date-time
          title: 'キャンペーンによって付与されるポイントの失効日時'
          nullable: true
        point_expires_in_days:
          type: integer
          minimum: 1
          title: 'キャンペーンによって付与されるポイントの有効期限(相対指定、単位は日)'
          nullable: true
        priority:
          type: integer
          title: 'キャンペーンの優先順位'
        description:
          type: string
          maxLength: 200
          title: 'キャンペーン説明文'
        bear_point_shop:
          title: 'ポイントを負担する店舗'
          $ref: '#/components/schemas/User'
        private_money:
          title: 'キャンペーンを適用するマネー'
          $ref: '#/components/schemas/PrivateMoney'
        dest_private_money:
          title: 'ポイントを付与するマネー'
          $ref: '#/components/schemas/PrivateMoney'
        max_total_point_amount:
          title: '一人当たりの累計ポイント上限'
          type: integer
          minimum: 1
          nullable: true
        point_calculation_rule:
          type: string
          title: 'ポイント計算ルール (banklisp表記)'
        point_calculation_rule_object:
          type: string
          format: json
          title: 'ポイント計算ルール (JSON文字列による表記)'
        status:
          type: string
          enum: [enabled, disabled]
          title: 'キャンペーンの現在の状態'
        budget_caps_amount:
          title: 'キャンペーンの予算上限額'
          type: integer
          nullable: true
        budget_current_amount:
          title: 'キャンペーンの付与合計額'
          type: integer
          nullable: true
        budget_current_time:
          title: 'キャンペーンの付与集計日時'
          type: string
          format: date-time
          nullable: true

    PaginatedCampaigns:
      x-pokepay-schema-type: "response"
      properties:
        rows:
          type: array
          items:
            $ref: '#/components/schemas/Campaign'
        count:
          type: integer
          minimum: 0
        pagination:
          $ref: '#/components/schemas/Pagination'
    AccountTransferSummaryElement:
      x-pokepay-schema-type: "response"
      properties:
        transfer_type:
          type: string
          enum: [payment, topup, campaign-topup, use-coupon, refund-payment, refund-topup, refund-campaign, refund-coupon, exchange-inflow, exchange-outflow, refund-exchange-inflow, refund-exchange-outflow]
        money_amount:
          type: number
          format: decimal
        point_amount:
          type: number
          format: decimal
        count:
          type: number
          format: decimal
    AccountTransferSummary:
      x-pokepay-schema-type: "response"
      properties:
        summaries:
          type: array
          items:
            $ref: '#/components/schemas/AccountTransferSummaryElement'
    OrganizationWorkerTaskWebhook:
      x-pokepay-schema-type: "response"
      properties:
        id:
          type: string
          format: uuid
        organization_code:
          type: string
        task:
          type: string
        url:
          type: string
        content_type:
          type: string
        is_active:
          type: boolean
    PaginatedOrganizationWorkerTaskWebhook:
      x-pokepay-schema-type: "response"
      properties:
        rows:
          type: array
          items:
            $ref: '#/components/schemas/OrganizationWorkerTaskWebhook'
        count:
          type: integer
          minimum: 0
        pagination:
          $ref: '#/components/schemas/Pagination'
    Coupon:
      x-pokepay-schema-type: "response"
      properties:
        id:
          type: string
          format: uuid
          title: 'クーポンID'
        name:
          type: string
          title: 'クーポン名'
        issued_shop:
          $ref: '#/components/schemas/User'
          title: 'クーポン発行店舗'
        description:
          type: string
          title: 'クーポンの説明文'
        discount_amount:
          type: integer
          nullable: true
          title: 'クーポンによる値引き額(絶対値指定)'
        discount_percentage:
          type: number
          nullable: true
          title: 'クーポンによる値引き率'
        discount_upper_limit:
          type: integer
          nullable: true
          title: 'クーポンによる値引き上限(値引き率が指定された場合の値引き上限額)'
        starts_at:
          type: string
          format: date-time
          title: 'クーポンの利用可能期間(開始日時)'
        ends_at:
          type: string
          format: date-time
          title: 'クーポンの利用可能期間(終了日時)'
        display_starts_at:
          type: string
          format: date-time
          title: 'クーポンの掲載期間(開始日時)'
        display_ends_at:
          type: string
          format: date-time
          title: 'クーポンの掲載期間(終了日時)'
        usage_limit:
          type: integer
          nullable: true
          title: 'ユーザごとの利用可能回数(NULLの場合は無制限)'
        min_amount:
          type: integer
          nullable: true
          title: 'クーポン適用可能な最小取引額'
        is_shop_specified:
          type: boolean
          title: '特定店舗限定のクーポンかどうか'
        is_hidden:
          type: boolean
          title: 'クーポン一覧に掲載されるかどうか'
          description: |
            アプリに表示されるクーポン一覧に掲載されるかどうか。
            主に一時的に掲載から外したいときに用いられる。そのためis_publicの設定よりも優先される。
        is_public:
          type: boolean
          title: 'アプリ配信なしで受け取れるかどうか'
        code:
          type: string
          nullable: true
          title: 'クーポン受け取りコード'
        is_disabled:
          type: boolean
          title: '無効化フラグ'
        token:
          type: string
          title: 'クーポンを特定するためのトークン'
    CouponDetail:
      x-pokepay-schema-type: "response"
      properties:
        id:
          type: string
          format: uuid
          title: 'クーポンID'
        name:
          type: string
          title: 'クーポン名'
        issued_shop:
          $ref: '#/components/schemas/User'
          title: 'クーポン発行店舗'
        description:
          type: string
          title: 'クーポンの説明文'
        discount_amount:
          type: integer
          nullable: true
          title: 'クーポンによる値引き額(絶対値指定)'
        discount_percentage:
          type: number
          nullable: true
          title: 'クーポンによる値引き率'
        discount_upper_limit:
          type: integer
          nullable: true
          title: 'クーポンによる値引き上限(値引き率が指定された場合の値引き上限額)'
        starts_at:
          type: string
          format: date-time
          title: 'クーポンの利用可能期間(開始日時)'
        ends_at:
          type: string
          format: date-time
          title: 'クーポンの利用可能期間(終了日時)'
        display_starts_at:
          type: string
          format: date-time
          title: 'クーポンの掲載期間(開始日時)'
        display_ends_at:
          type: string
          format: date-time
          title: 'クーポンの掲載期間(終了日時)'
        usage_limit:
          type: integer
          nullable: true
          title: 'ユーザごとの利用可能回数(NULLの場合は無制限)'
        min_amount:
          type: integer
          nullable: true
          title: 'クーポン適用可能な最小取引額'
        is_shop_specified:
          type: boolean
          title: '特定店舗限定のクーポンかどうか'
        is_hidden:
          type: boolean
          title: 'クーポン一覧に掲載されるかどうか'
          description: |
            アプリに表示されるクーポン一覧に掲載されるかどうか。
            主に一時的に掲載から外したいときに用いられる。そのためis_publicの設定よりも優先される。
        is_public:
          type: boolean
          title: 'アプリ配信なしで受け取れるかどうか'
        code:
          type: string
          nullable: true
          title: 'クーポン受け取りコード'
        is_disabled:
          type: boolean
          title: '無効化フラグ'
        token:
          type: string
          title: 'クーポンを特定するためのトークン'
        coupon_image:
          type: string
          nullable: true
          title: 'クーポン画像のURL'
        available_shops:
          type: array
          items:
            $ref: '#/components/schemas/User'
          title: '利用可能店舗リスト'
        private_money:
          $ref: '#/components/schemas/PrivateMoney'
          title: 'クーポンのマネー'
    PaginatedCoupons:
      x-pokepay-schema-type: "response"
      properties:
        rows:
          type: array
          items:
            $ref: '#/components/schemas/Coupon'
        count:
          type: integer
          minimum: 0
        pagination:
          $ref: '#/components/schemas/Pagination'
    PaginatedOrganizations:
      x-pokepay-schema-type: "response"
      properties:
        rows:
          type: array
          items:
            $ref: '#/components/schemas/Organization'
        count:
          type: integer
          minimum: 0
        pagination:
          $ref: '#/components/schemas/Pagination'

    SevenBankATMSession:
      x-pokepay-schema-type: "response"
      properties:
        qr_info:
          type: string
          maxLength: 23
        account:
          $ref: '#/components/schemas/AccountDetail'
        amount:
          type: integer
        transaction:
          $ref: '#/components/schemas/Transaction'
          nullable: true
        seven_bank_customer_number:
          type: string
        atm_id:
          type: string
          maxLength: 7
          nullable: true
        audi_id:
          type: string
          maxLength: 4
          nullable: true
        issuer_code:
          type: string
          nullable: true
        issuer_name:
          type: string
          nullable: true
        money_name:
          type: string
          nullable: true

    BadRequest:
      x-pokepay-schema-type: "response"
      oneOf:
        - $ref: '#/components/schemas/PartnerClientNotFound'
        - $ref: '#/components/schemas/PartnerDecryptionFailed'
        - $ref: '#/components/schemas/PartnerRequestExpired'
        - $ref: '#/components/schemas/PartnerRequestAlreadyDone'
        - $ref: '#/components/schemas/InvalidParameters'
    PartnerClientNotFound:
      x-pokepay-schema-type: "response"
      properties:
        type:
          type: string
          pattern: '^partner_client_not_found$'
        message:
          type: string
    PartnerDecryptionFailed:
      x-pokepay-schema-type: "response"
      properties:
        type:
          type: string
          pattern: '^partner_decryption_failed$'
        message:
          type: string
    PartnerRequestExpired:
      x-pokepay-schema-type: "response"
      properties:
        type:
          type: string
          pattern: '^partner_request_expired$'
        message:
          type: string
          example: 'This request is expired.'
    PartnerRequestAlreadyDone:
      x-pokepay-schema-type: "response"
      properties:
        type:
          type: string
          pattern: '^partner_request_already_done$'
        message:
          type: string
    InvalidParameters:
      x-pokepay-schema-type: "response"
      properties:
        type:
          type: string
          pattern: '^invalid_parameter'
        message:
          type: string
        errors:
          type: object
          properties:
            missing:
              type: array
              nullable: true
              items:
                type: string
            invalid:
              type: array
              nullable: true
              items:
                type: string
            unpermitted:
              type: array
              nullable: true
              items:
                type: string
    Forbidden:
      properties:
        type:
          type: string
          example: forbidden
        message:
          type: string
          example: Forbidden
    UnpermittedAdminUser:
      x-pokepay-schema-type: "response"
      properties:
        type:
          type: string
          pattern: '^unpermitted_admin_user$'
        message:
          type: string
    NotFound:
      properties:
        type:
          type: string
          example: api_error
        message:
          type: string
          example: Not Found
    UnprocessableEntity:
      properties:
        type:
          type: string
          example: unprocessable
        message:
          type: string
    Conflict:
      properties:
        type:
          type: string
        message:
          type: string
    TemporarilyUnavailable:
      properties:
        type:
          type: string
          pattern: '^temporarily_unavailable$'
        message:
          type: string
    UserStatsOperationServiceUnavailable:
      x-pokepay-schema-type: "response"
      properties:
        type:
          type: string
          pattern: '^user_stats_operation_service_unavailable$'
        message:
          type: string

    PrivateMoneyNotAvailable:
      properties:
        type:
          type: string
          pattern: '^unpermitted_private_money$'
        message:
          type: string
          example: 'This money is not available'
        object:
          type: array
          items:
            type: string
            format: uuid

  responses:
    BadRequest:
      description: Bad Request
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/BadRequest'
    InvalidParameters:
      description: Invalid Parameters
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/InvalidParameters'
    Forbidden:
      description: Forbidden
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Forbidden'
    UnpermittedAdminUser:
      description: Unpermitted Admin User
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/UnpermittedAdminUser'
    NotFound:
      description: Not Found
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/NotFound'
    UnprocessableEntity:
      description: Unprocessable Entity
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/UnprocessableEntity'
    Conflict:
      description: Conflict
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Conflict'
    UserStatsOperationServiceUnavailable:
      description: User stats operation service is temporarily unavailable
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/UserStatsOperationServiceUnavailable'

paths:
  /ping:
    get:
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Pong'
  /echo:
    post:
      x-pokepay-operator-name: "SendEcho"
      x-pokepay-allow-server-side: true
      requestBody:
        required: true
        content:
          application/json:
            schema:
              required: ["message"]
              properties:
                message:
                  type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Echo'
        '400':
          $ref: '#/components/responses/BadRequest'
  /user:
    get:
      tags:
        - User
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AdminUserWithShopsAndPrivateMoneys'
  /users/{user_id}/accounts:
    get:
      tags:
        - Account
      summary: 'エンドユーザー、店舗ユーザーのウォレット一覧を表示する'
      description: ユーザーIDを指定してそのユーザーのウォレット一覧を取得します。
      x-pokepay-operator-name: "ListUserAccounts"
      x-pokepay-allow-server-side: true
      parameters:
        - in: path
          name: user_id
          required: true
          schema:
            type: string
            format: uuid
            title: 'ユーザーID'
          description: |-
            ユーザーIDです。

            指定したユーザーIDのウォレット一覧を取得します。パートナーキーと紐づく組織が発行しているマネーのウォレットのみが表示されます。
      requestBody:
        required: true
        content:
          application/json:
            schema:
              properties:
                page:
                  type: integer
                  minimum: 1
                  title: 'ページ番号'
                  description: 取得したいページ番号です。デフォルト値は1です。
                per_page:
                  type: integer
                  minimum: 1
                  title: '1ページ分の取引数'
                  description: 1ページ当たりのウォレット数です。デフォルト値は50です。
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedAccountDetails'
        '400':
          $ref: '#/components/responses/BadRequest'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
    post:
      tags:
        - Account
      summary: 'エンドユーザーのウォレットを作成する'
      description: |-
        既存のエンドユーザーに対して、指定したマネーのウォレットを新規作成します
      x-pokepay-operator-name: "CreateUserAccount"
      x-pokepay-allow-server-side: true
      parameters:
        - in: path
          name: user_id
          required: true
          schema:
            type: string
            format: uuid
            title: 'ユーザーID'
          description: |-
            ユーザーIDです。
      requestBody:
        required: true
        content:
          application/json:
            schema:
              required: ["private_money_id"]
              properties:
                private_money_id:
                  title: 'マネーID'
                  description: |-
                    マネーIDです。

                    作成するウォレットのマネーを指定します。このパラメータは必須です。
                  type: string
                  format: uuid
                name:
                  title: 'ウォレット名'
                  type: string
                  maxLength: 256
                external_id:
                  title: '外部ID'
                  type: string
                  maxLength: 50
                metadata:
                  type: string
                  format: json
                  title: 'ウォレットに付加するメタデータ'
                  description: |-
                    ウォレットに付加するメタデータをJSON文字列で指定します。
                    指定できるJSON文字列には以下のような制約があります。
                    - フラットな構造のJSONを文字列化したものであること。
                    - keyは最大32文字の文字列(同じkeyを複数指定することはできません)
                    - valueには128文字以下の文字列が指定できます
                  example: |-
                    {"key1":"foo","key2":"bar"}
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountDetail'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'
  /accounts/{account_id}:
    get:
      tags:
        - Customer
      summary: 'ウォレット情報を表示する'
      description: ウォレットを取得します。
      x-pokepay-operator-name: "GetAccount"
      x-pokepay-allow-server-side: true
      parameters:
        - in: path
          name: account_id
          required: true
          schema:
            type: string
            format: uuid
            title: 'ウォレットID'
          description: |-
            ウォレットIDです。

            フィルターとして使われ、指定したウォレットIDのウォレットを取得します。
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountDetail'
        '400':
          $ref: '#/components/responses/BadRequest'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
    patch:
      tags:
        - Customer
      summary: 'ウォレット情報を更新する'
      description: |-
        ウォレットの状態を更新します。
        以下の項目が変更できます。

        - ウォレットの凍結/凍結解除の切り替え(エンドユーザー、店舗ユーザー共通)
        - 店舗でチャージ可能かどうか(店舗ユーザのみ)

        エンドユーザーのウォレット情報更新には UpdateCustomerAccount が使用できます。
      x-pokepay-operator-name: "UpdateAccount"
      x-pokepay-allow-server-side: true
      parameters:
        - in: path
          name: account_id
          required: true
          schema:
            type: string
            format: uuid
            title: 'ウォレットID'
          description: |-
            ウォレットIDです。

            指定したウォレットIDのウォレットの状態を更新します。
      requestBody:
        required: true
        content:
          application/json:
            schema:
              properties:
                is_suspended:
                  type: boolean
                  title: 'ウォレットが凍結されているかどうか'
                  description: ウォレットの凍結状態です。真にするとウォレットが凍結され、そのウォレットでは新規取引ができなくなります。偽にすると凍結解除されます。
                status:
                  type: string
                  enum: [active, suspended, pre-closed]
                  title: 'ウォレット状態'
                  description: ウォレットの状態です。
                can_transfer_topup:
                  type: boolean
                  title: 'チャージ可能かどうか'
                  description: 店舗ユーザーがエンドユーザーにチャージ可能かどうかです。真にするとチャージ可能となり、偽にするとチャージ不可能となります。
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountDetail'
        '400':
          $ref: '#/components/responses/BadRequest'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
    delete:
      tags:
        - Customer
      summary: 'ウォレットを退会する'
      description: ウォレットを退会します。一度ウォレットを退会した後は、そのウォレットを再び利用可能な状態に戻すことは出来ません。
      x-pokepay-operator-name: "DeleteAccount"
      x-pokepay-allow-server-side: true
      parameters:
        - in: path
          name: account_id
          required: true
          schema:
            type: string
            format: uuid
            title: 'ウォレットID'
          description: |-
            ウォレットIDです。

            指定したウォレットIDのウォレットを退会します。
      requestBody:
        required: true
        content:
          application/json:
            schema:
              properties:
                cashback:
                  type: boolean
                  title: '返金有無'
                  description: 退会時の返金有無です。エンドユーザに返金を行う場合、真を指定して下さい。現在のマネー残高を全て現金で返金したものとして記録されます。
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountDeleted'
        '400':
          $ref: '#/components/responses/BadRequest'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'

  /accounts/{account_id}/balances:
    get:
      tags:
        - Customer
      summary: 'エンドユーザーの残高内訳を表示する'
      description: エンドユーザーのウォレット毎の残高を有効期限別のリストとして取得します。
      x-pokepay-operator-name: "ListAccountBalances"
      x-pokepay-allow-server-side: true
      parameters:
        - name: account_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
            title: 'ウォレットID'
          description: |-
            ウォレットIDです。

            フィルターとして使われ、指定したウォレットIDのウォレット残高を取得します。
      requestBody:
        required: true
        content:
          application/json:
            schema:
              properties:
                page:
                  type: integer
                  minimum: 1
                  title: 'ページ番号'
                  description: 取得したいページ番号です。デフォルト値は1です。
                per_page:
                  type: integer
                  minimum: 1
                  title: '1ページ分の取引数'
                  description: 1ページ分のウォレット残高数です。デフォルト値は30です。
                expires_at_from:
                  type: string
                  format: date-time
                  title: '有効期限の期間によるフィルター(開始時点)'
                  description: 有効期限の期間によるフィルターの開始時点のタイムスタンプです。デフォルトでは未指定です。
                expires_at_to:
                  type: string
                  format: date-time
                  title: '有効期限の期間によるフィルター(終了時点)'
                  description: 有効期限の期間によるフィルターの終了時点のタイムスタンプです。デフォルトでは未指定です。
                direction:
                  type: string
                  enum: [asc, desc]
                  title: '有効期限によるソート順序'
                  description: 有効期限によるソートの順序を指定します。デフォルト値はasc (昇順)です。
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedAccountBalance'
        '400':
          $ref: '#/components/responses/BadRequest'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
  /accounts/{account_id}/expired-balances:
    get:
      tags:
        - Customer
      summary: 'エンドユーザーの失効済みの残高内訳を表示する'
      description: エンドユーザーのウォレット毎の失効済みの残高を有効期限別のリストとして取得します。
      x-pokepay-operator-name: "ListAccountExpiredBalances"
      x-pokepay-allow-server-side: true
      parameters:
        - name: account_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
            title: 'ウォレットID'
          description: |-
            ウォレットIDです。

            フィルターとして使われ、指定したウォレットIDのウォレット残高を取得します。
      requestBody:
        required: true
        content:
          application/json:
            schema:
              properties:
                page:
                  type: integer
                  minimum: 1
                  title: 'ページ番号'
                  description: 取得したいページ番号です。デフォルト値は1です。
                per_page:
                  type: integer
                  minimum: 1
                  title: '1ページ分の取引数'
                  description: 1ページ分のウォレット残高数です。デフォルト値は30です。
                expires_at_from:
                  type: string
                  format: date-time
                  title: '有効期限の期間によるフィルター(開始時点)'
                  description: 有効期限の期間によるフィルターの開始時点のタイムスタンプです。デフォルトでは未指定です。
                expires_at_to:
                  type: string
                  format: date-time
                  title: '有効期限の期間によるフィルター(終了時点)'
                  description: 有効期限の期間によるフィルターの終了時点のタイムスタンプです。デフォルトでは未指定です。
                direction:
                  type: string
                  enum: [asc, desc]
                  title: '有効期限によるソート順序'
                  description: 有効期限によるソートの順序を指定します。デフォルト値はdesc (降順)です。
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedAccountBalance'
        '400':
          $ref: '#/components/responses/BadRequest'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
  /accounts/{account_id}/customers:
    patch:
      tags:
        - Customer
      summary: 'エンドユーザーのウォレット情報を更新する'
      description: エンドユーザーのウォレットの状態を更新します。
      x-pokepay-operator-name: "UpdateCustomerAccount"
      x-pokepay-allow-server-side: true
      parameters:
        - in: path
          name: account_id
          required: true
          schema:
            type: string
            format: uuid
            title: 'ウォレットID'
          description: |-
            ウォレットIDです。

            指定したウォレットIDのウォレットの状態を更新します。
      requestBody:
        required: true
        content:
          application/json:
            schema:
              properties:
                status:
                  type: string
                  enum: [active, suspended, pre-closed]
                  title: 'ウォレット状態'
                  description: ウォレットの状態です。
                account_name:
                  title: 'アカウント名'
                  type: string
                  maxLength: 256
                  description: 変更するウォレット名です。
                external_id:
                  title: '外部ID'
                  type: string
                  maxLength: 50
                  description: 変更する外部IDです。
                metadata:
                  type: string
                  format: json
                  title: 'ウォレットに付加するメタデータ'
                  description: |-
                    ウォレットに付加するメタデータをJSON文字列で指定します。
                    指定できるJSON文字列には以下のような制約があります。
                    - フラットな構造のJSONを文字列化したものであること。
                    - keyは最大32文字の文字列(同じkeyを複数指定することはできません)
                    - valueには128文字以下の文字列が指定できます

                    更新時に指定した内容でメタデータ全体が置き換えられることに注意してください。
                    例えば、元々のメタデータが以下だったときに、

                    '{"key1":"foo","key2":"bar"}'

                    更新APIで以下のように更新するとします。

                    '{"key1":"baz"}'

                    このときkey1はfooからbazに更新され、key2に対するデータは消去されます。

                  example: |-
                    {"key1":"foo","key2":"bar"}
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountWithUser'
        '400':
          $ref: '#/components/responses/BadRequest'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'
  /accounts/{account_id}/transfers/summary:
    get:
      tags:
        - Transfer
      summary: ''
      description: ウォレットを指定して取引明細種別毎の集計を返す
      x-pokepay-operator-name: "GetAccountTransferSummary"
      x-pokepay-allow-server-side: true
      parameters:
        - name: account_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
            title: 'ウォレットID'
          description: |-
            ウォレットIDです。

            ここで指定したウォレットIDの取引明細レベルでの集計を取得します。
      requestBody:
        required: true
        content:
          application/json:
            schema:
              properties:
                from:
                  type: string
                  format: date-time
                  title: '集計期間の開始時刻'
                to:
                  type: string
                  format: date-time
                  title: '集計期間の終了時刻'
                transfer_types:
                  type: array
                  title: '取引明細種別 (複数指定可)'
                  example: '["topup", "payment"]'
                  description: |-
                    取引明細の種別でフィルターします。
                    以下の種別を指定できます。

                    - payment
                      エンドユーザーから店舗への送金取引(支払い取引)
                    - topup
                      店舗からエンドユーザーへの送金取引(チャージ取引)
                    - campaign-topup
                      キャンペーンによるエンドユーザーへのポイント付与取引(ポイントチャージ)
                    - use-coupon
                      支払い時のクーポン使用による値引き取引
                    - refund-payment
                      支払い取引に対するキャンセル取引
                    - refund-topup
                      チャージ取引に対するキャンセル取引
                    - refund-campaign
                      キャンペーンによるポイント付与取引に対するキャンセル取引
                    - refund-coupon
                      クーポン使用による値引き取引に対するキャンセル取引
                    - exchange-inflow
                      交換による他マネーからの流入取引
                    - exchange-outflow
                      交換による他マネーへの流出取引
                    - refund-exchange-inflow
                      交換による他マネーからの流入取引に対するキャンセル取引
                    - refund-exchange-outflow
                      交換による他マネーへの流出取引に対するキャンセル取引
                  items:
                    type: string
                    enum: [payment, topup, campaign-topup, use-coupon, refund-payment, refund-topup, refund-campaign, refund-coupon, exchange-inflow, exchange-outflow, refund-exchange-inflow, refund-exchange-outflow]
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountTransferSummary'
        '400':
          $ref: '#/components/responses/InvalidParameters'
        '403':
          $ref: '#/components/responses/UnpermittedAdminUser'
        '404':
          $ref: '#/components/responses/NotFound'
  /accounts/customers:
    get:
      tags:
        - Customer
      summary: 'エンドユーザーのウォレット一覧を表示する'
      description: マネーを指定してエンドユーザーのウォレット一覧を取得します。
      x-pokepay-operator-name: "GetCustomerAccounts"
      x-pokepay-allow-server-side: true
      requestBody:
        required: true
        content:
          application/json:
            schema:
              required: ["private_money_id"]
              properties:
                private_money_id:
                  title: 'マネーID'
                  description: |-
                    マネーIDです。

                    一覧するウォレットのマネーを指定します。このパラメータは必須です。
                  type: string
                  format: uuid
                page:
                  type: integer
                  minimum: 1
                  title: 'ページ番号'
                  description: 取得したいページ番号です。デフォルト値は1です。
                per_page:
                  type: integer
                  minimum: 1
                  title: '1ページ分のウォレット数'
                  description: 1ページ分のウォレット数です。デフォルト値は30です。
                created_at_from:
                  type: string
                  format: date-time
                  title: 'ウォレット作成日によるフィルター(開始時点)'
                  description: ウォレット作成日によるフィルターの開始時点のタイムスタンプです。デフォルトでは未指定です。
                created_at_to:
                  type: string
                  format: date-time
                  title: 'ウォレット作成日によるフィルター(終了時点)'
                  description: ウォレット作成日によるフィルターの終了時点のタイムスタンプです。デフォルトでは未指定です。
                is_suspended:
                  type: boolean
                  title: 'ウォレットが凍結状態かどうかでフィルターする'
                  description: このパラメータが指定されている場合、ウォレットの凍結状態で結果がフィルターされます。デフォルトでは未指定です。
                status:
                  type: string
                  enum: [active, suspended, pre-closed]
                  title: 'ウォレット状態'
                  description: このパラメータが指定されている場合、ウォレットの状態で結果がフィルターされます。デフォルトでは未指定です。
                external_id:
                  type: string
                  maxLength: 50
                  title: '外部ID'
                  description: 外部IDでのフィルタリングです。デフォルトでは未指定です。
                tel:
                  type: string
                  pattern: '^0[0-9]{1,3}-?[0-9]{2,4}-?[0-9]{3,4}$'
                  title: 'エンドユーザーの電話番号'
                  description: エンドユーザーの電話番号でのフィルタリングです。デフォルトでは未指定です。
                email:
                  type: string
                  format: email
                  title: 'エンドユーザーのメールアドレス'
                  description: エンドユーザーのメールアドレスでのフィルタリングです。デフォルトでは未指定です。
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedAccountWithUsers'
        '400':
          $ref: '#/components/responses/BadRequest'
        '403':
          $ref: '#/components/responses/Forbidden'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'
    post:
      tags:
        - Customer
      summary: '新規エンドユーザーをウォレットと共に追加する'
      description: |-
        指定したマネーのウォレットを作成し、同時にそのウォレットを保有するユーザも新規に作成します。
        このAPIにより作成されたユーザは認証情報を持たないため、モバイルSDKやポケペイ標準アプリからはログインすることはできません。
        Partner APIのみから操作可能な特殊なユーザになります。
        システム全体をPartner APIのみで構成する場合にのみ使用してください。
      x-pokepay-operator-name: "CreateCustomerAccount"
      x-pokepay-allow-server-side: true
      requestBody:
        required: true
        content:
          application/json:
            schema:
              required: ["private_money_id"]
              properties:
                private_money_id:
                  title: 'マネーID'
                  description: |-
                    マネーIDです。

                    これによって作成するウォレットのマネーを指定します。
                  type: string
                  format: uuid
                user_name:
                  title: 'ユーザー名'
                  description: |-
                    ウォレットと共に作成するユーザ名です。省略した場合は空文字となります。
                  type: string
                  maxLength: 256
                  example: ポケペイ太郎
                account_name:
                  title: 'アカウント名'
                  description: |-
                    作成するウォレット名です。省略した場合は空文字となります。
                  type: string
                  maxLength: 256
                  example: ポケペイ太郎のアカウント
                external_id:
                  title: '外部ID'
                  description: |-
                    PAPIクライアントシステムから利用するPokepayユーザーのIDです。デフォルトでは未指定です。
                  type: string
                  maxLength: 50
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountWithUser'
        '400':
          $ref: '#/components/responses/BadRequest'
        '403':
          $ref: '#/components/responses/Forbidden'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'
  /accounts/shops:
    get:
      tags:
        - Customer
      summary: '店舗ユーザーのウォレット一覧を表示する'
      description: マネーを指定して店舗ユーザーのウォレット一覧を取得します。
      x-pokepay-operator-name: "GetShopAccounts"
      x-pokepay-allow-server-side: true
      requestBody:
        required: true
        content:
          application/json:
            schema:
              required: ["private_money_id"]
              properties:
                private_money_id:
                  title: 'マネーID'
                  description: |-
                    マネーIDです。

                    一覧するウォレットのマネーを指定します。このパラメータは必須です。
                  type: string
                  format: uuid
                page:
                  type: integer
                  minimum: 1
                  title: 'ページ番号'
                  description: 取得したいページ番号です。デフォルト値は1です。
                per_page:
                  type: integer
                  minimum: 1
                  title: '1ページ分のウォレット数'
                  description: 1ページ分のウォレット数です。デフォルト値は30です。
                created_at_from:
                  type: string
                  format: date-time
                  title: 'ウォレット作成日によるフィルター(開始時点)'
                  description: ウォレット作成日によるフィルターの開始時点のタイムスタンプです。デフォルトでは未指定です。
                created_at_to:
                  type: string
                  format: date-time
                  title: 'ウォレット作成日によるフィルター(終了時点)'
                  description: ウォレット作成日によるフィルターの終了時点のタイムスタンプです。デフォルトでは未指定です。
                is_suspended:
                  type: boolean
                  title: 'ウォレットが凍結状態かどうかでフィルターする'
                  description: このパラメータが指定されている場合、ウォレットの凍結状態で結果がフィルターされます。デフォルトでは未指定です。
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedAccountWithUsers'
        '400':
          $ref: '#/components/responses/BadRequest'
        '403':
          $ref: '#/components/responses/Forbidden'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'
  /bills:
    get:
      tags:
        - Bill
      summary: '支払いQRコード一覧を表示する'
      description: 支払いQRコード一覧を表示します。
      x-pokepay-operator-name: "ListBills"
      x-pokepay-allow-server-side: true
      requestBody:
        required: true
        content:
          application/json:
            schema:
              properties:
                page:
                  type: integer
                  minimum: 1
                  title: 'ページ番号'
                  description: 取得したいページ番号です。
                per_page:
                  type: integer
                  minimum: 1
                  title: '1ページの表示数'
                  description: 1ページに表示する支払いQRコードの数です。
                bill_id:
                  type: string
                  title: '支払いQRコードのID'
                  description: 支払いQRコードのIDを指定して検索します。IDは前方一致で検索されます。
                private_money_id:
                  type: string
                  format: uuid
                  title: 'マネーID'
                  description: 支払いQRコードの送金元ウォレットのマネーIDでフィルターします。
                organization_code:
                  type: string
                  pattern: '^[a-zA-Z0-9-]*$'
                  maxLength: 32
                  title: '組織コード'
                  description: 支払いQRコードの送金元店舗が所属する組織の組織コードでフィルターします。
                description:
                  type: string
                  maxLength: 200
                  title: '取引説明文'
                  description: 支払いQRコードを読み取ることで作られた取引の説明文としてアプリなどに表示されます。
                  example: 'test bill'
                created_from:
                  type: string
                  format: date-time
                  title: '作成日時(起点)'
                  description: |-
                    支払いQRコードの作成日時でフィルターします。

                    これ以降に作成された支払いQRコードのみ一覧に表示されます。
                created_to:
                  type: string
                  format: date-time
                  title: '作成日時(終点)'
                  description: |-
                    支払いQRコードの作成日時でフィルターします。

                    これ以前に作成された支払いQRコードのみ一覧に表示されます。
                shop_name:
                  type: string
                  maxLength: 256
                  title: '店舗名'
                  description: 支払いQRコードを作成した店舗名でフィルターします。店舗名は部分一致で検索されます。
                  example: 'bill test shop1'
                shop_id:
                  type: string
                  format: uuid
                  title: '店舗ID'
                  description: 支払いQRコードを作成した店舗IDでフィルターします。
                lower_limit_amount:
                  type: integer
                  minimum: 0
                  format: decimal
                  title: '金額の範囲によるフィルタ(下限)'
                  description: 支払いQRコードの金額の下限を指定してフィルターします。
                upper_limit_amount:
                  type: integer
                  minimum: 0
                  format: decimal
                  title: '金額の範囲によるフィルタ(上限)'
                  description: 支払いQRコードの金額の上限を指定してフィルターします。
                is_disabled:
                  type: boolean
                  title: '支払いQRコードが無効化されているかどうか'
                  description: 支払いQRコードが無効化されているかどうかを表します。デフォルト値は偽(有効)です。
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedBills'
        '400':
          $ref: '#/components/responses/BadRequest'
        '403':
          $ref: '#/components/responses/Forbidden'
    post:
      tags:
        - Bill
      summary: '支払いQRコードの発行'
      description: 支払いQRコードの内容を更新します。支払い先の店舗ユーザーは指定したマネーのウォレットを持っている必要があります。
      x-pokepay-operator-name: "CreateBill"
      x-pokepay-allow-server-side: true
      requestBody:
        required: true
        content:
          application/json:
            schema:
              required: ["private_money_id", "shop_id"]
              properties:
                amount:
                  type: number
                  minimum: 0
                  nullable: true
                  format: decimal
                  title: '支払い額'
                  description: 支払いQRコードを支払い額を指定します。省略するかnullを渡すと任意金額の支払いQRコードとなり、エンドユーザーがアプリで読み取った際に金額を入力します。
                private_money_id:
                  type: string
                  format: uuid
                  title: '支払いマネーのマネーID'
                shop_id:
                  type: string
                  format: uuid
                  title: '支払い先(受け取り人)の店舗ID'
                description:
                  type: string
                  maxLength: 200
                  title: '説明文(アプリ上で取引の説明文として表示される)'
                  example: 'test bill'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Bill'
        '400':
          $ref: '#/components/responses/BadRequest'
        '403':
          $ref: '#/components/responses/Forbidden'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'

  /bills/{bill_id}:
    patch:
      tags:
        - Bill
      summary: '支払いQRコードの更新'
      description: 支払いQRコードの内容を更新します。パラメータは全て省略可能で、指定したもののみ更新されます。
      x-pokepay-operator-name: "UpdateBill"
      x-pokepay-allow-server-side: true
      parameters:
        - in: path
          name: bill_id
          required: true
          schema:
            type: string
            format: uuid
            title: '支払いQRコードのID'
          description: |-
            更新対象の支払いQRコードのIDです。
      requestBody:
        required: true
        content:
          application/json:
            schema:
              properties:
                amount:
                  type: number
                  minimum: 0
                  nullable: true
                  format: decimal
                  title: '支払い額'
                  description: 支払いQRコードを支払い額を指定します。nullを渡すと任意金額の支払いQRコードとなり、エンドユーザーがアプリで読み取った際に金額を入力します。
                description:
                  type: string
                  maxLength: 200
                  title: '説明文'
                  description: 支払いQRコードの詳細説明文です。アプリ上で取引の説明文として表示されます。
                  example: 'test bill'
                is_disabled:
                  type: boolean
                  title: '無効化されているかどうか'
                  description: 支払いQRコードが無効化されているかどうかを指定します。真にすると無効化され、偽にすると有効化します。
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Bill'
        '400':
          $ref: '#/components/responses/BadRequest'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
  /checks:
    post:
      tags:
        - Check
      summary: 'チャージQRコードの発行'
      x-pokepay-operator-name: "CreateCheck"
      x-pokepay-allow-server-side: true
      requestBody:
        required: true
        content:
          application/json:
            schema:
              required: ["account_id"]
              x-pokepay-conditional-parameters: {or: [money_amount, point_amount]}
              properties:
                money_amount:
                  type: number
                  minimum: 0
                  format: decimal
                  title: '付与マネー額'
                  description: |
                    チャージQRコードによって付与されるマネー額です。
                    `money_amount`と`point_amount`の少なくともどちらかは指定する必要があります。
                point_amount:
                  type: number
                  minimum: 0
                  format: decimal
                  title: '付与ポイント額'
                  description: |
                    チャージQRコードによって付与されるポイント額です。
                    `money_amount`と`point_amount`の少なくともどちらかは指定する必要があります。
                account_id:
                  type: string
                  format: uuid
                  title: '送金元の店舗アカウントID'
                description:
                  type: string
                  maxLength: 200
                  title: '説明文(アプリ上で取引の説明文として表示される)'
                  example: 'test check'
                is_onetime:
                  type: boolean
                  title: 'ワンタイムかどうかのフラグ'
                  description: |
                    チャージQRコードが一度の読み取りで失効するときに`true`にします。デフォルト値は`true`です。
                    `false`の場合、複数ユーザによって読み取り可能なQRコードになります。
                    ただし、その場合も1ユーザにつき1回のみしか読み取れません。
                usage_limit:
                  type: integer
                  nullable: true
                  title: 'ワンタイムでない場合の最大読み取り回数'
                  description: |
                    複数ユーザによって読み取り可能なチャージQRコードの最大読み取り回数を指定します。
                    NULLに設定すると無制限に読み取り可能なチャージQRコードになります。
                    デフォルト値はNULLです。
                    ワンタイム指定(`is_onetime`)がされているときは、本パラメータはNULLである必要があります。
                expires_at:
                  type: string
                  format: date-time
                  title: 'チャージQRコード自体の失効日時'
                  description: |
                    チャージQRコード自体の失効日時を指定します。この日時以降はチャージQRコードを読み取れなくなります。デフォルトでは作成日時から3ヶ月後になります。

                    チャージQRコード自体の失効日時であって、チャージQRコードによって付与されるマネー残高の有効期限とは異なることに注意してください。マネー残高の有効期限はマネー設定で指定されているものになります。
                point_expires_at:
                  type: string
                  format: date-time
                  title: 'チャージQRコードによって付与されるポイント残高の有効期限'
                  description: |
                    チャージQRコードによって付与されるポイント残高の有効起源を指定します。デフォルトではマネー残高の有効期限と同じものが指定されます。

                    チャージQRコードにより付与されるマネー残高の有効期限はQRコード毎には指定できませんが、ポイント残高の有効期限は本パラメータにより、QRコード毎に個別に指定することができます。
                point_expires_in_days:
                  type: integer
                  minimum: 1
                  title: 'チャージQRコードによって付与されるポイント残高の有効期限(相対日数指定)'
                  description: |
                    チャージQRコードによって付与されるポイント残高の有効期限を相対日数で指定します。
                    1を指定すると、チャージQRコード作成日の当日中に失効します(翌日0時に失効)。
                    `point_expires_at`と`point_expires_in_days`が両方指定されている場合は、チャージQRコードによるチャージ取引ができた時点からより近い方が採用されます。
                  example: 60
                bear_point_account:
                  type: string
                  format: uuid
                  title: 'ポイント額を負担する店舗のウォレットID'
                  description: |
                    ポイントチャージをする場合、ポイント額を負担する店舗のウォレットIDを指定することができます。
                    デフォルトではマネー発行体のデフォルト店舗(本店)がポイント負担先となります。
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Check'
        '400':
          $ref: '#/components/responses/InvalidParameters'
        '403':
          $ref: '#/components/responses/UnpermittedAdminUser'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'
    get:
      tags:
        - Check
      summary: 'チャージQRコード一覧の取得'
      x-pokepay-operator-name: "ListChecks"
      x-pokepay-allow-server-side: true
      requestBody:
        required: true
        content:
          application/json:
            schema:
              properties:
                page:
                  type: integer
                  minimum: 1
                  title: 'ページ番号'
                per_page:
                  type: integer
                  minimum: 1
                  title: '1ページの表示数'
                  description: 1ページ当たり表示数です。デフォルト値は50です。
                  example: 50
                private_money_id:
                  type: string
                  format: uuid
                  title: 'マネーID'
                  description: |
                    チャージQRコードのチャージ対象のマネーIDで結果をフィルターします。
                organization_code:
                  type: string
                  maxLength: 32
                  title: '組織コード'
                  description: |-
                    チャージQRコードの発行店舗の所属組織の組織コードで結果をフィルターします。
                    デフォルトでは未指定です。
                expires_from:
                  type: string
                  format: date-time
                  title: '有効期限の期間によるフィルター(開始時点)'
                  description: |
                    有効期限の期間によるフィルターの開始時点のタイムスタンプです。
                    デフォルトでは未指定です。
                expires_to:
                  type: string
                  format: date-time
                  title: '有効期限の期間によるフィルター(終了時点)'
                  description: |
                    有効期限の期間によるフィルターの終了時点のタイムスタンプです。
                    デフォルトでは未指定です。
                created_from:
                  type: string
                  format: date-time
                  title: '作成日時の期間によるフィルター(開始時点)'
                  description: |
                    作成日時の期間によるフィルターの開始時点のタイムスタンプです。
                    デフォルトでは未指定です。
                created_to:
                  type: string
                  format: date-time
                  title: '作成日時の期間によるフィルター(終了時点)'
                  description: |
                    作成日時の期間によるフィルターの終了時点のタイムスタンプです。
                    デフォルトでは未指定です。
                issuer_shop_id:
                  type: string
                  format: uuid
                  title: '発行店舗ID'
                  description: |
                    チャージQRコードを発行した店舗IDによってフィルターします。
                    デフォルトでは未指定です。
                description:
                  type: string
                  title: 'チャージQRコードの説明文'
                  description: |
                    チャージQRコードの説明文(description)によってフィルターします。
                    部分一致(前方一致)したものを表示します。
                    デフォルトでは未指定です。
                is_onetime:
                  type: boolean
                  title: 'ワンタイムのチャージQRコードかどうか'
                  description: |
                    チャージQRコードがワンタイムに設定されているかどうかでフィルターします。
                    `true` の場合はワンタイムかどうかでフィルターし、`false`の場合はワンタイムでないものをフィルターします。
                    未指定の場合はフィルターしません。
                    デフォルトでは未指定です。
                is_disabled:
                  type: boolean
                  title: '無効化されたチャージQRコードかどうか'
                  description: |
                    チャージQRコードが無効化されているかどうかでフィルターします。
                    `true` の場合は無効なものをフィルターし、`false`の場合は有効なものをフィルターします。
                    未指定の場合はフィルターしません。
                    デフォルトでは未指定です。
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedChecks'
        '400':
          $ref: '#/components/responses/InvalidParameters'
        '403':
          $ref: '#/components/responses/UnpermittedAdminUser'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'
  /checks/{check_id}:
    get:
      tags:
        - Check
      summary: 'チャージQRコードの表示'
      x-pokepay-operator-name: "GetCheck"
      x-pokepay-allow-server-side: true
      parameters:
        - in: path
          name: check_id
          required: true
          schema:
            type: string
            format: uuid
            title: 'チャージQRコードのID'
          description: |-
            表示対象のチャージQRコードのIDです。
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Check'
        '400':
          $ref: '#/components/responses/InvalidParameters'
        '403':
          $ref: '#/components/responses/UnpermittedAdminUser'
        '404':
          $ref: '#/components/responses/NotFound'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'
    patch:
      tags:
        - Check
      summary: 'チャージQRコードの更新'
      x-pokepay-operator-name: "UpdateCheck"
      x-pokepay-allow-server-side: true
      parameters:
        - in: path
          name: check_id
          required: true
          schema:
            type: string
            format: uuid
            title: 'チャージQRコードのID'
          description: |-
            更新対象のチャージQRコードのIDです。
      requestBody:
        required: true
        content:
          application/json:
            schema:
              properties:
                money_amount:
                  type: number
                  minimum: 0
                  format: decimal
                  title: '付与マネー額'
                  description: |
                    チャージQRコードによって付与されるマネー額です。
                    `money_amount`と`point_amount`が両方0になるような更新リクエストはエラーになります。
                point_amount:
                  type: number
                  minimum: 0
                  format: decimal
                  title: '付与ポイント額'
                  description: |
                    チャージQRコードによって付与されるポイント額です。
                    `money_amount`と`point_amount`が両方0になるような更新リクエストはエラーになります。
                description:
                  type: string
                  maxLength: 200
                  title: 'チャージQRコードの説明文'
                  description: |
                    チャージQRコードの説明文です。
                    チャージ取引後は、取引の説明文に転記され、取引履歴などに表示されます。
                  example: 'test check'
                is_onetime:
                  type: boolean
                  title: 'ワンタイムかどうかのフラグ'
                  description: |
                    チャージQRコードが一度の読み取りで失効するときに`true`にします。
                    `false`の場合、複数ユーザによって読み取り可能なQRコードになります。
                    ただし、その場合も1ユーザにつき1回のみしか読み取れません。
                usage_limit:
                  type: integer
                  nullable: true
                  title: 'ワンタイムでない場合の最大読み取り回数'
                  description: |
                    複数ユーザによって読み取り可能なチャージQRコードの最大読み取り回数を指定します。
                    NULLに設定すると無制限に読み取り可能なチャージQRコードになります。
                    ワンタイム指定(`is_onetime`)がされているときは、本パラメータはNULLである必要があります。
                expires_at:
                  type: string
                  format: date-time
                  title: 'チャージQRコード自体の失効日時'
                  description: |
                    チャージQRコード自体の失効日時を指定します。この日時以降はチャージQRコードを読み取れなくなります。

                    チャージQRコード自体の失効日時であって、チャージQRコードによって付与されるマネー残高の有効期限とは異なることに注意してください。マネー残高の有効期限はマネー設定で指定されているものになります。
                point_expires_at:
                  type: string
                  format: date-time
                  nullable: true
                  title: 'チャージQRコードによって付与されるポイント残高の有効期限'
                  description: |
                    チャージQRコードによって付与されるポイント残高の有効起源を指定します。

                    チャージQRコードにより付与されるマネー残高の有効期限はQRコード毎には指定できませんが、ポイント残高の有効期限は本パラメータにより、QRコード毎に個別に指定することができます。
                point_expires_in_days:
                  type: integer
                  minimum: 1
                  nullable: true
                  title: 'チャージQRコードによって付与されるポイント残高の有効期限(相対日数指定)'
                  description: |
                    チャージQRコードによって付与されるポイント残高の有効期限を相対日数で指定します。
                    1を指定すると、チャージQRコード作成日の当日中に失効します(翌日0時に失効)。
                    `point_expires_at`と`point_expires_in_days`が両方指定されている場合は、チャージQRコードによるチャージ取引ができた時点からより近い方が採用されます。
                    `point_expires_at`と`point_expires_in_days`が両方NULLに設定されている場合は、マネーに設定されている残高の有効期限と同じになります。
                  example: 60
                bear_point_account:
                  type: string
                  format: uuid
                  title: 'ポイント額を負担する店舗のウォレットID'
                  description: |
                    ポイントチャージをする場合、ポイント額を負担する店舗のウォレットIDを指定することができます。
                is_disabled:
                  type: boolean
                  title: '無効化されているかどうかのフラグ'
                  description: |
                    チャージQRコードを無効化するときに`true`にします。
                    `false`の場合は無効化されているチャージQRコードを再有効化します。
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Check'
        '400':
          $ref: '#/components/responses/InvalidParameters'
        '403':
          $ref: '#/components/responses/UnpermittedAdminUser'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'
        '404':
          $ref: '#/components/responses/NotFound'
  /cpm/{cpm_token}:
    get:
      tags:
        - Transaction
      summary: 'CPMトークンの状態取得'
      description: CPMトークンの現在の状態を取得します。CPMトークンの有効期限やCPM取引の状態を返します。
      x-pokepay-operator-name: "GetCpmToken"
      x-pokepay-allow-server-side: true
      parameters:
        - in: path
          name: cpm_token
          required: true
          schema:
            type: string
            minLength: 22
            maxLength: 22
            title: CPMトークン
          description: CPM取引時にエンドユーザーが店舗に提示するバーコードを解析して得られる22桁の文字列です。
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CpmToken'
        '400':
          $ref: '#/components/responses/BadRequest'
        '403':
          $ref: '#/components/responses/Forbidden'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'
  /transactions:
    get:
      tags:
        - Transaction
      summary: '【廃止】取引履歴を取得する'
      description: 取引一覧を返します。
      x-pokepay-operator-name: "ListTransactions"
      x-pokepay-allow-server-side: true
      requestBody:
        required: true
        content:
          application/json:
            schema:
              properties:
                from:
                  type: string
                  format: date-time
                  title: '開始日時'
                  description: |-
                    抽出期間の開始日時です。

                    フィルターとして使われ、開始日時以降に発生した取引のみ一覧に表示されます。
                to:
                  type: string
                  format: date-time
                  title: '終了日時'
                  description: |-
                    抽出期間の終了日時です。

                    フィルターとして使われ、終了日時以前に発生した取引のみ一覧に表示されます。
                page:
                  type: integer
                  minimum: 1
                  title: 'ページ番号'
                  description: 取得したいページ番号です。
                  example: 1
                per_page:
                  type: integer
                  minimum: 1
                  title: '1ページ分の取引数'
                  description: 1ページ分の取引数です。
                  example: 50
                shop_id:
                  type: string
                  format: uuid
                  title: '店舗ID'
                  description: |-
                    店舗IDです。

                    フィルターとして使われ、指定された店舗での取引のみ一覧に表示されます。
                customer_id:
                  type: string
                  format: uuid
                  title: 'エンドユーザーID'
                  description: |-
                    エンドユーザーIDです。

                    フィルターとして使われ、指定されたエンドユーザーでの取引のみ一覧に表示されます。
                customer_name:
                  type: string
                  maxLength: 256
                  title: 'エンドユーザー名'
                  description: |-
                    エンドユーザー名です。

                    フィルターとして使われ、入力された名前に部分一致するエンドユーザーでの取引のみ一覧に表示されます。
                  example: 太郎
                terminal_id:
                  type: string
                  format: uuid
                  title: '端末ID'
                  description: |-
                    端末IDです。

                    フィルターとして使われ、指定された端末での取引のみ一覧に表示されます。
                transaction_id:
                  type: string
                  title: '取引ID'
                  description: |-
                    取引IDです。

                    フィルターとして使われ、指定された取引IDに部分一致(前方一致)する取引のみが一覧に表示されます。
                organization_code:
                  type: string
                  pattern: '^[a-zA-Z0-9-]*$'
                  maxLength: 32
                  title: '組織コード'
                  description: |-
                    組織コードです。

                    フィルターとして使われ、指定された組織での取引のみ一覧に表示されます。
                  example: 'pocketchange'
                private_money_id:
                  type: string
                  format: uuid
                  title: 'マネーID'
                  description: |-
                    マネーIDです。

                    フィルターとして使われ、指定したマネーでの取引のみ一覧に表示されます。
                is_modified:
                  type: boolean
                  title: 'キャンセルフラグ'
                  description: |-
                    キャンセルフラグです。

                    これにtrueを指定するとキャンセルされた取引のみ一覧に表示されます。
                    デフォルト値はfalseで、キャンセルの有無にかかわらず一覧に表示されます。
                types:
                  type: array
                  title: '取引種別 (複数指定可)、チャージ=topup、支払い=payment'
                  example: '["topup", "payment"]'
                  description: |-
                    取引の種類でフィルターします。

                    以下の種類を指定できます。

                    1. topup
                       店舗からエンドユーザーへの送金取引(チャージ)

                    2. payment
                       エンドユーザーから店舗への送金取引(支払い)

                    3. exchange-outflow
                       他マネーへの流出

                    4. exchange-inflow
                       他マネーからの流入

                    5. cashback
                       退会時返金取引

                    6. expire
                       退会時失効取引
                  items:
                    type: string
                    enum: [topup, payment, exchange_outflow, exchange_inflow, cashback, expire]
                description:
                  type: string
                  maxLength: 200
                  title: '取引説明文'
                  description: |-
                    取引を指定の取引説明文でフィルターします。

                    取引説明文が完全一致する取引のみ抽出されます。取引説明文は最大200文字で記録されています。
                  example: 店頭QRコードによる支払い
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedTransaction'
        '400':
          $ref: '#/components/responses/InvalidParameters'
    post:
      tags:
        - Transaction
      summary: '【廃止】チャージする'
      description: |-
        チャージ取引を作成します。このAPIは廃止予定です。以降は `CreateTopupTransaction` を使用してください。
      x-pokepay-operator-name: "CreateTransaction"
      x-pokepay-allow-server-side: true
      deprecated: true
      requestBody:
        required: true
        content:
          application/json:
            schema:
              required: ["private_money_id", "shop_id", "customer_id"]
              properties:
                shop_id:
                  type: string
                  format: uuid
                customer_id:
                  type: string
                  format: uuid
                private_money_id:
                  type: string
                  format: uuid
                money_amount:
                  type: integer
                  format: decimal
                  minimum: 0
                point_amount:
                  type: integer
                  format: decimal
                  minimum: 0
                point_expires_at:
                  type: string
                  format: date-time
                  title: 'ポイント有効期限'
                  description: |-
                    ポイントをチャージした場合の、付与されるポイントの有効期限です。
                    省略した場合はマネーに設定された有効期限と同じものがポイントの有効期限となります。
                description:
                  type: string
                  maxLength: 200
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TransactionDetail'
        '400':
          $ref: '#/components/responses/BadRequest'
        '403':
          $ref: '#/components/responses/Forbidden'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'
  /transactions-v2:
    get:
      tags:
        - Transaction
      summary: '取引履歴を取得する'
      description: 取引一覧を返します。
      x-pokepay-operator-name: "ListTransactionsV2"
      x-pokepay-allow-server-side: true
      requestBody:
        required: true
        content:
          application/json:
            schema:
              properties:
                private_money_id:
                  type: string
                  format: uuid
                  title: 'マネーID'
                  description: |-
                    マネーIDです。

                    指定したマネーでの取引が一覧に表示されます。
                organization_code:
                  type: string
                  pattern: '^[a-zA-Z0-9-]*$'
                  maxLength: 32
                  title: '組織コード'
                  description: |-
                    組織コードです。

                    フィルターとして使われ、指定された組織の店舗での取引のみ一覧に表示されます。
                  example: 'pocketchange'
                shop_id:
                  type: string
                  format: uuid
                  title: '店舗ID'
                  description: |-
                    店舗IDです。

                    フィルターとして使われ、指定された店舗での取引のみ一覧に表示されます。
                terminal_id:
                  type: string
                  format: uuid
                  title: '端末ID'
                  description: |-
                    端末IDです。

                    フィルターとして使われ、指定された端末での取引のみ一覧に表示されます。
                customer_id:
                  type: string
                  format: uuid
                  title: 'エンドユーザーID'
                  description: |-
                    エンドユーザーIDです。

                    フィルターとして使われ、指定されたエンドユーザーの取引のみ一覧に表示されます。
                customer_name:
                  type: string
                  maxLength: 256
                  title: 'エンドユーザー名'
                  description: |-
                    エンドユーザー名です。

                    フィルターとして使われ、入力された名前に部分一致するエンドユーザーでの取引のみ一覧に表示されます。
                  example: 太郎
                description:
                  type: string
                  maxLength: 200
                  title: '取引説明文'
                  description: |-
                    取引を指定の取引説明文でフィルターします。

                    取引説明文が完全一致する取引のみ抽出されます。取引説明文は最大200文字で記録されています。
                  example: 店頭QRコードによる支払い
                transaction_id:
                  type: string
                  title: '取引ID'
                  description: |-
                    取引IDです。

                    フィルターとして使われ、指定された取引IDに部分一致(前方一致)する取引のみが一覧に表示されます。
                is_modified:
                  type: boolean
                  title: 'キャンセルフラグ'
                  description: |-
                    キャンセルフラグです。

                    これにtrueを指定するとキャンセルされた取引のみ一覧に表示されます。
                    デフォルト値はfalseで、キャンセルの有無にかかわらず一覧に表示されます。
                types:
                  type: array
                  title: '取引種別 (複数指定可)、チャージ=topup、支払い=payment'
                  example: '["topup", "payment"]'
                  description: |-
                    取引の種類でフィルターします。

                    以下の種類を指定できます。

                    1. topup
                       店舗からエンドユーザーへの送金取引(チャージ)

                    2. payment
                       エンドユーザーから店舗への送金取引(支払い)

                    3. exchange-outflow
                       他マネーへの流出
                       private_money_idが指定されたとき、そのマネーから見て流出方向の交換取引が抽出されます。
                       private_money_idを省略した場合は表示されません。

                    4. exchange-inflow
                       他マネーからの流入
                       private_money_idが指定されたとき、そのマネーから見て流入方向の交換取引が抽出されます。
                       private_money_idを省略した場合は表示されません。

                    5. cashback
                       退会時返金取引

                    6. expire
                       退会時失効取引
                  items:
                    type: string
                    enum: [topup, payment, exchange_outflow, exchange_inflow, cashback, expire]
                from:
                  type: string
                  format: date-time
                  title: '開始日時'
                  description: |-
                    抽出期間の開始日時です。

                    フィルターとして使われ、開始日時以降に発生した取引のみ一覧に表示されます。
                to:
                  type: string
                  format: date-time
                  title: '終了日時'
                  description: |-
                    抽出期間の終了日時です。

                    フィルターとして使われ、終了日時以前に発生した取引のみ一覧に表示されます。
                next_page_cursor_id:
                  type: string
                  format: uuid
                  title: '次ページへ遷移する際に起点となるtransactionのID'
                  description: |-
                    次ページへ遷移する際に起点となるtransactionのID(前ページの末尾要素のID)です。
                    本APIのレスポンスにもnext_page_cursor_idが含まれており、これがnull値の場合は最後のページであることを意味します。
                    UUIDである場合は次のページが存在することを意味し、このnext_page_cursor_idをリクエストパラメータに含めることで次ページに遷移します。

                    next_page_cursor_idのtransaction自体は次のページには含まれません。
                prev_page_cursor_id:
                  type: string
                  format: uuid
                  title: '前ページへ遷移する際に起点となるtransactionのID'
                  description: |-
                    前ページへ遷移する際に起点となるtransactionのID(次ページの先頭要素のID)です。

                    本APIのレスポンスにもprev_page_cursor_idが含まれており、これがnull値の場合は先頭のページであることを意味します。
                    UUIDである場合は前のページが存在することを意味し、このprev_page_cursor_idをリクエストパラメータに含めることで前ページに遷移します。

                    prev_page_cursor_idのtransaction自体は前のページには含まれません。
                per_page:
                  type: integer
                  minimum: 1
                  maximum: 1000
                  title: '1ページ分の取引数'
                  description: |-
                    1ページ分の取引数です。

                    デフォルト値は50です。
                  example: 50
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedTransactionV2'
        '400':
          $ref: '#/components/responses/InvalidParameters'
        '403':
          $ref: '#/components/responses/Forbidden'
  /transactions/bill:
    get:
      tags:
        - Transaction
      summary: '支払い取引履歴を取得する'
      description: 支払いによって発生した取引を支払いのデータとともに一覧で返します。
      x-pokepay-operator-name: "ListBillTransactions"
      x-pokepay-allow-server-side: true
      requestBody:
        required: true
        content:
          application/json:
            schema:
              properties:
                private_money_id:
                  type: string
                  format: uuid
                  title: 'マネーID'
                  description: |-
                    マネーIDです。

                    指定したマネーでの取引が一覧に表示されます。
                organization_code:
                  type: string
                  pattern: '^[a-zA-Z0-9-]*$'
                  maxLength: 32
                  title: '組織コード'
                  description: |-
                    組織コードです。

                    フィルターとして使われ、指定された組織の店舗での取引のみ一覧に表示されます。
                  example: 'pocketchange'
                shop_id:
                  type: string
                  format: uuid
                  title: '店舗ID'
                  description: |-
                    店舗IDです。

                    フィルターとして使われ、指定された店舗での取引のみ一覧に表示されます。
                customer_id:
                  type: string
                  format: uuid
                  title: 'エンドユーザーID'
                  description: |-
                    エンドユーザーIDです。

                    フィルターとして使われ、指定されたエンドユーザーの取引のみ一覧に表示されます。
                customer_name:
                  type: string
                  maxLength: 256
                  title: 'エンドユーザー名'
                  description: |-
                    エンドユーザー名です。

                    フィルターとして使われ、入力された名前に部分一致するエンドユーザーでの取引のみ一覧に表示されます。
                  example: 太郎
                terminal_id:
                   type: string
                   format: uuid
                   title: 'エンドユーザー端末ID'
                   description: |-
                     エンドユーザーの端末IDです。
                     フィルターとして使われ、指定された端末での取引のみ一覧に表示されます。
                description:
                  type: string
                  maxLength: 200
                  title: '取引説明文'
                  description: |-
                    取引を指定の取引説明文でフィルターします。

                    取引説明文が完全一致する取引のみ抽出されます。取引説明文は最大200文字で記録されています。
                  example: 店頭QRコードによる支払い
                transaction_id:
                  type: string
                  title: '取引ID'
                  description: |-
                    取引IDです。

                    フィルターとして使われ、指定された取引IDに部分一致(前方一致)する取引のみが一覧に表示されます。
                bill_id:
                  type: string
                  title: '支払いQRコードのID'
                  description: |-
                    支払いQRコードのIDです。

                    フィルターとして使われ、指定された支払いQRコードIDに部分一致(前方一致)する取引のみが一覧に表示されます。
                is_modified:
                  type: boolean
                  title: 'キャンセルフラグ'
                  description: |-
                    キャンセルフラグです。

                    これにtrueを指定するとキャンセルされた取引のみ一覧に表示されます。
                    デフォルト値はfalseで、キャンセルの有無にかかわらず一覧に表示されます。
                from:
                  type: string
                  format: date-time
                  title: '開始日時'
                  description: |-
                    抽出期間の開始日時です。

                    フィルターとして使われ、開始日時以降に発生した取引のみ一覧に表示されます。
                to:
                  type: string
                  format: date-time
                  title: '終了日時'
                  description: |-
                    抽出期間の終了日時です。

                    フィルターとして使われ、終了日時以前に発生した取引のみ一覧に表示されます。
                next_page_cursor_id:
                  type: string
                  format: uuid
                  title: '次ページへ遷移する際に起点となるtransactionのID'
                  description: |-
                    次ページへ遷移する際に起点となるtransactionのID(前ページの末尾要素のID)です。
                    本APIのレスポンスにもnext_page_cursor_idが含まれており、これがnull値の場合は最後のページであることを意味します。
                    UUIDである場合は次のページが存在することを意味し、このnext_page_cursor_idをリクエストパラメータに含めることで次ページに遷移します。

                    next_page_cursor_idのtransaction自体は次のページには含まれません。
                prev_page_cursor_id:
                  type: string
                  format: uuid
                  title: '前ページへ遷移する際に起点となるtransactionのID'
                  description: |-
                    前ページへ遷移する際に起点となるtransactionのID(次ページの先頭要素のID)です。

                    本APIのレスポンスにもprev_page_cursor_idが含まれており、これがnull値の場合は先頭のページであることを意味します。
                    UUIDである場合は前のページが存在することを意味し、このprev_page_cursor_idをリクエストパラメータに含めることで前ページに遷移します。

                    prev_page_cursor_idのtransaction自体は前のページには含まれません。
                per_page:
                  type: integer
                  minimum: 1
                  maximum: 1000
                  default: 50
                  title: '1ページ分の取引数'
                  description: |-
                    1ページ分の取引数です。

                    デフォルト値は50です。
                  example: 50
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedBillTransaction'
        '400':
          $ref: '#/components/responses/InvalidParameters'
        '403':
          $ref: '#/components/responses/Forbidden'
  /transactions/topup:
    post:
      tags:
        - Transaction
      summary: 'チャージする'
      description: チャージ取引を作成します。
      x-pokepay-operator-name: "CreateTopupTransaction"
      x-pokepay-allow-server-side: true
      requestBody:
        required: true
        content:
          application/json:
            schema:
              required: ["private_money_id", "shop_id", "customer_id"]
              properties:
                shop_id:
                  type: string
                  format: uuid
                  title: '店舗ID'
                  description: |-
                    店舗IDです。

                    送金元の店舗を指定します。
                customer_id:
                  type: string
                  format: uuid
                  title: 'エンドユーザーのID'
                  description: |-
                    エンドユーザーIDです。

                    送金先のエンドユーザーを指定します。
                private_money_id:
                  type: string
                  format: uuid
                  title: 'マネーID'
                  description: |-
                    マネーIDです。

                    マネーを指定します。
                bear_point_shop_id:
                  type: string
                  format: uuid
                  title: 'ポイント支払時の負担店舗ID'
                  description: |-
                    ポイント支払時の負担店舗IDです。

                    ポイント支払い時に実際お金を負担する店舗を指定します。
                money_amount:
                  type: integer
                  minimum: 0
                  title: 'マネー額'
                  description: |-
                    マネー額です。

                    送金するマネー額を指定します。
                    デフォルト値は0で、money_amountとpoint_amountの両方が0のときにはinvalid_parameter_both_point_and_money_are_zero(エラーコード400)が返ります。
                point_amount:
                  type: integer
                  minimum: 0
                  title: 'ポイント額'
                  description: |-
                    ポイント額です。

                    送金するポイント額を指定します。
                    デフォルト値は0で、money_amountとpoint_amountの両方が0のときにはinvalid_parameter_both_point_and_money_are_zero(エラーコード400)が返ります。
                point_expires_at:
                  type: string
                  format: date-time
                  title: 'ポイント有効期限'
                  description: |-
                    ポイントをチャージした場合の、付与されるポイントの有効期限です。
                    省略した場合はマネーに設定された有効期限と同じものがポイントの有効期限となります。
                description:
                  type: string
                  maxLength: 200
                  title: '取引履歴に表示する説明文'
                  description: |-
                    取引説明文です。

                    任意入力で、取引履歴に表示される説明文です。
                  example: 初夏のチャージキャンペーン
                metadata:
                  type: string
                  format: json
                  title: '取引メタデータ'
                  description:  |-
                    取引作成時に指定されるメタデータです。

                    任意入力で、全てのkeyとvalueが文字列であるようなフラットな構造のJSON文字列で指定します。
                  example: |-
                    {"key":"value"}
                request_id:
                  type: string
                  format: uuid
                  title: 'リクエストID'
                  description: |-
                    取引作成APIの羃等性を担保するためのリクエスト固有のIDです。

                    取引作成APIで結果が受け取れなかったなどの理由で再試行する際に、二重に取引が作られてしまうことを防ぐために、クライアント側から指定されます。指定は任意で、UUID V4フォーマットでランダム生成した文字列です。リクエストIDは一定期間で削除されます。

                    リクエストIDを指定したとき、まだそのリクエストIDに対する取引がない場合、新規に取引が作られレスポンスとして返されます。もしそのリクエストIDに対する取引が既にある場合、既存の取引がレスポンスとして返されます。
                    既に存在する、別のユーザによる取引とリクエストIDが衝突した場合、request_id_conflictが返ります。
                  example: '9dbfd997-b948-40d3-a3bf-6bc1a01368d2'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TransactionDetail'
        '400':
          $ref: '#/components/responses/BadRequest'
        '403':
          $ref: '#/components/responses/Forbidden'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'
  /transactions/topup/check:
    post:
      tags:
        - Check
      summary: 'チャージQRコードを読み取ることでチャージする'
      description: |
        通常チャージQRコードはエンドユーザーのアプリによって読み取られ、アプリとポケペイサーバとの直接通信によって取引が作られます。 もしエンドユーザーとの通信をパートナーのサーバのみに限定したい場合、パートナーのサーバがチャージQRの情報をエンドユーザーから代理受けして、サーバ間連携APIによって実際のチャージ取引をリクエストすることになります。

        エンドユーザーから受け取ったチャージ用QRコードのIDをエンドユーザーIDと共に渡すことでチャージ取引が作られます。
      x-pokepay-operator-name: "CreateTopupTransactionWithCheck"
      x-pokepay-allow-server-side: true
      requestBody:
        required: true
        content:
          application/json:
            schema:
              required: ["check_id", "customer_id"]
              properties:
                check_id:
                  type: string
                  format: uuid
                  title: 'チャージ用QRコードのID'
                  description: |-
                    チャージ用QRコードのIDです。

                    QRコード生成時に送金元店舗のウォレット情報や、送金額などが登録されています。
                customer_id:
                  type: string
                  format: uuid
                  title: 'エンドユーザーのID'
                  description: |-
                    エンドユーザーIDです。

                    送金先のエンドユーザーを指定します。
                request_id:
                  type: string
                  format: uuid
                  title: 'リクエストID'
                  description: |-
                    取引作成APIの羃等性を担保するためのリクエスト固有のIDです。

                    取引作成APIで結果が受け取れなかったなどの理由で再試行する際に、二重に取引が作られてしまうことを防ぐために、クライアント側から指定されます。指定は任意で、UUID V4フォーマットでランダム生成した文字列です。リクエストIDは一定期間で削除されます。

                    リクエストIDを指定したとき、まだそのリクエストIDに対する取引がない場合、新規に取引が作られレスポンスとして返されます。もしそのリクエストIDに対する取引が既にある場合、既存の取引がレスポンスとして返されます。
                    既に存在する、別のユーザによる取引とリクエストIDが衝突した場合、request_id_conflictが返ります。
                  example: '9dbfd997-b948-40d3-a3bf-6bc1a01368d2'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TransactionDetail'
        '400':
          $ref: '#/components/responses/BadRequest'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'
  /transactions/payment:
    post:
      tags:
        - Transaction
      summary: '支払いする'
      description: |
        支払取引を作成します。
        支払い時には、エンドユーザーの残高のうち、ポイント残高から優先的に消費されます。
      x-pokepay-operator-name: "CreatePaymentTransaction"
      x-pokepay-allow-server-side: true
      requestBody:
        required: true
        content:
          application/json:
            schema:
              required: ["private_money_id", "shop_id", "customer_id", "amount"]
              properties:
                shop_id:
                  type: string
                  format: uuid
                  title: '店舗ID'
                  description: |-
                    店舗IDです。

                    送金先の店舗を指定します。
                customer_id:
                  type: string
                  format: uuid
                  title: 'エンドユーザーID'
                  description: |-
                    エンドユーザーIDです。

                    送金元のエンドユーザーを指定します。
                private_money_id:
                  type: string
                  format: uuid
                  title: 'マネーID'
                  description: |-
                    マネーIDです。

                    マネーを指定します。
                amount:
                  type: integer
                  minimum: 0
                  title: '支払い額'
                  description: |-
                    マネー額です。

                    送金するマネー額を指定します。
                description:
                  type: string
                  maxLength: 200
                  title: '取引履歴に表示する説明文'
                  description:  |-
                    取引説明文です。

                    任意入力で、取引履歴に表示される説明文です。
                  example: たい焼き(小倉)
                metadata:
                  type: string
                  format: json
                  title: '取引メタデータ'
                  description:  |-
                    取引作成時に指定されるメタデータです。

                    任意入力で、全てのkeyとvalueが文字列であるようなフラットな構造のJSON文字列で指定します。
                  example: |-
                    {"key":"value"}
                products:
                  $ref: '#/components/schemas/Products'
                request_id:
                  type: string
                  format: uuid
                  title: 'リクエストID'
                  description: |-
                    取引作成APIの羃等性を担保するためのリクエスト固有のIDです。

                    取引作成APIで結果が受け取れなかったなどの理由で再試行する際に、二重に取引が作られてしまうことを防ぐために、クライアント側から指定されます。指定は任意で、UUID V4フォーマットでランダム生成した文字列です。リクエストIDは一定期間で削除されます。

                    リクエストIDを指定したとき、まだそのリクエストIDに対する取引がない場合、新規に取引が作られレスポンスとして返されます。もしそのリクエストIDに対する取引が既にある場合、既存の取引がレスポンスとして返されます。
                    既に存在する、別のユーザによる取引とリクエストIDが衝突した場合、request_id_conflictが返ります。
                  example: '9dbfd997-b948-40d3-a3bf-6bc1a01368d2'
                strategy:
                  type: string
                  enum: [point-preferred, money-only]
                  title: '支払い時の残高消費方式'
                  description: |-
                    支払い時に残高がどのように消費されるかを指定します。
                    デフォルトでは point-preferred (ポイント優先)が採用されます。

                    - point-preferred: ポイント残高が優先的に消費され、ポイントがなくなり次第マネー残高から消費されていきます(デフォルト動作)
                    - money-only: マネー残高のみから消費され、ポイント残高は使われません

                    マネー設定でポイント残高のみの利用に設定されている場合(display_money_and_point が point-only の場合)、 strategy の指定に関わらずポイント優先になります。
                  example: 'point-preferred'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TransactionDetail'
        '400':
          $ref: '#/components/responses/BadRequest'
        '403':
          $ref: '#/components/responses/Forbidden'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'
  /transactions/cpm:
    post:
      tags:
        - Transaction
      summary: 'CPMトークンによる取引作成'
      description: |
        CPMトークンにより取引を作成します。
        CPMトークンに設定されたスコープの取引を作ることができます。
      x-pokepay-operator-name: "CreateCpmTransaction"
      x-pokepay-allow-server-side: true
      requestBody:
        required: true
        content:
          application/json:
            schema:
              required: ["cpm_token", "shop_id", "amount"]
              properties:
                cpm_token:
                  type: string
                  minLength: 22
                  maxLength: 22
                  title: 'CPMトークン'
                  description: |-
                    エンドユーザーによって作られ、アプリなどに表示され、店舗に対して提示される22桁の文字列です。

                    エンドユーザーによって許可された取引のスコープを持っています。
                shop_id:
                  type: string
                  format: uuid
                  title: '店舗ID'
                  description: |-
                    店舗IDです。

                    支払いやチャージを行う店舗を指定します。
                amount:
                  type: number
                  title: '取引金額'
                  description: |-
                    取引金額を指定します。

                    正の値を与えるとチャージになり、負の値を与えると支払いとなります。
                description:
                  type: string
                  maxLength: 200
                  title: '取引説明文'
                  description:  |-
                    取引説明文です。

                    エンドユーザーアプリの取引履歴などに表示されます。
                  example: たい焼き(小倉)
                metadata:
                  type: string
                  format: json
                  title: '店舗側メタデータ'
                  description:  |-
                    取引作成時に店舗側から指定されるメタデータです。

                    任意入力で、全てのkeyとvalueが文字列であるようなフラットな構造のJSON文字列で指定します。
                  example: |-
                    {"key":"value"}
                products:
                  $ref: '#/components/schemas/Products'
                request_id:
                  type: string
                  format: uuid
                  title: 'リクエストID'
                  description: |-
                    取引作成APIの羃等性を担保するためのリクエスト固有のIDです。

                    取引作成APIで結果が受け取れなかったなどの理由で再試行する際に、二重に取引が作られてしまうことを防ぐために、クライアント側から指定されます。指定は任意で、UUID V4フォーマットでランダム生成した文字列です。リクエストIDは一定期間で削除されます。

                    リクエストIDを指定したとき、まだそのリクエストIDに対する取引がない場合、新規に取引が作られレスポンスとして返されます。もしそのリクエストIDに対する取引が既にある場合、既存の取引がレスポンスとして返されます。
                    既に存在する、別のユーザによる取引とリクエストIDが衝突した場合、request_id_conflictが返ります。
                  example: '9dbfd997-b948-40d3-a3bf-6bc1a01368d2'
                strategy:
                  type: string
                  enum: [point-preferred, money-only]
                  title: '支払い時の残高消費方式'
                  description: |-
                    支払い時に残高がどのように消費されるかを指定します。
                    デフォルトでは point-preferred (ポイント優先)が採用されます。

                    - point-preferred: ポイント残高が優先的に消費され、ポイントがなくなり次第マネー残高から消費されていきます(デフォルト動作)
                    - money-only: マネー残高のみから消費され、ポイント残高は使われません

                    マネー設定でポイント残高のみの利用に設定されている場合(display_money_and_point が point-only の場合)、 strategy の指定に関わらずポイント優先になります。
                  example: 'point-preferred'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TransactionDetail'
              examples:
                example-1:
                  value:
                    id: 497f6eca-6276-4993-bfeb-53cbbbba6f08
                    type: string
                    is_modified: true
                    sender:
                      id: 497f6eca-6276-4993-bfeb-53cbbbba6f08
                      name: string
                      is_merchant: true
                    sender_account:
                      id: 497f6eca-6276-4993-bfeb-53cbbbba6f08
                      name: string
                      is_suspended: true
                      private_money:
                        id: 497f6eca-6276-4993-bfeb-53cbbbba6f08
                        name: string
                        unit: string
                        is_exclusive: true
                        description: string
                        oneline_message: string
                        organization:
                          code: string
                          name: string
                        max_balance: 0
                        transfer_limit: 0
                        money_topup_transfer_limit: 0
                        type: own
                        expiration_type: static
                    receiver:
                      id: 497f6eca-6276-4993-bfeb-53cbbbba6f08
                      name: string
                      is_merchant: true
                    receiver_account:
                      id: 497f6eca-6276-4993-bfeb-53cbbbba6f08
                      name: string
                      is_suspended: true
                      private_money:
                        id: 497f6eca-6276-4993-bfeb-53cbbbba6f08
                        name: string
                        unit: string
                        is_exclusive: true
                        description: string
                        oneline_message: string
                        organization:
                          code: string
                          name: string
                        max_balance: 0
                        transfer_limit: 0
                        money_topup_transfer_limit: 0
                        type: own
                        expiration_type: static
                    amount: 0
                    money_amount: 0
                    point_amount: 0
                    done_at: '2019-08-24T14:15:22Z'
                    description: string
        '400':
          $ref: '#/components/responses/BadRequest'
        '403':
          $ref: '#/components/responses/Forbidden'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'

  /transactions/cashtray:
    post:
      tags:
        - Cashtray
      summary: 'CashtrayQRコードを読み取ることで取引する'
      description: |
        エンドユーザーから受け取ったCashtray用QRコードのIDをエンドユーザーIDと共に渡すことで支払いあるいはチャージ取引が作られます。

        通常CashtrayQRコードはエンドユーザーのアプリによって読み取られ、アプリとポケペイサーバとの直接通信によって取引が作られます。
        もしエンドユーザーとの通信をパートナーのサーバのみに限定したい場合、パートナーのサーバがCashtrayQRの情報をエンドユーザーから代理受けして、サーバ間連携APIによって実際のチャージ取引をリクエストすることになります。

      x-pokepay-operator-name: "CreateTransactionWithCashtray"
      x-pokepay-allow-server-side: true
      requestBody:
        required: true
        content:
          application/json:
            schema:
              required: ["cashtray_id", "customer_id"]
              properties:
                cashtray_id:
                  type: string
                  format: uuid
                  title: 'Cashtray用QRコードのID'
                  description: |-
                    Cashtray用QRコードのIDです。

                    QRコード生成時に送金元店舗のウォレット情報や、金額などが登録されています。

                customer_id:
                  type: string
                  format: uuid
                  title: 'エンドユーザーのID'
                  description: |-
                    エンドユーザーIDです。

                strategy:
                  type: string
                  enum: [point-preferred, money-only]
                  default: 'point-preferred'
                  title: '支払い時の残高消費方式'
                  description: |-
                    支払い時に残高がどのように消費されるかを指定します。
                    チャージの場合は無効です。
                    デフォルトでは point-preferred (ポイント優先)が採用されます。

                    - point-preferred: ポイント残高が優先的に消費され、ポイントがなくなり次第マネー残高から消費されていきます(デフォルト動作)
                    - money-only: マネー残高のみから消費され、ポイント残高は使われません

                    マネー設定でポイント残高のみの利用に設定されている場合(display_money_and_point が point-only の場合)、 strategy の指定に関わらずポイント優先になります。

                request_id:
                  type: string
                  format: uuid
                  title: 'リクエストID'
                  description: |-
                    取引作成APIの羃等性を担保するためのリクエスト固有のIDです。

                    取引作成APIで結果が受け取れなかったなどの理由で再試行する際に、二重に取引が作られてしまうことを防ぐために、クライアント側から指定されます。
                    指定は任意で、UUID V4フォーマットでランダム生成した文字列です。リクエストIDは一定期間で削除されます。

                    リクエストIDを指定したとき、まだそのリクエストIDに対する取引がない場合、新規に取引が作られレスポンスとして返されます。
                    もしそのリクエストIDに対する取引が既にある場合、既存の取引がレスポンスとして返されます。
                    既に存在する、別のユーザによる取引とリクエストIDが衝突した場合、request_id_conflictが返ります。
                  example: '9dbfd997-b948-40d3-a3bf-6bc1a01368d2'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TransactionDetail'
        '400':
          $ref: '#/components/responses/BadRequest'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'

  /transactions/transfer:
    post:
      tags:
        - Transaction
      summary: '個人間送金'
      description: |
        エンドユーザー間での送金取引(個人間送金)を作成します。
        個人間送金で送れるのはマネーのみで、ポイントを送ることはできません。送金元のマネー残高のうち、有効期限が最も遠いものから順に送金されます。
      x-pokepay-operator-name: "CreateTransferTransaction"
      x-pokepay-allow-server-side: true
      requestBody:
        required: true
        content:
          application/json:
            schema:
              required: ["private_money_id", "sender_id", "receiver_id", "amount"]
              properties:
                sender_id:
                  type: string
                  format: uuid
                  title: '送金元ユーザーID'
                  description: |-
                    エンドユーザーIDです。

                    送金元のエンドユーザー(送り主)を指定します。
                receiver_id:
                  type: string
                  format: uuid
                  title: '受取ユーザーID'
                  description: |-
                    エンドユーザーIDです。

                    送金先のエンドユーザー(受け取り人)を指定します。
                private_money_id:
                  type: string
                  format: uuid
                  title: 'マネーID'
                  description: |-
                    マネーIDです。

                    マネーを指定します。
                amount:
                  type: number
                  minimum: 0
                  title: '送金額'
                  description: |-
                    マネー額です。

                    送金するマネー額を指定します。
                metadata:
                  type: string
                  format: json
                  title: '取引メタデータ'
                  description:  |-
                    取引作成時に指定されるメタデータです。

                    任意入力で、全てのkeyとvalueが文字列であるようなフラットな構造のJSON文字列で指定します。
                  example: |-
                    {"key":"value"}
                description:
                  type: string
                  maxLength: 200
                  title: '取引履歴に表示する説明文'
                  description:  |-
                    取引説明文です。

                    任意入力で、取引履歴に表示される説明文です。
                  example: たい焼き(小倉)
                request_id:
                  type: string
                  format: uuid
                  title: 'リクエストID'
                  description: |-
                    取引作成APIの羃等性を担保するためのリクエスト固有のIDです。

                    取引作成APIで結果が受け取れなかったなどの理由で再試行する際に、二重に取引が作られてしまうことを防ぐために、クライアント側から指定されます。指定は任意で、UUID V4フォーマットでランダム生成した文字列です。リクエストIDは一定期間で削除されます。

                    リクエストIDを指定したとき、まだそのリクエストIDに対する取引がない場合、新規に取引が作られレスポンスとして返されます。もしそのリクエストIDに対する取引が既にある場合、既存の取引がレスポンスとして返されます。
                    既に存在する、別のユーザによる取引とリクエストIDが衝突した場合、request_id_conflictが返ります。
                  example: '9dbfd997-b948-40d3-a3bf-6bc1a01368d2'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TransactionDetail'
        '400':
          $ref: '#/components/responses/BadRequest'
        '403':
          $ref: '#/components/responses/Forbidden'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'
  /transactions/exchange:
    post:
      tags:
        - Transaction
      x-pokepay-allow-server-side: true
      x-pokepay-operator-name: "CreateExchangeTransaction"
      requestBody:
        required: true
        content:
          application/json:
            schema:
              required: ["user_id", "sender_private_money_id", "receiver_private_money_id", "amount"]
              properties:
                user_id:
                  type: string
                  format: uuid
                sender_private_money_id:
                  type: string
                  format: uuid
                receiver_private_money_id:
                  type: string
                  format: uuid
                amount:
                  type: integer
                  minimum: 1
                description:
                  type: string
                  maxLength: 200
                request_id:
                  type: string
                  format: uuid
                  title: 'リクエストID'
                  description: |-
                    取引作成APIの羃等性を担保するためのリクエスト固有のIDです。

                    取引作成APIで結果が受け取れなかったなどの理由で再試行する際に、二重に取引が作られてしまうことを防ぐために、クライアント側から指定されます。指定は任意で、UUID V4フォーマットでランダム生成した文字列です。リクエストIDは一定期間で削除されます。

                    リクエストIDを指定したとき、まだそのリクエストIDに対する取引がない場合、新規に取引が作られレスポンスとして返されます。もしそのリクエストIDに対する取引が既にある場合、既存の取引がレスポンスとして返されます。
                    既に存在する、別のユーザによる取引とリクエストIDが衝突した場合、request_id_conflictが返ります。
                  example: '9dbfd997-b948-40d3-a3bf-6bc1a01368d2'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TransactionDetail'
        '400':
          $ref: '#/components/responses/BadRequest'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'
  /transactions/bulk:
    post:
      tags:
        - Bulk
      summary: CSVファイル一括取引
      description: CSVファイルから一括取引をします。
      x-pokepay-operator-name: "BulkCreateTransaction"
      x-pokepay-allow-server-side: true
      requestBody:
        required: true
        content:
          application/json:
            schema:
              required: ["name", "content", "request_id"]
              properties:
                name:
                  type: string
                  maxLength: 32
                  title: 一括取引タスク名
                  description: |-
                    一括取引タスクの管理用の名前です。
                description:
                  type: string
                  maxLength: 128
                  title: 一括取引の説明
                  description: |-
                    一括取引タスクの管理用の説明文です。
                content:
                  type: string
                  title: 取引する情報のCSV
                  description: |-
                    一括取引する情報を書いたCSVの文字列です。
                    1行目はヘッダ行で、2行目以降の各行にカンマ区切りの取引データを含みます。
                    カラムは以下の7つです。任意のカラムには空文字を指定します。

                    - `type`: 取引種別
                      - 必須。'topup' または 'payment'
                    - `sender_id`: 送金ユーザーID
                      - 必須。UUID
                    - `receiver_id`: 受取ユーザーID
                      - 必須。UUID
                    - `private_money_id`: マネーID
                      - 必須。UUID
                    - `money_amount`: マネー額
                      - 任意。ただし `point_amount` といずれかが必須。0以上の数字
                    - `point_amount`: ポイント額
                      - 任意。ただし `money_amount` といずれかが必須。0以上の数字
                    - `description`: 取引の説明文
                      - 任意。200文字以内。取引履歴に表示される文章
                    - `bear_account_id`: ポイント負担ウォレットID
                      - `point_amount` があるときは必須。UUID
                    - `point_expires_at`: ポイントの有効期限
                      - 任意。指定がないときはマネーに設定された有効期限を適用
                request_id:
                  type: string
                  minLength: 36
                  maxLength: 36
                  title: リクエストID
                  description: |-
                    重複したリクエストを判断するためのユニークID。ランダムな36字の文字列を生成して渡してください。
                private_money_id:
                  type: string
                  format: uuid
                  title: 'マネーID'
                  description: |-
                    マネーIDです。 マネーを指定します。
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BulkTransaction'
        '400':
          $ref: '#/components/responses/BadRequest'
        '403':
          $ref: '#/components/responses/Forbidden'
        '409':
          $ref: '#/components/responses/Conflict'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'
  /transactions/{transaction_id}:
    get:
      tags:
        - Transaction
      summary: '取引情報を取得する'
      description: 取引を取得します。
      x-pokepay-operator-name: "GetTransaction"
      x-pokepay-allow-server-side: true
      parameters:
        - in: path
          name: transaction_id
          required: true
          schema:
            type: string
            format: uuid
            title: '取引ID'
          description: |-
            取引IDです。

            フィルターとして使われ、指定した取引IDの取引を取得します。
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TransactionDetail'
        '400':
          $ref: '#/components/responses/InvalidParameters'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
  /transactions/{transaction_id}/refund:
    post:
      tags:
        - Transaction
      summary: '取引をキャンセルする'
      description: |-
        取引IDを指定して取引をキャンセルします。

        発行体の管理者は自組織の直営店、または発行しているマネーの決済加盟店組織での取引をキャンセルできます。
        キャンセル対象の取引に付随するポイント還元キャンペーンやクーポン適用も取り消されます。

        チャージ取引のキャンセル時に返金すべき残高が足りないときは `account_balance_not_enough (422)` エラーが返ります。
        取引をキャンセルできるのは1回きりです。既にキャンセルされた取引を重ねてキャンセルしようとすると `transaction_already_refunded (422)` エラーが返ります。
      x-pokepay-operator-name: RefundTransaction
      x-pokepay-allow-server-side: true
      parameters:
        - in: path
          name: transaction_id
          required: true
          schema:
            type: string
            format: uuid
            title: '取引ID'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              properties:
                description:
                  type: string
                  maxLength: 200
                  title: '取引履歴に表示する返金事由'
                  example: '返品対応のため'
                returning_point_expires_at:
                  type: string
                  format: date-time
                  title: '返却ポイントの有効期限'
                  description: |-
                    ポイント支払いを含む支払い取引をキャンセルする際にユーザへ返却されるポイントの有効期限です。デフォルトでは未指定です。
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TransactionDetail'
        '403':
          $ref: '#/components/responses/Forbidden'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'
  /transactions/requests/{request_id}:
    get:
      tags:
        - Transaction
      summary: 'リクエストIDから取引情報を取得する'
      description: 取引を取得します。
      x-pokepay-operator-name: "GetTransactionByRequestId"
      x-pokepay-allow-server-side: true
      parameters:
        - in: path
          name: request_id
          required: true
          schema:
            type: string
            format: uuid
            title: 'リクエストID'
          description: |-
            取引作成時にクライアントが生成し指定するリクエストIDです。

            リクエストIDに対応する取引が存在すればその取引を返し、無ければNotFound(404)を返します。
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TransactionDetail'
        '400':
          $ref: '#/components/responses/InvalidParameters'
        '403':
          $ref: '#/components/responses/Forbidden'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'
  /external-transactions:
    post:
      tags:
        - Event
      summary: 'ポケペイ外部取引を作成する'
      description: |
        ポケペイ外部取引を作成します。

        ポケペイ外の現金決済やクレジットカード決済に対してポケペイのポイントを付けたいというときに使用します。
      x-pokepay-operator-name: "CreateExternalTransaction"
      x-pokepay-allow-server-side: true
      requestBody:
        required: true
        content:
          application/json:
            schema:
              required:
                - private_money_id
                - shop_id
                - customer_id
                - amount
              properties:
                shop_id:
                  type: string
                  format: uuid
                  title: 店舗ID
                  description: |-
                    店舗IDです。

                    ポケペイ外部取引が行なう店舗を指定します。
                customer_id:
                  type: string
                  format: uuid
                  title: エンドユーザーID
                  description: |-
                    エンドユーザーIDです。

                    エンドユーザーを指定します。
                private_money_id:
                  type: string
                  format: uuid
                  title: マネーID
                  description: |-
                    マネーIDです。

                    マネーを指定します。
                amount:
                  type: integer
                  minimum: 0
                  title: 取引額
                  description: |-
                    取引金額です。
                description:
                  type: string
                  maxLength: 200
                  title: 取引説明文
                  description: |-
                    取引説明文です。

                    任意入力で、取引履歴に表示される説明文です。
                  example: たい焼き(小倉)
                metadata:
                  type: string
                  format: json
                  title: ポケペイ外部取引メタデータ
                  description: |-
                    ポケペイ外部取引作成時に指定され、取引と紐付けられるメタデータです。

                    任意入力で、全てのkeyとvalueが文字列であるようなフラットな構造のJSONで指定します。
                  example: |-
                    {"key":"value"}
                products:
                  $ref: '#/components/schemas/Products'
                request_id:
                  type: string
                  format: uuid
                  title: リクエストID
                  description: |-
                    取引作成APIの羃等性を担保するためのリクエスト固有のIDです。

                    取引作成APIで結果が受け取れなかったなどの理由で再試行する際に、二重に取引が作られてしまうことを防ぐために、クライアント側から指定されます。指定は任意で、UUID V4フォーマットでランダム生成した文字列です。リクエストIDは一定期間で削除されます。

                    リクエストIDを指定したとき、まだそのリクエストIDに対する取引がない場合、新規に取引が作られレスポンスとして返されます。もしそのリクエストIDに対する取引が既にある場合、既存の取引がレスポンスとして返されます。
                  example: 9dbfd997-b948-40d3-a3bf-6bc1a01368d2
                done_at:
                  type: string
                  format: date-time
                  title: 'ポケペイ外部取引の実施時間'
                  description: |-
                    ポケペイ外部取引が実際に起こった時間です。
                    時間帯指定のポイント付与キャンペーンでの取引時間の計算に使われます。
                    デフォルトではCreateExternalTransactionがリクエストされた時間になります。
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExternalTransactionDetail'
        '400':
          $ref: '#/components/responses/BadRequest'
        '403':
          $ref: '#/components/responses/Forbidden'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'
  /external-transactions/{event_id}/refund:
    post:
      tags:
        - Event
      summary: 'ポケペイ外部取引をキャンセルする'
      description: |-
        取引IDを指定して取引をキャンセルします。

        発行体の管理者は自組織の直営店、または発行しているマネーの決済加盟店組織での取引をキャンセルできます。
        キャンセル対象のポケペイ外部取引に付随するポイント還元キャンペーンも取り消されます。

        取引をキャンセルできるのは1回きりです。既にキャンセルされた取引を重ねてキャンセルしようとすると `transaction_already_refunded (422)` エラーが返ります。
      x-pokepay-operator-name: RefundExternalTransaction
      x-pokepay-allow-server-side: true
      parameters:
        - in: path
          name: event_id
          required: true
          schema:
            type: string
            format: uuid
            title: '取引ID'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              properties:
                description:
                  type: string
                  maxLength: 200
                  title: '取引履歴に表示する返金事由'
                  example: '返品対応のため'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExternalTransactionDetail'
        '403':
          $ref: '#/components/responses/Forbidden'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'
  /external-transactions/requests/{request_id}:
    get:
      tags:
        - Event
      summary: 'リクエストIDからポケペイ外部取引を取得する'
      description: |-
        リクエストIDを指定してポケペイ外部取引を取得します。

        発行体の管理者は自組織発行のマネーに紐付くポケペイ外部取引を取得できます。

      x-pokepay-operator-name: GetExternalTransactionByRequestId
      x-pokepay-allow-server-side: true
      parameters:
        - in: path
          name: request_id
          required: true
          schema:
            type: string
            format: uuid
            title: 'リクエストID'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExternalTransactionDetail'
        '403':
          $ref: '#/components/responses/Forbidden'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'
  /transfers:
    get:
      tags:
        - Transfer
      x-pokepay-operator-name: "ListTransfers"
      x-pokepay-allow-server-side: true
      requestBody:
        required: true
        content:
          application/json:
            schema:
              properties:
                from:
                  type: string
                  format: date-time
                to:
                  type: string
                  format: date-time
                page:
                  type: integer
                  minimum: 1
                per_page:
                  type: integer
                  minimum: 1
                shop_id:
                  type: string
                  format: uuid
                shop_name:
                  type: string
                  maxLength: 256
                customer_id:
                  type: string
                  format: uuid
                customer_name:
                  type: string
                  maxLength: 256
                transaction_id:
                  type: string
                  format: uuid
                private_money_id:
                  type: string
                  format: uuid
                is_modified:
                  type: boolean
                transaction_types:
                  type: array
                  items:
                    type: string
                    enum: [topup, payment, transfer, exchange, cashback, expire]
                transfer_types:
                  type: array
                  description: |-
                    取引明細の種類でフィルターします。

                    以下の種類を指定できます。

                    1. topup
                    店舗からエンドユーザーへの送金取引(チャージ)、またはそのキャンセル取引

                    2. payment
                    エンドユーザーから店舗への送金取引(支払い)、またはそのキャンセル取引

                    3. exchange
                    他マネーへの流出/流入

                    4. campaign
                    取引に対するポイント還元キャンペーンによるポイント付与、またはそのキャンセル取引

                    5. coupon
                    クーポンによる値引き処理、またはそのキャンセル取引

                    6. cashback
                    退会時の返金取引

                    7. expire
                    退会時失効取引
                  items:
                    type: string
                    enum: [topup, payment, exchange, transfer, coupon, campaign, cashback, expire]
                description:
                  type: string
                  maxLength: 200
                  title: '取引詳細説明文'
                  description: |-
                    取引詳細を指定の取引詳細説明文でフィルターします。

                    取引詳細説明文が完全一致する取引のみ抽出されます。取引詳細説明文は最大200文字で記録されています。
                  example: 店頭QRコードによる支払い
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedTransfers'
        '400':
          $ref: '#/components/responses/InvalidParameters'

  /transfers-v2:
    get:
      tags:
        - Transfer
      x-pokepay-operator-name: "ListTransfersV2"
      x-pokepay-allow-server-side: true
      requestBody:
        required: true
        content:
          application/json:
            schema:
              properties:
                shop_id:
                  type: string
                  format: uuid
                  title: '店舗ID'
                  description: |-
                    店舗IDです。

                    フィルターとして使われ、指定された店舗での取引のみ一覧に表示されます。
                shop_name:
                  type: string
                  maxLength: 256
                  title: '店舗名'
                  description: |-
                    店舗名です。

                    フィルターとして使われ、入力された名前に部分一致する店舗での取引のみ一覧に表示されます。
                customer_id:
                  type: string
                  format: uuid
                  title: 'エンドユーザーID'
                  description: |-
                    エンドユーザーIDです。

                    フィルターとして使われ、指定されたエンドユーザーの取引のみ一覧に表示されます。
                customer_name:
                  type: string
                  maxLength: 256
                  title: 'エンドユーザー名'
                  description: |-
                    エンドユーザー名です。

                    フィルターとして使われ、入力された名前に部分一致するエンドユーザーでの取引のみ一覧に表示されます。
                transaction_id:
                  type: string
                  format: uuid
                  title: '取引ID'
                  description: |-
                    取引IDです。

                    フィルターとして使われ、指定された取引IDに部分一致(前方一致)する取引のみが一覧に表示されます。
                private_money_id:
                  type: string
                  format: uuid
                  title: 'マネーID'
                  description: |-
                    マネーIDです。

                    指定したマネーでの取引が一覧に表示されます。
                is_modified:
                  type: boolean
                  title: 'キャンセルフラグ'
                  description: |-
                    キャンセルフラグです。

                    これにtrueを指定するとキャンセルされた取引のみ一覧に表示されます。
                    デフォルト値はfalseで、キャンセルの有無にかかわらず一覧に表示されます。
                transaction_types:
                  type: array
                  title: '取引種別 (複数指定可)、チャージ=topup、支払い=payment'
                  description: |-
                    取引の種類でフィルターします。

                    以下の種類を指定できます。

                    1. topup
                       店舗からエンドユーザーへの送金取引(チャージ)

                    2. payment
                       エンドユーザーから店舗への送金取引(支払い)

                    3. exchange-outflow
                       他マネーへの流出
                       private_money_idが指定されたとき、そのマネーから見て流出方向の交換取引が抽出されます。
                       private_money_idを省略した場合は表示されません。

                    4. exchange-inflow
                       他マネーからの流入
                       private_money_idが指定されたとき、そのマネーから見て流入方向の交換取引が抽出されます。
                       private_money_idを省略した場合は表示されません。

                    5. cashback
                       退会時返金取引

                    6. expire
                       退会時失効取引
                  items:
                    type: string
                    enum: [topup, payment, transfer, exchange, cashback, expire]
                next_page_cursor_id:
                  type: string
                  format: uuid
                  title: '次ページへ遷移する際に起点となるtransferのID'
                  description: |-
                    次ページへ遷移する際に起点となるtransferのID(前ページの末尾要素のID)です。
                    本APIのレスポンスにもnext_page_cursor_idが含まれており、これがnull値の場合は最後のページであることを意味します。
                    UUIDである場合は次のページが存在することを意味し、このnext_page_cursor_idをリクエストパラメータに含めることで次ページに遷移します。

                    next_page_cursor_idのtransfer自体は次のページには含まれません。
                prev_page_cursor_id:
                  type: string
                  format: uuid
                  title: '前ページへ遷移する際に起点となるtransferのID'
                  description: |-
                    前ページへ遷移する際に起点となるtransferのID(次ページの先頭要素のID)です。

                    本APIのレスポンスにもprev_page_cursor_idが含まれており、これがnull値の場合は先頭のページであることを意味します。
                    UUIDである場合は前のページが存在することを意味し、このprev_page_cursor_idをリクエストパラメータに含めることで前ページに遷移します。

                    prev_page_cursor_idのtransfer自体は前のページには含まれません。
                per_page:
                  type: integer
                  minimum: 1
                  maximum: 1000
                  title: '1ページ分の取引数'
                  description: |-
                    1ページ分の取引数です。

                    デフォルト値は50です。
                  example: 50
                transfer_types:
                  type: array
                  title: '取引明細種別 (複数指定可)'
                  description: |-
                    取引明細の種類でフィルターします。

                    以下の種類を指定できます。

                    1. topup
                    店舗からエンドユーザーへの送金取引(チャージ)、またはそのキャンセル取引

                    2. payment
                    エンドユーザーから店舗への送金取引(支払い)、またはそのキャンセル取引

                    3. exchange
                    他マネーへの流出/流入

                    4. campaign
                    取引に対するポイント還元キャンペーンによるポイント付与、またはそのキャンセル取引

                    5. coupon
                    クーポンによる値引き処理、またはそのキャンセル取引

                    6. cashback
                    退会時の返金取引

                    7. expire
                    退会時失効取引
                  items:
                    type: string
                    enum: [topup, payment, exchange, transfer, coupon, campaign, cashback, expire]
                description:
                  type: string
                  maxLength: 200
                  title: '取引詳細説明文'
                  description: |-
                    取引詳細を指定の取引詳細説明文でフィルターします。

                    取引詳細説明文が完全一致する取引のみ抽出されます。取引詳細説明文は最大200文字で記録されています。
                  example: 店頭QRコードによる支払い
                from:
                  type: string
                  format: date-time
                  title: '開始日時'
                  description: |-
                    抽出期間の開始日時です。

                    フィルターとして使われ、開始日時以降に発生した取引のみ一覧に表示されます。
                to:
                  type: string
                  format: date-time
                  title: '終了日時'
                  description: |-
                    抽出期間の終了日時です。

                    フィルターとして使われ、終了日時以前に発生した取引のみ一覧に表示されます。

      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedTransfersV2'
        '400':
          $ref: '#/components/responses/InvalidParameters'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'

  /organizations:
    get:
      tags:
        - Organization
      summary: '加盟店組織の一覧を取得する'
      x-pokepay-allow-server-side: true
      x-pokepay-operator-name: "ListOrganizations"
      requestBody:
        required: true
        content:
          application/json:
            schema:
              required: ["private_money_id"]
              properties:
                private_money_id:
                  type: string
                  format: uuid
                  title: 'マネーID'
                  description: |-
                    マネーIDです。
                    このマネーに加盟している加盟組織がフィルターされます。
                page:
                  type: integer
                  minimum: 1
                  title: 'ページ番号'
                  description: 取得したいページ番号です。
                  example: 1
                per_page:
                  type: integer
                  minimum: 1
                  title: '1ページ分の取引数'
                  description: 1ページ分の取引数です。
                  example: 50
                name:
                  type: string
                  title: '組織名'
                code:
                  type: string
                  title: '組織コード'
                #これらのパラメータは管理画面のユースケースに特化してそうなので一旦コメントアウトしておく
                #with_issuer_org:
                #  type: boolean
                #with_details:
                #  type: boolean
                #with_disabled_member_orgs:
                #  type: boolean
                #with_all_members:
                #  type: boolean
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedOrganizations'
        '400':
          $ref: '#/components/responses/BadRequest'
        '403':
          $ref: '#/components/responses/Forbidden'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'
    post:
      tags:
        - Organization
      summary: '新規加盟店組織を追加する'
      x-pokepay-operator-name: "CreateOrganization"
      requestBody:
        required: true
        content:
          application/json:
            schema:
              required: ["code", "name", "private_money_ids", "issuer_admin_user_email", "member_admin_user_email"]
              properties:
                code:
                  type: string
                  maxLength: 32
                  title: '新規組織コード'
                  example: ox-supermarket
                name:
                  type: string
                  maxLength: 256
                  title: '新規組織名'
                  example: oxスーパー
                private_money_ids:
                  type: array
                  items:
                    type: string
                    format: uuid
                  minItems: 1
                  title: '加盟店組織で有効にするマネーIDの配列'
                issuer_admin_user_email:
                  type: string
                  format: email
                  title: '発行体担当者メールアドレス'
                member_admin_user_email:
                  type: string
                  format: email
                  title: '新規組織担当者メールアドレス'
                bank_name:
                  type: string
                  maxLength: 64
                  title: '銀行名'
                  example: XYZ銀行
                bank_code:
                  type: string
                  pattern: '^$|^[0-9]{4}$'
                  title: '銀行金融機関コード'
                  example: '1234'
                bank_branch_name:
                  type: string
                  maxLength: 64
                  title: '銀行支店名'
                  example: ABC支店
                bank_branch_code:
                  type: string
                  pattern: '^(|[0-9]{3})$'
                  title: '銀行支店コード'
                  example: '123'
                bank_account_type:
                  type: string
                  enum: [saving, current, other]
                  title: '銀行口座種別 (普通=saving, 当座=current, その他=other)'
                bank_account:
                  type: string
                  maxLength: 7
                  pattern: '[0-9]{0,7}'
                  title: '銀行口座番号'
                  example: '1234567'
                bank_account_holder_name:
                  # TODO: flico
                  type: string
                  maxLength: 30
                  pattern: '^[0-9A-Zｦｱ-ﾟ (-),-/\\｢-｣]$'
                  title: '口座名義人名'
                  example: ﾌｸｻﾞﾜﾕｷﾁ
                contact_name:
                  type: string
                  maxLength: 256
                  title: '担当者名'
                  example: 佐藤清
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Organization'
  /shops:
    get:
      tags:
        - Shop
      summary: '店舗一覧を取得する'
      x-pokepay-operator-name: "ListShops"
      x-pokepay-allow-server-side: true
      requestBody:
        required: true
        content:
          application/json:
            schema:
              properties:
                organization_code:
                  type: string
                  pattern: '^[a-zA-Z0-9-]*$'
                  maxLength: 32
                  title: '組織コード'
                  description: |
                    このパラメータを渡すとその組織の店舗のみが返され、省略すると加盟店も含む店舗が返されます。
                  example: 'pocketchange'
                private_money_id:
                  type: string
                  format: uuid
                  title: 'マネーID'
                  description: |
                    このパラメータを渡すとそのマネーのウォレットを持つ店舗のみが返されます。
                name:
                  type: string
                  minLength: 1
                  maxLength: 256
                  title: '店舗名'
                  example: 'oxスーパー三田店'
                  description: |
                    このパラメータを渡すとその名前の店舗のみが返されます。
                postal_code:
                  type: string
                  pattern: '^[0-9]{3}-?[0-9]{4}$'
                  title: '店舗の郵便番号'
                  description: |
                    このパラメータを渡すとその郵便番号が登録された店舗のみが返されます。
                address:
                  type: string
                  maxLength: 256
                  title: '店舗の住所'
                  example: '東京都港区芝...'
                  description: |
                    このパラメータを渡すとその住所が登録された店舗のみが返されます。
                tel:
                  type: string
                  pattern: '^0[0-9]{1,3}-?[0-9]{2,4}-?[0-9]{3,4}$'
                  title: '店舗の電話番号'
                  description: |
                    このパラメータを渡すとその電話番号が登録された店舗のみが返されます。
                email:
                  type: string
                  format: email
                  maxLength: 256
                  title: '店舗のメールアドレス'
                  description: |
                    このパラメータを渡すとそのメールアドレスが登録された店舗のみが返されます。
                external_id:
                  type: string
                  maxLength: 36
                  title: '店舗の外部ID'
                  description: |
                    このパラメータを渡すとその外部IDが登録された店舗のみが返されます。
                with_disabled:
                  type: boolean
                  title: '無効な店舗を含める'
                  description: |
                    このパラメータを渡すと無効にされた店舗を含めて返されます。デフォルトでは無効にされた店舗は返されません。
                page:
                  type: integer
                  minimum: 1
                  title: 'ページ番号'
                  description: 取得したいページ番号です。
                  example: 1
                per_page:
                  type: integer
                  minimum: 1
                  title: '1ページ分の取引数'
                  description: 1ページ分の取引数です。
                  example: 50
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedShops'
        '400':
          $ref: '#/components/responses/BadRequest'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'
    post:
      tags:
        - Shop
      summary: '【廃止】新規店舗を追加する'
      description: |-
        新規店舗を追加します。このAPIは廃止予定です。以降は `CreateShopV2` を使用してください。
      x-pokepay-operator-name: "CreateShop"
      x-pokepay-allow-server-side: true
      requestBody:
        required: true
        content:
          application/json:
            schema:
              required: ["shop_name"]
              properties:
                shop_name:
                  type: string
                  minLength: 1
                  maxLength: 256
                  title: '店舗名'
                  example: 'oxスーパー三田店'
                shop_postal_code:
                  type: string
                  pattern: '^[0-9]{3}-?[0-9]{4}$'
                  title: '店舗の郵便番号'
                shop_address:
                  type: string
                  maxLength: 256
                  title: '店舗の住所'
                  example: '東京都港区芝...'
                shop_tel:
                  type: string
                  pattern: '^0[0-9]{1,3}-?[0-9]{2,4}-?[0-9]{3,4}$'
                  title: '店舗の電話番号'
                shop_email:
                  type: string
                  format: email
                  maxLength: 256
                  title: '店舗のメールアドレス'
                shop_external_id:
                  type: string
                  maxLength: 36
                  title: '店舗の外部ID'
                organization_code:
                  type: string
                  pattern: '^[a-zA-Z0-9-]*$'
                  maxLength: 32
                  title: '組織コード'
                  example: 'ox-supermarket'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/User'
        '400':
          $ref: '#/components/responses/InvalidParameters'
        '403':
          $ref: '#/components/responses/Forbidden'
        '409':
          $ref: '#/components/responses/Conflict'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'
  /shops-v2:
    post:
      tags:
        - Shop
      summary: '新規店舗を追加する'
      x-pokepay-operator-name: "CreateShopV2"
      x-pokepay-allow-server-side: true
      requestBody:
        required: true
        content:
          application/json:
            schema:
              required: ["name"]
              properties:
                name:
                  type: string
                  minLength: 1
                  maxLength: 256
                  title: '店舗名'
                  description: |-
                    店舗名です。

                    同一組織内に同名の店舗があった場合は`name_conflict`エラーが返ります。
                  example: 'oxスーパー三田店'
                postal_code:
                  type: string
                  pattern: '^[0-9]{3}-?[0-9]{4}$'
                  title: '店舗の郵便番号'
                address:
                  type: string
                  maxLength: 256
                  title: '店舗の住所'
                  example: '東京都港区芝...'
                tel:
                  type: string
                  pattern: '^0[0-9]{1,3}-?[0-9]{2,4}-?[0-9]{3,4}$'
                  title: '店舗の電話番号'
                email:
                  type: string
                  format: email
                  maxLength: 256
                  title: '店舗のメールアドレス'
                external_id:
                  type: string
                  maxLength: 36
                  title: '店舗の外部ID'
                organization_code:
                  type: string
                  pattern: '^[a-zA-Z0-9-]*$'
                  maxLength: 32
                  title: '組織コード'
                  example: 'ox-supermarket'
                private_money_ids:
                  type: array
                  items:
                    type: string
                    format: uuid
                  minItems: 1
                  title: '店舗で有効にするマネーIDの配列'
                  description: |-
                    店舗で有効にするマネーIDの配列を指定します。

                    店舗が所属する組織が発行または加盟しているマネーのみが指定できます。利用できないマネーが指定された場合は`unavailable_private_money`エラーが返ります。
                    このパラメータを省略したときは、店舗が所属する組織が発行または加盟している全てのマネーのウォレットができます。
                can_topup_private_money_ids:
                  type: array
                  items:
                    type: string
                    format: uuid
                  minItems: 0
                  title: '店舗でチャージ可能にするマネーIDの配列'
                  description: |-
                    店舗でチャージ可能にするマネーIDの配列を指定します。

                    このパラメータは発行体のみが指定でき、自身が発行しているマネーのみを指定できます。加盟店が他発行体のマネーに加盟している場合でも、そのチャージ可否を変更することはできません。
                    省略したときは対象店舗のその発行体の全てのマネーのアカウントがチャージ不可となります。
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ShopWithAccounts'
        '400':
          $ref: '#/components/responses/InvalidParameters'
        '403':
          $ref: '#/components/responses/Forbidden'
        '409':
          $ref: '#/components/responses/Conflict'
        '422':
          description:
          content:
            application/json:
              schema:
                oneOf:
                  - $ref: '#/components/schemas/PrivateMoneyNotAvailable'
                  - $ref: '#/components/schemas/UnprocessableEntity'
  /shops/{shop_id}:
    get:
      tags:
        - Shop
      summary: '店舗情報を表示する'
      description: |-
        店舗情報を表示します。

        権限に関わらず自組織の店舗情報は表示可能です。それに加え、発行体は自組織の発行しているマネーの加盟店組織の店舗情報を表示できます。
      x-pokepay-operator-name: "GetShop"
      x-pokepay-allow-server-side: true
      parameters:
        - in: path
          name: shop_id
          required: true
          schema:
            type: string
            format: uuid
            title: '店舗ユーザーID'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ShopWithAccounts'
        '400':
          $ref: '#/components/responses/InvalidParameters'
        '403':
          $ref: '#/components/responses/Forbidden'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'
    patch:
      tags:
        - Shop
      summary: '店舗情報を更新する'
      description: |-
        店舗情報を更新します。bodyパラメーターは全て省略可能で、指定したもののみ更新されます。
      x-pokepay-operator-name: "UpdateShop"
      x-pokepay-allow-server-side: true
      parameters:
        - in: path
          name: shop_id
          required: true
          schema:
            type: string
            format: uuid
            title: '店舗ユーザーID'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              properties:
                name:
                  type: string
                  minLength: 1
                  maxLength: 256
                  title: '店舗名'
                  description: |-
                    店舗名です。

                    同一組織内に同名の店舗があった場合は`shop_name_conflict`エラーが返ります。
                  example: 'oxスーパー三田店'
                postal_code:
                  type: string
                  pattern: '^[0-9]{3}-?[0-9]{4}$'
                  title: '店舗の郵便番号'
                  description: |-
                    店舗住所の郵便番号(7桁の数字)です。ハイフンは無視されます。明示的に空の値を設定するにはNULLを指定します。
                  nullable: true
                address:
                  type: string
                  maxLength: 256
                  title: '店舗の住所'
                  example: '東京都港区芝...'
                  nullable: true
                tel:
                  type: string
                  pattern: '^0[0-9]{1,3}-?[0-9]{2,4}-?[0-9]{3,4}$'
                  title: '店舗の電話番号'
                  description: |-
                    店舗の電話番号です。ハイフンは無視されます。明示的に空の値を設定するにはNULLを指定します。
                  nullable: true
                email:
                  type: string
                  format: email
                  maxLength: 256
                  title: '店舗のメールアドレス'
                  description: |-
                    店舗の連絡先メールアドレスです。明示的に空の値を設定するにはNULLを指定します。
                  nullable: true
                external_id:
                  type: string
                  maxLength: 36
                  title: '店舗の外部ID'
                  description: |-
                    店舗の外部IDです(最大36文字)。明示的に空の値を設定するにはNULLを指定します。
                  nullable: true
                private_money_ids:
                  type: array
                  items:
                    type: string
                    format: uuid
                  minItems: 0
                  title: '店舗で有効にするマネーIDの配列'
                  description: |-
                    店舗で有効にするマネーIDの配列を指定します。

                    店舗が所属する組織が発行または加盟しているマネーのみが指定できます。利用できないマネーが指定された場合は`unavailable_private_money`エラーが返ります。
                    店舗が既にウォレットを持っている場合に、ここでそのウォレットのマネーIDを指定しないで更新すると、そのマネーのウォレットは凍結(無効化)されます。
                can_topup_private_money_ids:
                  type: array
                  items:
                    type: string
                    format: uuid
                  minItems: 0
                  title: '店舗でチャージ可能にするマネーIDの配列'
                  description: |-
                    店舗でチャージ可能にするマネーIDの配列を指定します。

                    このパラメータは発行体のみが指定でき、発行しているマネーのみを指定できます。加盟店が他発行体のマネーに加盟している場合でも、そのチャージ可否を変更することはできません。
                    省略したときは対象店舗のその発行体の全てのマネーのアカウントがチャージ不可となります。
                status:
                  type: string
                  enum: [active, disabled]
                  title: '店舗の状態'
                  description: |-
                    店舗の状態です。activeを指定すると有効となり、disabledを指定するとリスト表示から除外されます。
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ShopWithAccounts'
        '400':
          $ref: '#/components/responses/InvalidParameters'
        '403':
          $ref: '#/components/responses/Forbidden'
        '409':
          $ref: '#/components/responses/Conflict'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'
  /private-moneys:
    get:
      tags:
        - Private Money
      summary: マネー一覧を取得する
      description: |-
        マネーの一覧を取得します。
        パートナーキーの管理者が発行体組織に属している場合、自組織が加盟または発行しているマネーの一覧を返します。また、`organization_code`として決済加盟店の組織コードを指定した場合、発行マネーのうち、その決済加盟店組織が加盟しているマネーの一覧を返します。
        パートナーキーの管理者が決済加盟店組織に属している場合は、自組織が加盟しているマネーの一覧を返します。
      x-pokepay-operator-name: "GetPrivateMoneys"
      x-pokepay-allow-server-side: true
      requestBody:
        required: true
        content:
          application/json:
            schema:
              properties:
                organization_code:
                  type: string
                  pattern: '^[a-zA-Z0-9-]*$'
                  maxLength: 32
                  title: '組織コード'
                  description: |-
                    パートナーキーの管理者が発行体組織に属している場合、発行マネーのうち、この組織コードで指定した決済加盟店組織が加盟しているマネーの一覧を返します。決済加盟店組織の管理者は自組織以外を指定することはできません。
                  example: 'ox-supermarket'
                page:
                  type: integer
                  minimum: 1
                  title: 'ページ番号'
                  example: 1
                per_page:
                  type: integer
                  minimum: 1
                  title: '1ページ分の取得数'
                  example: 50
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedPrivateMoneys'
        '400':
          $ref: '#/components/responses/InvalidParameters'
        '403':
          $ref: '#/components/responses/Forbidden'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'
  /private-moneys/{private_money_id}/organization-summaries:
    get:
      tags:
        - Private Money
      summary: 決済加盟店の取引サマリを取得する
      x-pokepay-operator-name: "GetPrivateMoneyOrganizationSummaries"
      x-pokepay-allow-server-side: true
      requestBody:
        required: true
        content:
          application/json:
            schema:
              x-pokepay-conditional-parameters: {xnor: [from, to]}
              properties:
                from:
                  type: string
                  format: date-time
                  title: '開始日時(toと同時に指定する必要有)'
                to:
                  type: string
                  format: date-time
                  title: '終了日時(fromと同時に指定する必要有)'
                page:
                  type: integer
                  minimum: 1
                  title: 'ページ番号'
                  example: 1
                per_page:
                  type: integer
                  minimum: 1
                  title: '1ページ分の取引数'
                  example: 50
      parameters:
        - in: path
          name: private_money_id
          required: true
          schema:
            type: string
            format: uuid
            title: マネーID
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedPrivateMoneyOrganizationSummaries'
        '400':
          $ref: '#/components/responses/InvalidParameters'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
  /private-moneys/{private_money_id}/summary:
    get:
      tags:
        - Private Money
      summary: 取引サマリを取得する
      x-pokepay-operator-name: "GetPrivateMoneySummary"
      x-pokepay-allow-server-side: true
      requestBody:
        required: true
        content:
          application/json:
            schema:
              properties:
                from:
                  type: string
                  format: date-time
                  title: '開始日時'
                to:
                  type: string
                  format: date-time
                  title: '終了日時'
      parameters:
        - in: path
          name: private_money_id
          required: true
          schema:
            type: string
            format: uuid
            title: マネーID
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PrivateMoneySummary'
        '400':
          $ref: '#/components/responses/InvalidParameters'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'
  /customers/transactions:
    get:
      tags:
        - Customer
      summary: '取引履歴を取得する'
      description: '取引一覧を返します。'
      x-pokepay-operator-name: "ListCustomerTransactions"
      x-pokepay-allow-server-side: true
      requestBody:
        required: true
        content:
          application/json:
            schema:
              required: ["private_money_id"]
              properties:
                private_money_id:
                  type: string
                  format: uuid
                  title: 'マネーID'
                  description: |-
                    マネーIDです。
                    フィルターとして使われ、指定したマネーでの取引のみ一覧に表示されます。
                sender_customer_id:
                  type: string
                  format: uuid
                  title: '送金エンドユーザーID'
                  description: |-
                    送金ユーザーIDです。

                    フィルターとして使われ、指定された送金ユーザーでの取引のみ一覧に表示されます。
                receiver_customer_id:
                  type: string
                  format: uuid
                  title: '受取エンドユーザーID'
                  description: |-
                    受取ユーザーIDです。

                    フィルターとして使われ、指定された受取ユーザーでの取引のみ一覧に表示されます。
                type:
                  type: string
                  enum: [topup, payment, exchange, transfer, cashback, expire]
                  title: '取引種別'
                  description: |-
                    取引の種類でフィルターします。

                    以下の種類を指定できます。

                    1. topup
                       店舗からエンドユーザーへの送金取引(チャージ)
                    2. payment
                       エンドユーザーから店舗への送金取引(支払い)
                    3. exchange
                       他マネーへの流出(outflow)/他マネーからの流入(inflow)
                    4. transfer
                       個人間送金
                    5. cashback
                       ウォレット退会時返金
                    6. expire
                       ウォレット退会時失効
                is_modified:
                  type: boolean
                  title: 'キャンセル済みかどうか'
                  description: |-
                    キャンセル済みかどうかを判定するフラグです。

                    これにtrueを指定するとキャンセルされた取引のみ一覧に表示されます。
                    falseを指定するとキャンセルされていない取引のみ一覧に表示されます
                    何も指定しなければキャンセルの有無にかかわらず一覧に表示されます。
                from:
                  type: string
                  format: date-time
                  title: '開始日時'
                  description: |-
                    抽出期間の開始日時です。

                    フィルターとして使われ、開始日時以降に発生した取引のみ一覧に表示されます。
                to:
                  type: string
                  format: date-time
                  title: '終了日時'
                  description: |-
                    抽出期間の終了日時です。

                    フィルターとして使われ、終了日時以前に発生した取引のみ一覧に表示されます。
                page:
                  type: integer
                  minimum: 1
                  title: 'ページ番号'
                  description: 取得したいページ番号です。
                  example: 1
                per_page:
                  type: integer
                  minimum: 1
                  title: '1ページ分の取引数'
                  description: 1ページ分の取引数です。
                  example: 50
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedTransaction'
        '400':
          $ref: '#/components/responses/InvalidParameters'
        '403':
          $ref: '#/components/responses/Forbidden'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'
  /bulk-transactions/{bulk_transaction_id}:
    get:
      tags:
        - Transaction
      summary: バルク取引ジョブの実行状況を取得する
      x-pokepay-operator-name: "GetBulkTransaction"
      x-pokepay-allow-server-side: true
      parameters:
        - in: path
          name: bulk_transaction_id
          schema:
            type: string
            format: uuid
            title: 'バルク取引ジョブID'
          description: |-
            バルク取引ジョブIDです。
            バルク取引ジョブ登録時にレスポンスに含まれます。
          required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BulkTransaction'
        '400':
          $ref: '#/components/responses/InvalidParameters'
        '404':
          $ref: '#/components/responses/NotFound'
  /bulk-transactions/{bulk_transaction_id}/jobs:
    get:
      tags:
        - Transaction
      summary: バルク取引ジョブの詳細情報一覧を取得する
      x-pokepay-operator-name: "ListBulkTransactionJobs"
      x-pokepay-allow-server-side: true
      requestBody:
        required: true
        content:
          application/json:
            schema:
              properties:
                page:
                  type: integer
                  minimum: 1
                  title: 'ページ番号'
                  description: 取得したいページ番号です。
                  example: 1
                per_page:
                  type: integer
                  minimum: 1
                  title: '1ページ分の取得数'
                  description: 1ページ分の取得数です。デフォルトでは 50 になっています。
                  example: 50
      parameters:
        - in: path
          name: bulk_transaction_id
          schema:
            type: string
            format: uuid
            title: 'バルク取引ジョブID'
          description: |-
            バルク取引ジョブIDです。
            バルク取引ジョブ登録時にレスポンスに含まれます。
          required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedBulkTransactionJob'
        '400':
          $ref: '#/components/responses/InvalidParameters'
        '403':
          $ref: '#/components/responses/Forbidden'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'
  /cashtrays:
    post:
      tags:
        - Cashtray
      summary: 'Cashtrayを作る'
      description: |
        Cashtrayを作成します。

        エンドユーザーに対して支払いまたはチャージを行う店舗の情報(店舗ユーザーIDとマネーID)と、取引金額が必須項目です。
        店舗ユーザーIDとマネーIDから店舗ウォレットを特定します。

        その他に、Cashtrayから作られる取引に対する説明文や失効時間を指定できます。

      x-pokepay-operator-name: "CreateCashtray"
      x-pokepay-allow-server-side: true
      requestBody:
        required: true
        content:
          application/json:
            schema:
              required: ["private_money_id", "shop_id", "amount"]
              properties:
                private_money_id:
                  type: string
                  format: uuid
                  title: 'マネーID'
                  description: |-
                    取引対象のマネーのIDです(必須項目)。
                shop_id:
                  type: string
                  format: uuid
                  title: '店舗ユーザーID'
                  description: |-
                    店舗のユーザーIDです(必須項目)。
                amount:
                  type: number
                  title: '金額'
                  description: |-
                    マネー額です(必須項目)。
                    正の値を与えるとチャージになり、負の値を与えると支払いとなります。
                description:
                  type: string
                  maxLength: 200
                  title: '取引履歴に表示する説明文'
                  description:  |-
                    Cashtrayを読み取ったときに作られる取引の説明文です(最大200文字、任意項目)。
                    アプリや管理画面などの取引履歴に表示されます。デフォルトでは空文字になります。
                  example: たい焼き(小倉)
                expires_in:
                  type: integer
                  minimum: 1
                  title: '失効時間(秒)'
                  description: |-
                    Cashtrayが失効するまでの時間を秒単位で指定します(任意項目、デフォルト値は1800秒(30分))。
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Cashtray'
        '400':
          $ref: '#/components/responses/BadRequest'
        '403':
          $ref: '#/components/responses/Forbidden'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'
  /cashtrays/{cashtray_id}:
    get:
      tags:
        - Cashtray
      summary: 'Cashtrayの情報を取得する'
      description: |-
        Cashtrayの情報を取得します。

        Cashtrayの現在の状態に加え、エンドユーザーのCashtray読み取りの試行結果、Cashtray読み取りによって作られた取引情報が取得できます。

        レスポンス中の `attempt` には、このCashtrayをエンドユーザーが読み取った試行結果が入ります。
        `account` はエンドユーザーのウォレット情報です。
        成功時には `attempt` 内の `status_code` に200が入ります。

        まだCashtrayが読み取られていない場合は `attempt` の内容は `NULL` になります。
        エンドユーザーのCashtray読み取りの際には、様々なエラーが起き得ます。
        エラーの詳細は `attempt` 中の `error_type` と `error_message` にあります。主なエラー型と対応するステータスコードを以下に列挙します。

        - `cashtray_already_proceed (422)`
          - 既に処理済みのCashtrayをエンドユーザーが再び読み取ったときに返されます
        - `cashtray_expired (422)`
          - 読み取り時点でCashtray自体の有効期限が切れているときに返されます。Cashtrayが失効する時刻はレスポンス中の `expires_at` にあります
        - `cashtray_already_canceled (422)`
          - 読み取り時点でCashtrayが無効化されているときに返されます
        - `account_balance_not_enough (422)`
          - 支払い時に、エンドユーザーの残高が不足していて取引が完了できなかったときに返されます
        - `account_balance_exceeded`
          - チャージ時に、エンドユーザーのウォレット上限を超えて取引が完了できなかったときに返されます
        - `account_transfer_limit_exceeded (422)`
          - マネーに設定されている一度の取引金額の上限を超えたため、取引が完了できなかったときに返されます
        - `account_money_topup_transfer_limit_exceeded (422)`
          - マネーに設定されている一度のマネーチャージ金額の上限を超えたため、取引が完了できなかったときに返されます
        - `account_not_found (422)`
          - Cashtrayに設定されたマネーのウォレットをエンドユーザーが持っていなかったときに返されます


        レスポンス中の `transaction` には、このCashtrayをエンドユーザーが読み取ることによって作られる取引データが入ります。まだCashtrayが読み取られていない場合は `NULL` になります。

        以上をまとめると、Cashtrayの状態は以下のようになります。

        - エンドユーザーのCashtray読み取りによって取引が成功した場合
          - レスポンス中の `attempt` と `transaction` にそれぞれ値が入ります
        - 何らかの理由で取引が失敗した場合
          - レスポンス中の `attempt` にエラー内容が入り、 `transaction` には `NULL` が入ります
        - まだCashtrayが読み取られていない場合
          - レスポンス中の `attempt` と `transaction` にそれぞれ `NULL` が入ります。Cashtrayの `expires_at` が現在時刻より前の場合は有効期限切れ状態です。

        Cashtrayの取り得る全ての状態を擬似コードで記述すると以下のようになります。
        ```
        if (attempt == null) {
          // 状態は未確定
          if (canceled_at != null) {
            // 無効化済み
          } else if (expires_at < now) {
            // 失効済み
          } else {
            // まだ有効で読み取られていない
          }
        } else if (transaction != null) {
          // 取引成功確定。attempt で読み取ったユーザなどが分かる
        } else {
          // 取引失敗確定。attempt で失敗理由などが分かる
        }
        ```

      x-pokepay-operator-name: "GetCashtray"
      x-pokepay-allow-server-side: true
      parameters:
        - in: path
          name: cashtray_id
          required: true
          schema:
            type: string
            format: uuid
            title: 'CashtrayのID'
          description: |-
            情報を取得するCashtrayのIDです。
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CashtrayWithResult'
        '400':
          $ref: '#/components/responses/InvalidParameters'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'
    delete:
      tags:
        - Cashtray
      summary: 'Cashtrayを無効化する'
      description: |-
        Cashtrayを無効化します。

        これにより、 `GetCashtray` のレスポンス中の `canceled_at` に無効化時点での現在時刻が入るようになります。
        エンドユーザーが無効化されたQRコードを読み取ると `cashtray_already_canceled` エラーとなり、取引は失敗します。
      x-pokepay-operator-name: "CancelCashtray"
      x-pokepay-allow-server-side: true
      parameters:
        - in: path
          name: cashtray_id
          required: true
          schema:
            type: string
            format: uuid
            title: 'CashtrayのID'
          description: |-
            無効化するCashtrayのIDです。
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Cashtray'
        '400':
          $ref: '#/components/responses/BadRequest'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'
    patch:
      tags:
        - Cashtray
      summary: 'Cashtrayの情報を更新する'
      description: Cashtrayの内容を更新します。bodyパラメーターは全て省略可能で、指定したもののみ更新されます。
      x-pokepay-operator-name: "UpdateCashtray"
      x-pokepay-allow-server-side: true
      parameters:
        - in: path
          name: cashtray_id
          required: true
          schema:
            type: string
            format: uuid
            title: 'CashtrayのID'
          description: |-
            更新対象のCashtrayのIDです。
      requestBody:
        required: true
        content:
          application/json:
            schema:
              properties:
                amount:
                  type: number
                  title: '金額'
                  description: |-
                    マネー額です(任意項目)。
                    正の値を与えるとチャージになり、負の値を与えると支払いとなります。
                description:
                  type: string
                  maxLength: 200
                  title: '取引履歴に表示する説明文'
                  description:  |-
                    Cashtrayを読み取ったときに作られる取引の説明文です(最大200文字、任意項目)。
                    アプリや管理画面などの取引履歴に表示されます。
                  example: たい焼き(小倉)
                expires_in:
                  type: integer
                  minimum: 1
                  title: '失効時間(秒)'
                  description: |-
                    Cashtrayが失効するまでの時間を秒で指定します(任意項目、デフォルト値は1800秒(30分))。
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Cashtray'
        '400':
          $ref: '#/components/responses/BadRequest'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'
  /campaigns:
    post:
      tags:
        - Campaign
      summary: 'ポイント付与キャンペーンを作る'
      description: |
        ポイント付与キャンペーンを作成します。
      x-pokepay-operator-name: "CreateCampaign"
      x-pokepay-allow-server-side: true
      requestBody:
        required: true
        content:
          application/json:
            schema:
              required: ["name", "private_money_id", "starts_at", "ends_at","priority", "event"]
              x-pokepay-conditional-parameters:
                xor: [applicable_shop_ids, blacklisted_shop_ids]
              properties:
                name:
                  title: 'キャンペーン名'
                  type: string
                  maxLength: 256
                  description: |-
                    キャンペーン名です(必須項目)。

                    ポイント付与によってできるチャージ取引の説明文に転記されます。取引説明文はエンドユーザーからも確認できます。
                private_money_id:
                  type: string
                  format: uuid
                  title: 'マネーID'
                  description: |-
                    キャンペーン対象のマネーのIDです(必須項目)。
                starts_at:
                  type: string
                  format: date-time
                  title: 'キャンペーン開始日時'
                  description: |-
                    キャンペーン開始日時です(必須項目)。
                    キャンペーン期間中のみポイントが付与されます。
                    開始日時よりも終了日時が前のときはcampaign_invalid_periodエラー(422)になります。
                ends_at:
                  type: string
                  format: date-time
                  title: 'キャンペーン終了日時'
                  description: |-
                    キャンペーン終了日時です(必須項目)。
                    キャンペーン期間中のみポイントが付与されます。
                    開始日時よりも終了日時が前のときはcampaign_invalid_periodエラー(422)になります。
                priority:
                  type: integer
                  title: 'キャンペーンの適用優先度'
                  description: |-
                    キャンペーンの適用優先度です。

                    優先度が大きいものから順に適用判定されていきます。
                    キャンペーン期間が重なっている同一の優先度のキャンペーンが存在するとcampaign_period_overlapsエラー(422)になります。
                event:
                  type: string
                  enum: [topup, payment, external-transaction]
                  title: 'イベント種別'
                  description: |-
                    キャンペーンのトリガーとなるイベントの種類を指定します(必須項目)。

                    以下のいずれかを指定できます。

                    1. topup
                       店舗からエンドユーザーへの送金取引(チャージ)
                    2. payment
                       エンドユーザーから店舗への送金取引(支払い)
                    3. external-transaction
                       ポケペイ外の取引(現金決済など)
                bear_point_shop_id:
                  type: string
                  format: uuid
                  title: 'ポイント負担先店舗ID'
                  description: |-
                    ポイントを負担する店舗のIDです。デフォルトではマネー発行体の本店が設定されます。
                    ポイント負担先店舗は後から更新することはできません。
                description:
                  type: string
                  maxLength: 200
                  title: 'キャンペーンの説明文'
                  description:  |-
                    キャンペーンの内容を記載します。管理画面などでキャンペーンを管理するための説明文になります。
                status:
                  type: string
                  enum: [enabled, disabled]
                  title: 'キャンペーン作成時の状態'
                  description: |-
                    キャンペーン作成時の状態を指定します。デフォルトではenabledです。

                    以下のいずれかを指定できます。

                    1. enabled
                       有効
                    2. disabled
                       無効
                point_expires_at:
                  type: string
                  format: date-time
                  title: 'ポイント有効期限(絶対日時指定)'
                  description: |-
                    キャンペーンによって付与されるポイントの有効期限を絶対日時で指定します。
                    省略した場合はマネーに設定された有効期限と同じものがポイントの有効期限となります。
                point_expires_in_days:
                  type: integer
                  minimum: 1
                  title: 'ポイント有効期限(相対日数指定)'
                  description: |-
                    キャンペーンによって付与されるポイントの有効期限を相対日数で指定します。
                    省略した場合はマネーに設定された有効期限と同じものがポイントの有効期限となります。
                is_exclusive:
                  type: boolean
                  title: 'キャンペーンの重複設定'
                  description: |-
                    キャンペーンの重ね掛けを行うかどうかのフラグです。

                    これにtrueを指定すると他のキャンペーンと同時適用されません。デフォルト値はtrueです。
                    falseを指定すると次の優先度の重ね掛け可能なキャンペーンの適用判定に進みます。
                subject:
                  type: string
                  enum: [money, all]
                  title: 'ポイント付与の対象金額の種別'
                  description: |-
                    ポイント付与額を計算する対象となる金額の種類を指定します。デフォルト値はallです。
                    eventとしてexternal-transactionを指定した場合はポイントとマネーの区別がないためsubjectの指定に関わらず常にallとなります。

                    以下のいずれかを指定できます。

                    1. money
                    moneyを指定すると決済額の中で「マネー」を使って支払った額を対象にします

                    2. all
                    all を指定すると決済額全体を対象にします (「ポイント」での取引額を含む)
                    注意: event を topup にしたときはポイントの付与に対しても適用されます
                amount_based_point_rules:
                  type: array
                  items:
                    type: object
                    properties:
                      point_amount:
                        type: number
                        format: decimal
                        minimum: 0
                        title: '付与ポイント量'
                        description: |-
                          キャンペーンにより付与するポイント量。(必須項目)

                          point_amount_unitにより指定される単位が絶対額のときは小数点以下が切り捨てられ整数として扱われます。
                          パーセント指定の時は小数を許容し、割合計算後に小数点以下が切り捨てられます。
                          いずれの場合も実際に付与されるポイントは整数のみです。
                      point_amount_unit:
                        type: string
                        enum: [percent, absolute]
                        title: '付与ポイント量の単位'
                        description: |-
                          キャンペーンにより付与するポイント量の単位を指定します。(必須項目)

                          以下のいずれかを指定できます。

                          1. percent
                          付与するポイント量が元取引の取引額に応じて割合で変化するときに指定します。

                          2. absolute
                          付与するポイント量が元取引の取引額に依存しない絶対額であるときに指定します。
                      subject_more_than:
                        type: integer
                        minimum: 0
                        title: '対象金額の下限値 (x <)'
                        description: |-
                          対象金額の下限値 (x <) を指定します (ただし、指定された金額は含まない)。
                          subject_more_than_or_equal といずれかのみ指定できます。
                      subject_more_than_or_equal:
                        type: integer
                        minimum: 0
                        title: '対象金額の下限値 (x <=)'
                        description: |-
                          対象金額の下限値 (x <=) を指定します。
                          subject_more_than といずれかのみ指定できます。
                      subject_less_than:
                        type: integer
                        minimum: 0
                        title: '対象金額の上限値 (< x)'
                        description: |-
                          対象金額の上限値 (< x) を指定します (ただし、指定された金額は含まない)。
                          subject_less_than_or_equal といずれかのみ指定できます。
                      subject_less_than_or_equal:
                        type: integer
                        minimum: 0
                        title: '対象金額の上限値 (<= x)'
                        description: |-
                          対象金額の上限値 (<= x) を指定します。
                          subject_less_than といずれかのみ指定できます。
                    example: |-
                      {
                        "point_amount": 5,
                        "point_amount_unit": "percent",
                        "subject_more_than_or_equal": 1000,
                        "subject_less_than": 5000
                      }

                  title: '取引金額ベースのポイント付与ルール'
                  description:  |-
                    金額をベースとしてポイント付与を行うルールを指定します。
                    amount_based_point_rules と product_based_point_rules はどちらか一方しか指定できません。
                    各ルールは一つのみ適用され、条件に重複があった場合は先に記載されたものが優先されます。

                    例:
                    ```javascript
                    [
                      // 1000円以上、5000円未満の決済には 5％
                      {
                        "point_amount": 5,
                        "point_amount_unit": "percent",
                        "subject_more_than_or_equal": 1000,
                        "subject_less_than": 5000
                      },
                      // 5000円以上の決済には 10%
                      {
                        "point_amount": 10,
                        "point_amount_unit": "percent",
                        "subject_more_than_or_equal": 5000
                      },
                    ]
                    ```

                product_based_point_rules:
                  type: array
                  items:
                    type: object
                    properties:
                      point_amount:
                        type: number
                        format: decimal
                        minimum: 0
                        title: '付与ポイント量'
                        description: |-
                          キャンペーンにより付与するポイント量。単位は point_amount_unit で指定します。(必須項目)

                          point_amount_unitにより指定される単位が絶対額のときは小数点以下が切り捨てられ整数として扱われます。
                          パーセント指定の時は小数を許容し、割合計算後に小数点以下が切り捨てられます。
                          いずれの場合も実際に付与されるポイントは整数のみです。
                      point_amount_unit:
                        type: string
                        enum: [percent, absolute]
                        title: '付与ポイント量の単位'
                        description: |-
                          キャンペーンにより付与するポイント量の単位を指定します。(必須項目)

                          以下のいずれかを指定できます。

                          1. percent
                          付与するポイント量が元取引の取引額に応じて割合で変化するときに指定します。

                          2. absolute
                          付与するポイント量が元取引の取引額に依存しない絶対額であるときに指定します。
                      product_code:
                        type: string
                        maxLength: 64
                        title: '対象の製品コード'
                        description: |-
                          対象の製品コード (JANコードやISBNコードなど) を指定します。(必須項目)

                          SQLのLIKE文のようにワイルドカードを使った製品コードのパターンを指定することもできます (_ で任意の1文字にマッチし、 % で任意文字列にマッチします。 例: 978-% でISBNコード)
                        items:
                          type: string
                      classification_code:
                        type: string
                        maxLength: 64
                        title: '対象の商品分類コード'
                        description: |-
                          対象の商品分類コード (書籍のCコードなど) を指定します。(任意項目)

                          SQLのLIKE文のようにワイルドカードを使った製品コードのパターンを指定することもできます (_ で任意の1文字にマッチし、 % で任意文字列にマッチします。 例: 978-% でISBNコード)
                        items:
                          type: string
                      required_count:
                        type: integer
                        minimum: 1
                        title: '必要購入個数'
                        description: |-
                          キャンペーン適用のための対象商品の必要購入個数を指定します (例:商品Aを2個以上購入するとn%ポイント)。
                          デフォルト値は1です。
                      is_multiply_by_count:
                        type: boolean
                        title: '複数個購入したときにポイント付与額に個数を掛けるかどうか'
                        description: |-
                          キャンペーン対象の商品を複数個購入したときに、個数に応じてポイント付与額を増やすかどうかのフラグです。
                          デフォルト値は false です。
                      is_floor_after_multiply:
                        type: boolean
                        title: '小数点以下切り捨てを個数を掛けた後に行うかどうか'
                        description: |-
                          is_multiply_by_countが指定されたとき、デフォルトでは商品ごとに付与ポイントが計算された後、少数点以下切り捨てが行なわれ、その後商品個数が掛けられます。
                          このフラグを有効にすると、商品ごとに付与ポイントが計算された後、商品個数が掛けられ、その後に少数点以下切り捨てが行なわれるようになります。
                          デフォルト値は false です。
                      starts_at:
                        type: string
                        format: date-time
                        title: '商品個別のキャンペーン開始日時'
                        description: |-
                          このルールを適用する開始日時を指定します。
                          デフォルトではキャンペーン全体の開始日時が指定されます。
                          商品個別にキャンペーン期間指定をする場合は、キャンペーン全体の期間指定の範囲内に入っている必要があります。
                      ends_at:
                        type: string
                        format: date-time
                        title: '商品個別のキャンペーン終了日時'
                        description: |-
                          このルールを適用する終了日時を指定します。
                          デフォルトではキャンペーン全体の終了日時が指定されます。
                          商品個別にキャンペーン期間指定をする場合は、キャンペーン全体の期間指定の範囲内に入っている必要があります。
                      group_id:
                        type: integer
                        minimum: 1
                        title: '商品グループID'
                        description: |-
                          複数の商品グループからの組み合わせ購入によって発火するキャンペーンで使用する商品グループIDです。
                          キャンペーンのパラメータ exist_in_each_product_groups を真に設定し、product_based_point_rules中の全てのルールでgroup_idを指定する必要があります。
                          デフォルトでは未指定です。
                    example: |-
                      {
                        "point_amount": 5,
                        "point_amount_unit": "percent",
                        "product_code": "4912345678904",
                        "is_multiply_by_count": true,
                        "required_count": 2
                      }

                  title: '商品情報ベースのポイント付与ルール'
                  description:  |-
                    商品情報をベースとしてポイント付与を行うルールを指定します。
                    ルールは商品ごとに設定可能で、ルールの配列として指定します。
                    amount_based_point_rules と product_based_point_rules はどちらか一方しか指定できません。
                    event が payment か external-transaction の時のみ有効です。
                    各ルールの順序は問わず、適用可能なものは全て適用されます。
                    一つの決済の中で複数の商品がキャンペーン適用可能な場合はそれぞれの商品についてのルールが適用され、ポイント付与額はその合算になります。

                    例:
                    ```javascript
                    [
                      // 対象商品の購入額から5%ポイント付与。複数購入時は単価の5%が付与される。
                      {
                        "point_amount": 5,
                        "point_amount_unit": "percent",
                        "product_code": "4912345678904",
                      },
                      // 対象商品の購入額から5%ポイント付与。複数購入時は購入総額の5%が付与される。
                      {
                        "point_amount": 5,
                        "point_amount_unit": "percent",
                        "product_code": "4912345678904",
                        "is_multiply_by_count": true,
                      },
                      // 対象商品を2つ以上購入したら500ポイント付与(固定額付与)
                      {
                        "point_amount": 500,
                        "point_amount_unit": "absolute",
                        "product_code": "4912345678904",
                        "required_count": 2
                      },
                      // 書籍は10%ポイント付与
                      // ※ISBNの形式はレジがポケペイに送信する形式に準じます
                      {
                        "point_amount": 10,
                        "point_amount_unit": "percent",
                        "product_code": "978-%",
                      },
                      // 一部の出版社の書籍は10%ポイント付与
                      {
                        "point_amount": 10,
                        "point_amount_unit": "percent",
                        "product_code": "978-4-01-%", // 旺文社
                      }
                    ]
                    ```

                blacklisted_product_rules:
                  type: array
                  items:
                    type: object
                    properties:
                      product_code:
                        type: string
                        maxLength: 64
                        title: '対象の製品コード'
                        description: |-
                          対象の製品コード (JANコードやISBNコードなど) を指定します。(必須項目)

                          SQLのLIKE文のようにワイルドカードを使った製品コードのパターンを指定することもできます (_ で任意の1文字にマッチし、 % で任意文字列にマッチします。 例: 978-% でISBNコード)
                        items:
                          type: string
                      classification_code:
                        type: string
                        maxLength: 64
                        title: '対象の商品分類コード'
                        description: |-
                          対象の商品分類コード (書籍のCコードなど) を指定します。(任意項目)

                          SQLのLIKE文のようにワイルドカードを使った製品コードのパターンを指定することもできます (_ で任意の1文字にマッチし、 % で任意文字列にマッチします。 例: 978-% でISBNコード)
                        items:
                          type: string
                    example: |-
                      {
                        "product_code": "4912345678904",
                        "classification_code": "c123"
                      }

                  title: '商品情報ベースのキャンペーンで除外対象にする商品リスト'
                  description:  |-
                    商品情報をベースとしてポイント付与を行う際に、事前に除外対象とする商品リストを指定します。
                    除外対象の商品コード、または分類コードのパターンの配列として指定します。
                    取引時には、まずここで指定した除外対象商品が除かれ、残った商品に対して `product_based_point_rules` のルール群が適用されます。

                applicable_days_of_week:
                  type: array
                  items:
                    type: integer
                    minimum: 0
                    maximum: 6
                  title: 'キャンペーンを適用する曜日 (複数指定)'
                  description: |-
                    キャンペーンを適用する曜日を指定します (複数指定)。
                    曜日は整数で表します。月曜を 0 とし、日曜を 6 とします。
                    指定しなかった場合は全日を対象にします (曜日による適用条件なし)
                applicable_time_ranges:
                  type: array
                  items:
                    type: object
                    properties:
                      from:
                        type: string
                        description: |-
                          時間帯の開始時刻 (HH:mmの形式)
                      to:
                        type: string
                        description: |-
                          時間帯の終了時刻 (HH:mmの形式)
                    example: |-
                      {
                        "from": "12:00",
                        "to": "23:59"
                      }

                  title: 'キャンペーンを適用する時間帯 (複数指定)'
                  description: |-
                    キャンペーンを適用する時間帯を指定します (複数指定可)。
                    時間帯はfromとtoからなるオブジェクトで指定します。
                    fromとtoは両方必要です。
                applicable_shop_ids:
                  type: array
                  items:
                    type: string
                    format: uuid
                  title: 'キャンペーン適用対象となる店舗IDのリスト'
                  description: |-
                    キャンペーンを適用する店舗IDを指定します (複数指定)。
                    指定しなかった場合は全店舗が対象になります。
                blacklisted_shop_ids:
                  type: array
                  items:
                    type: string
                    format: uuid
                  title: 'キャンペーン適用対象外となる店舗IDのリスト(ブラックリスト方式)'
                  description: |-
                    キャンペーンの適用対象外となる店舗IDをブラックリスト方式で指定します (複数指定可)。
                    このパラメータが指定されている場合、blacklisted_shop_idsに含まれていない店舗全てがキャンペーンの適用対象になります。
                    blacklisted_shop_idsとapplicable_shop_idsは同時には指定できません。ホワイトリスト方式を使うときはapplicable_shop_idsを指定してください。
                minimum_number_of_products:
                  type: integer
                  minimum: 1
                  title: 'キャンペーンを適用する1会計内の商品個数の下限'
                  description: |-
                    このパラメータを指定すると、取引時の1会計内のルールに適合する商品個数がminimum_number_of_productsを超えたときにのみキャンペーンが発火するようになります。
                minimum_number_of_amount:
                  type: integer
                  minimum: 1
                  title: 'キャンペーンを適用する1会計内の商品総額の下限'
                  description: |-
                    このパラメータを指定すると、取引時の1会計内のルールに適合する商品総額がminimum_number_of_amountを超えたときにのみキャンペーンが発火するようになります。
                minimum_number_for_combination_purchase:
                  type: integer
                  minimum: 1
                  title: '複数種類の商品を同時購入するときの商品種別数の下限'
                  description: |-
                    複数種別の商品を同時購入したとき、同時購入キャンペーンの対象となる商品種別数の下限です。デフォルトでは未指定で、指定する場合は1以上の整数を指定します。

                    このパラメータを指定するときは product_based_point_rules で商品毎のルールが指定されている必要があります。
                    例えば、A商品とB商品とC商品のうち、キャンペーンの発火のために2商品以上が同時購入される必要があるときは 2 を指定します。

                    例1: 商品A, Bが同時購入されたときに固定ポイント額(200ポイント)付与
                    ```javascript
                    {
                      minimum_number_for_combination_purchase: 2,
                      product_based_point_rules: [
                        {
                          "point_amount": 100,
                          "point_amount_unit": "absolute",
                          "product_code": "商品Aの商品コード"
                        },
                        {
                          "point_amount": 100,
                          "point_amount_unit": "absolute",
                          "product_code": "商品Bの商品コード"
                        }
                      ]
                    }
                    ```

                    例2: 商品A, Bが3個ずつ以上同時購入されたときに固定ポイント額(200ポイント)付与
                    ```javascript
                    {
                      minimum_number_for_combination_purchase: 2,
                      product_based_point_rules: [
                        {
                          "point_amount": 100,
                          "point_amount_unit": "absolute",
                          "product_code": "商品Aの商品コード",
                          "required_count": 3
                        },
                        {
                          "point_amount": 100,
                          "point_amount_unit": "absolute",
                          "product_code": "商品Bの商品コード",
                          "required_count": 3
                        }
                      ]
                    }
                    ```

                    例2: 商品A, B, Cのうち2商品以上が同時購入されたときに総額の10%ポイントが付与
                    ```javascript
                    {
                      minimum_number_for_combination_purchase: 2,
                      product_based_point_rules: [
                        {
                          "point_amount": 10,
                          "point_amount_unit": "percent",
                          "product_code": "商品Aの商品コード",
                          "is_multiply_by_count": true,
                        },
                        {
                          "point_amount": 10,
                          "point_amount_unit": "percent",
                          "product_code": "商品Bの商品コード",
                          "is_multiply_by_count": true,
                        },
                        {
                          "point_amount": 10,
                          "point_amount_unit": "percent",
                          "product_code": "商品Cの商品コード",
                          "is_multiply_by_count": true,
                        }
                      ]
                    }
                    ```
                exist_in_each_product_groups:
                  type: boolean
                  title: '複数の商品グループにつき1種類以上の商品購入によって発火するキャンペーンの指定フラグ'
                  description: |-
                    複数の商品グループの各グループにつき1種類以上の商品が購入されることによって発火するキャンペーンであるときに真を指定します。デフォルトは偽です。

                    このパラメータを指定するときは product_based_point_rules で商品毎のルールが指定され、さらにその中でgroup_idが指定されている必要があります。group_idは正の整数です。
                    exist_in_each_product_groupsが指定されているにも関わらず商品毎のルールでgroup_idが指定されていないものが含まれている場合はinvalid_parametersエラー(missing group_id, エラーコード400)が返ります。

                    例えば、商品グループA(商品コードa1, a2)、商品グループB(商品コードb1, b2)の2つの商品グループがあるとします。
                    このとき、各商品グループからそれぞれ少なくとも1種類以上の商品が購入されることにより発火するキャンペーンに対するリクエストパラメータは以下のようなものになります。

                    ```javascript
                    {
                      exist_in_each_product_groups: true,
                      product_based_point_rules: [
                        {
                          "point_amount": 100,
                          "point_amount_unit": "absolute",
                          "product_code": "a1",
                          "group_id": 1
                        },
                        {
                          "point_amount": 100,
                          "point_amount_unit": "absolute",
                          "product_code": "a2",
                          "group_id": 1
                        },
                        {
                          "point_amount": 200,
                          "point_amount_unit": "absolute",
                          "product_code": "b1",
                          "group_id": 2
                        },
                        {
                          "point_amount": 200,
                          "point_amount_unit": "absolute",
                          "product_code": "b2",
                          "group_id": 2
                        }
                      ]
                    }
                    ```

                    このキャンペーンが設定された状態で、商品a1、b1が同時に購入された場合、各商品に対する個別のルールが適用された上での総和がポイント付与値になります。つまり100 + 200=300がポイント付与値になります。商品a1、a2、 b1、b2が同時に購入された場合は100 + 100 + 200 + 200=600がポイント付与値になります。 商品a1、a2が同時に購入された場合は全商品グループから1種以上購入されるという条件を満たしていないためポイントは付与されません。

                    ポイント付与値を各商品毎のルールの総和ではなく固定値にしたい場合には、max_point_amountを指定します。
                    例えば以下のようなリクエストパラメータ指定の場合を考えます。

                    ```javascript
                    {
                      max_point_amount: 100,
                      exist_in_each_product_groups: true,
                      product_based_point_rules: [
                        {
                          "point_amount": 100,
                          "point_amount_unit": "absolute",
                          "product_code": "a1",
                          "group_id": 1
                        },
                        {
                          "point_amount": 100,
                          "point_amount_unit": "absolute",
                          "product_code": "a2",
                          "group_id": 1
                        },
                        {
                          "point_amount": 100,
                          "point_amount_unit": "absolute",
                          "product_code": "b1",
                          "group_id": 2
                        },
                        {
                          "point_amount": 100,
                          "point_amount_unit": "absolute",
                          "product_code": "b2",
                          "group_id": 2
                        }
                      ]
                    }
                    ```

                    このキャンペーンが設定された状態で、商品a1、b1が同時に購入された場合、各商品に対する個別のルールが適用された上での総和がポイント付与値になりますが、付与値の上限が100ポイントになります。つまり100 + 200=300と計算されますが上限額の100ポイントが実際の付与値になります。商品a1、a2、 b1、b2が同時に購入された場合は100 + 100 + 200 + 200=600ですが上限額の100がポイント付与値になります。 商品a1、a2が同時に購入された場合は全商品グループから1種以上購入されるという条件を満たしていないためポイントは付与されません。
                max_point_amount:
                  type: integer
                  minimum: 1
                  title: 'キャンペーンによって付与されるポイントの上限'
                  description: |-
                    キャンペーンによって付与されるポイントの上限を指定します。デフォルトは未指定です。

                    このパラメータが指定されている場合、amount_based_point_rules や product_based_point_rules によって計算されるポイント付与値がmax_point_amountを越えている場合、max_point_amountの値がポイント付与値となり、越えていない場合はその値がポイント付与値となります。
                max_total_point_amount:
                  type: integer
                  minimum: 1
                  title: 'キャンペーンによって付与されるの1人当たりの累計ポイントの上限'
                  description: |-
                    キャンペーンによって付与される1人当たりの累計ポイント数の上限を指定します。デフォルトは未指定です。

                    このパラメータが指定されている場合、各ユーザに対してそのキャンペーンによって過去付与されたポイントの累積値が記録されるようになります。
                    累積ポイント数がmax_total_point_amountを超えない限りにおいてキャンペーンで算出されたポイントが付与されます。
                dest_private_money_id:
                  type: string
                  format: uuid
                  title: 'ポイント付与先となるマネーID'
                  description: |-
                    キャンペーンを駆動するイベントのマネーとは「別のマネー」に対してポイントを付けたいときに、そのマネーIDを指定します。

                    ポイント付与先のマネーはキャンペーンを駆動するイベントのマネーと同一発行体が発行しているものに限ります。その他のマネーIDが指定された場合は private_money_not_found (422) が返ります。
                    エンドユーザー、店舗、ポイント負担先店舗はポイント付与先マネーのウォレットを持っている必要があります。持っていない場合はポイントは付きません。
                    元のイベントのマネーと異なる複数のマネーに対して同時にポイントを付与することはできません。重複可能に設定されている複数のキャンペーンで別々のポイント付与先マネーを指定した場合は最も優先度の高いものが処理され、残りは無視されます。
                    キャンペーンのポイント付与先マネーは後から更新することはできません。
                    デフォルトではポイント付与先はキャンペーンを駆動するイベントのマネー(private_money_idで指定したマネー)になります。

                    別マネーに対するポイント付与は別のtransactionとなります。 RefundTransaction で元のイベントをキャンセルしたときはポイント付与のtransactionもキャンセルされ、逆にポイント付与のtransactionをキャンセルしたときは連動して元のイベントがキャンセルされます。

                applicable_account_metadata:
                  description: |-
                    ウォレットに紐付くメタデータが特定の値を持つときにのみ発火するキャンペーンを登録します。
                    メタデータの属性名 key とメタデータの値 value の組をオブジェクトとして指定します。
                    ウォレットのメタデータはCreateUserAccountやUpdateCustomerAccountで登録できます。

                    オプショナルパラメータtestによって比較方法を指定することができます。
                    デフォルトは equal で、その他に not-equalを指定可能です。

                    例1: 取引が行なわれたウォレットのメタデータに住所として東京が指定されているときのみ発火

                    ```javascript
                    {
                      "key": "prefecture",
                      "value": "tokyo"
                    }
                    ```

                    例2: 取引が行なわれたウォレットのメタデータに住所として東京以外が指定されているときのみ発火

                    ```javascript
                    {
                      "key": "prefecture",
                      "value": "tokyo",
                      "test": "not-equal"
                    }
                    ```

                  type: object
                  properties:
                    key:
                      type: string
                      description: |-
                        メタデータの属性名
                    value:
                      type: string
                      description: |-
                        メタデータの値
                    test:
                      type: string
                      enum: [equal, not-equal]
                      description: |-
                        メタデータの値の比較方法。デフォルトはequal
                  example: |-
                    {
                      "key": "sex",
                      "value": "male"
                    }

                applicable_transaction_metadata:
                  description: |-
                    取引時に指定するメタデータが特定の値を持つときにのみ発火するキャンペーンを登録します。
                    メタデータの属性名 key とメタデータの値 value の組をオブジェクトとして指定します。
                    取引のメタデータはCreatePaymentTransactionやCreateExternalTransactionで登録できます。

                    オプショナルパラメータtestによって比較方法を指定することができます。
                    デフォルトは equal で、その他に not-equalを指定可能です。

                    例1: 取引のメタデータに会員ランクとしてbronzeが指定されているときのみ発火

                    ```javascript
                    {
                      "key": "rank",
                      "value": "bronze"
                    }
                    ```

                    例2: 取引のメタデータに会員ランクとしてbronze以外が指定されているときのみ発火

                    ```javascript
                    {
                      "key": "rank",
                      "value": "bronze",
                      "test": "not-equal"
                    }
                    ```

                  type: object
                  properties:
                    key:
                      type: string
                      description: |-
                        メタデータの属性名
                    value:
                      type: string
                      description: |-
                        メタデータの値
                    test:
                      type: string
                      enum: [equal, not-equal]
                      description: |-
                        メタデータの値の比較方法。デフォルトはequal
                  example: |-
                    {
                      "key": "rank",
                      "value": "bronze"
                    }

                budget_caps_amount:
                  title: 'キャンペーン予算上限'
                  type: integer
                  minimum: 1
                  maximum: 10000000000
                  description: |-
                    キャンペーンの予算上限を指定します。デフォルトは未指定です。

                    このパラメータが指定されている場合、このキャンペーンの適用により付与されたポイント全体を定期的に集計し、その合計が上限を越えていた場合にはキャンペーンを無効にします。
                    一度この値を越えて無効となったキャンペーンを再度有効にすることは出来ません。

      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Campaign'
        '400':
          $ref: '#/components/responses/BadRequest'
        '403':
          $ref: '#/components/responses/Forbidden'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'
    get:
      tags:
        - Campaign
      summary: 'キャンペーン一覧を取得する'
      description: |-
        マネーIDを指定してキャンペーンを取得します。
        発行体の組織マネージャ権限で、自組織が発行するマネーのキャンペーンについてのみ閲覧可能です。
        閲覧権限がない場合は unpermitted_admin_user エラー(422)が返ります。
      x-pokepay-operator-name: "ListCampaigns"
      x-pokepay-allow-server-side: true
      requestBody:
        required: true
        content:
          application/json:
            schema:
              required: ["private_money_id"]
              properties:
                private_money_id:
                  type: string
                  format: uuid
                  title: 'マネーID'
                  description: |-
                    マネーIDです。

                    フィルターとして使われ、指定したマネーでのキャンペーンのみ一覧に表示されます。
                is_ongoing:
                  type: boolean
                  title: '現在適用可能なキャンペーンかどうか'
                  description: |-
                    有効化されており、現在キャンペーン期間内にあるキャンペーンをフィルターするために使われます。
                    真であれば適用可能なもののみを抽出し、偽であれば適用不可なもののみを抽出します。
                    デフォルトでは未指定(フィルターなし)です。
                available_from:
                  type: string
                  format: date-time
                  title: '指定された日時以降に適用可能期間が含まれているか'
                  description: |-
                    キャンペーン終了日時が指定された日時以降であるキャンペーンをフィルターするために使われます。
                    デフォルトでは未指定(フィルターなし)です。
                available_to:
                  type: string
                  format: date-time
                  title: '指定された日時以前に適用可能期間が含まれているか'
                  description: |-
                    キャンペーン開始日時が指定された日時以前であるキャンペーンをフィルターするために使われます。
                    デフォルトでは未指定(フィルターなし)です。
                page:
                  type: integer
                  default: 1
                  minimum: 1
                  title: 'ページ番号'
                  description: 取得したいページ番号です。
                  example: 1
                per_page:
                  type: integer
                  default: 20
                  minimum: 1
                  maximum: 50
                  title: '1ページ分の取得数'
                  description: 1ページ分の取得数です。デフォルトでは 20 になっています。
                  example: 20
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedCampaigns'
        '400':
          $ref: '#/components/responses/InvalidParameters'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'
  /campaigns/{campaign_id}:
    get:
      tags:
        - Campaign
      summary: 'キャンペーンを取得する'
      description: |-
        IDを指定してキャンペーンを取得します。
        発行体の組織マネージャ権限で、自組織が発行するマネーのキャンペーンについてのみ閲覧可能です。
        閲覧権限がない場合は unpermitted_admin_user エラー(422)が返ります。
      x-pokepay-operator-name: "GetCampaign"
      x-pokepay-allow-server-side: true
      parameters:
        - in: path
          name: campaign_id
          required: true
          schema:
            type: string
            format: uuid
            title: 'キャンペーンID'
          description: |-
            キャンペーンIDです。

            指定したIDのキャンペーンを取得します。存在しないIDを指定した場合は404エラー(NotFound)が返ります。
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Campaign'
        '400':
          $ref: '#/components/responses/InvalidParameters'
        '422':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
    patch:
      tags:
        - Campaign
      summary: 'ポイント付与キャンペーンを更新する'
      description: |
        ポイント付与キャンペーンを更新します。
      x-pokepay-operator-name: "UpdateCampaign"
      x-pokepay-allow-server-side: true
      parameters:
        - in: path
          name: campaign_id
          required: true
          schema:
            type: string
            format: uuid
            title: 'キャンペーンID'
          description: |-
            キャンペーンIDです。

            指定したIDのキャンペーンを更新します。存在しないIDを指定した場合は404エラー(NotFound)が返ります。
      requestBody:
        required: true
        content:
          application/json:
            schema:
              x-pokepay-conditional-parameters:
                xor: [applicable_shop_ids, blacklisted_shop_ids]
              properties:
                name:
                  title: 'キャンペーン名'
                  type: string
                  maxLength: 256
                  description: |-
                    キャンペーン名です。

                    ポイント付与によってできるチャージ取引の説明文に転記されます。取引説明文はエンドユーザーからも確認できます。
                starts_at:
                  type: string
                  format: date-time
                  title: 'キャンペーン開始日時'
                  description: |-
                    キャンペーン開始日時です。
                    キャンペーン期間中のみポイントが付与されます。
                    開始日時よりも終了日時が前のときはcampaign_invalid_periodエラー(422)になります。
                ends_at:
                  type: string
                  format: date-time
                  title: 'キャンペーン終了日時'
                  description: |-
                    キャンペーン終了日時です。
                    キャンペーン期間中のみポイントが付与されます。
                    開始日時よりも終了日時が前のときはcampaign_invalid_periodエラー(422)になります。
                priority:
                  type: integer
                  title: 'キャンペーンの適用優先度'
                  description: |-
                    キャンペーンの適用優先度です。

                    優先度が大きいものから順に適用判定されていきます。
                    キャンペーン期間が重なっている同一の優先度のキャンペーンが存在するとcampaign_period_overlapsエラー(422)になります。
                event:
                  type: string
                  enum: [topup, payment, external-transaction]
                  title: 'イベント種別'
                  description: |-
                    キャンペーンのトリガーとなるイベントの種類を指定します。

                    以下のいずれかを指定できます。

                    1. topup
                       店舗からエンドユーザーへの送金取引(チャージ)
                    2. payment
                       エンドユーザーから店舗への送金取引(支払い)
                    3. external-transaction
                       ポケペイ外の取引(現金決済など)
                description:
                  type: string
                  maxLength: 200
                  title: 'キャンペーンの説明文'
                  description:  |-
                    キャンペーンの内容を記載します。管理画面などでキャンペーンを管理するための説明文になります。
                status:
                  type: string
                  enum: [enabled, disabled]
                  title: 'キャンペーン作成時の状態'
                  description: |-
                    キャンペーン作成時の状態を指定します。デフォルトではenabledです。

                    以下のいずれかを指定できます。

                    1. enabled
                       有効
                    2. disabled
                       無効
                point_expires_at:
                  type: string
                  format: date-time
                  nullable: true
                  title: 'ポイント有効期限(絶対日時指定)'
                  description: |-
                    キャンペーンによって付与されるポイントの有効期限を絶対日時で指定します。
                    省略した場合はマネーに設定された有効期限と同じものがポイントの有効期限となります。
                point_expires_in_days:
                  type: integer
                  minimum: 1
                  nullable: true
                  title: 'ポイント有効期限(相対日数指定)'
                  description: |-
                    キャンペーンによって付与されるポイントの有効期限を相対日数で指定します。
                    省略した場合はマネーに設定された有効期限と同じものがポイントの有効期限となります。
                is_exclusive:
                  type: boolean
                  title: 'キャンペーンの重複設定'
                  description: |-
                    キャンペーンの重ね掛けを行うかどうかのフラグです。

                    これにtrueを指定すると他のキャンペーンと同時適用されません。デフォルト値はtrueです。
                    falseを指定すると次の優先度の重ね掛け可能なキャンペーンの適用判定に進みます。
                subject:
                  type: string
                  enum: [money, all]
                  title: 'ポイント付与の対象金額の種別'
                  description: |-
                    ポイント付与額を計算する対象となる金額の種類を指定します。デフォルト値はallです。
                    eventとしてexternal-transactionを指定した場合はポイントとマネーの区別がないためsubjectの指定に関わらず常にallとなります。

                    以下のいずれかを指定できます。

                    1. money
                    moneyを指定すると決済額の中で「マネー」を使って支払った額を対象にします

                    2. all
                    all を指定すると決済額全体を対象にします (「ポイント」での取引額を含む)
                    注意: event を topup にしたときはポイントの付与に対しても適用されます
                amount_based_point_rules:
                  type: array
                  items:
                    type: object
                    properties:
                      point_amount:
                        type: number
                        format: decimal
                        minimum: 0
                        title: '付与ポイント量'
                        description: |-
                          キャンペーンにより付与するポイント量。(必須項目)

                          point_amount_unitにより指定される単位が絶対額のときは小数点以下が切り捨てられ整数として扱われます。
                          パーセント指定の時は小数を許容し、割合計算後に小数点以下が切り捨てられます。
                          いずれの場合も実際に付与されるポイントは整数のみです。
                      point_amount_unit:
                        type: string
                        enum: [percent, absolute]
                        title: '付与ポイント量の単位'
                        description: |-
                          キャンペーンにより付与するポイント量の単位を指定します。(必須項目)

                          以下のいずれかを指定できます。

                          1. percent
                          付与するポイント量が元取引の取引額に応じて割合で変化するときに指定します。

                          2. absolute
                          付与するポイント量が元取引の取引額に依存しない絶対額であるときに指定します。
                      subject_more_than:
                        type: integer
                        minimum: 0
                        title: '対象金額の下限値 (x <)'
                        description: |-
                          対象金額の下限値 (x <) を指定します (ただし、指定された金額は含まない)。
                          subject_more_than_or_equal といずれかのみ指定できます。
                      subject_more_than_or_equal:
                        type: integer
                        minimum: 0
                        title: '対象金額の下限値 (x <=)'
                        description: |-
                          対象金額の下限値 (x <=) を指定します。
                          subject_more_than といずれかのみ指定できます。
                      subject_less_than:
                        type: integer
                        minimum: 0
                        title: '対象金額の上限値 (< x)'
                        description: |-
                          対象金額の上限値 (< x) を指定します (ただし、指定された金額は含まない)。
                          subject_less_than_or_equal といずれかのみ指定できます。
                      subject_less_than_or_equal:
                        type: integer
                        minimum: 0
                        title: '対象金額の上限値 (<= x)'
                        description: |-
                          対象金額の上限値 (<= x) を指定します。
                          subject_less_than といずれかのみ指定できます。
                    example: |-
                      {
                        "point_amount": 5,
                        "point_amount_unit": "percent",
                        "subject_more_than_or_equal": 1000,
                        "subject_less_than": 5000
                      }

                  title: '取引金額ベースのポイント付与ルール'
                  nullable: true
                  description:  |-
                    金額をベースとしてポイント付与を行うルールを指定します。
                    amount_based_point_rules と product_based_point_rules はどちらか一方しか指定できません。
                    各ルールは一つのみ適用され、条件に重複があった場合は先に記載されたものが優先されます。

                    例:
                    ```javascript
                    [
                      // 1000円以上、5000円未満の決済には 5％
                      {
                        "point_amount": 5,
                        "point_amount_unit": "percent",
                        "subject_more_than_or_equal": 1000,
                        "subject_less_than": 5000
                      },
                      // 5000円以上の決済には 10%
                      {
                        "point_amount": 10,
                        "point_amount_unit": "percent",
                        "subject_more_than_or_equal": 5000
                      },
                    ]
                    ```

                product_based_point_rules:
                  type: array
                  items:
                    type: object
                    properties:
                      point_amount:
                        type: number
                        format: decimal
                        minimum: 0
                        title: '付与ポイント量'
                        description: |-
                          キャンペーンにより付与するポイント量。単位は point_amount_unit で指定します。(必須項目)

                          point_amount_unitにより指定される単位が絶対額のときは小数点以下が切り捨てられ整数として扱われます。
                          パーセント指定の時は小数を許容し、割合計算後に小数点以下が切り捨てられます。
                          いずれの場合も実際に付与されるポイントは整数のみです。
                      point_amount_unit:
                        type: string
                        enum: [percent, absolute]
                        title: '付与ポイント量の単位'
                        description: |-
                          キャンペーンにより付与するポイント量の単位を指定します。(必須項目)

                          以下のいずれかを指定できます。

                          1. percent
                          付与するポイント量が元取引の取引額に応じて割合で変化するときに指定します。

                          2. absolute
                          付与するポイント量が元取引の取引額に依存しない絶対額であるときに指定します。
                      product_code:
                        type: string
                        maxLength: 64
                        title: '対象の製品コード'
                        description: |-
                          対象の製品コード (JANコードやISBNコードなど) を指定します。(必須項目)

                          SQLのLIKE文のようにワイルドカードを使った製品コードのパターンを指定することもできます (例: 978-% でISBNコード)
                        items:
                          type: string
                      classification_code:
                        type: string
                        maxLength: 64
                        title: '対象の商品分類コード'
                        description: |-
                          対象の商品分類コード (書籍のCコードなど) を指定します。(任意項目)

                          SQLのLIKE文のようにワイルドカードを使った製品コードのパターンを指定することもできます (_ で任意の1文字にマッチし、 % で任意文字列にマッチします。 例: 978-% でISBNコード)
                        items:
                          type: string
                      required_count:
                        type: integer
                        minimum: 1
                        title: '必要購入個数'
                        description: |-
                          キャンペーン適用のための対象商品の必要購入個数を指定します (例:商品Aを2個以上購入するとn%ポイント)。
                          デフォルト値は1です。
                      is_multiply_by_count:
                        type: boolean
                        title: '複数個購入したときにポイント付与額に個数を掛けるかどうか'
                        description: |-
                          キャンペーン対象の商品を複数個購入したときに、個数に応じてポイント付与額を増やすかどうかのフラグです。
                          デフォルト値は false です。
                      is_floor_after_multiply:
                        type: boolean
                        title: '小数点以下切り捨てを個数を掛けた後に行うかどうか'
                        description: |-
                          is_multiply_by_countが指定されたとき、デフォルトでは商品ごとに付与ポイントが計算された後、少数点以下切り捨てが行なわれ、その後商品個数が掛けられます。
                          このフラグを有効にすると、商品ごとに付与ポイントが計算された後、商品個数が掛けられ、その後に少数点以下切り捨てが行なわれるようになります。
                          デフォルト値は false です。
                      starts_at:
                        type: string
                        format: date-time
                        title: '商品個別のキャンペーン開始日時'
                        description: |-
                          このルールを適用する開始日時を指定します。
                          デフォルトではキャンペーン全体の開始日時が指定されます。
                          商品個別にキャンペーン期間指定をする場合は、キャンペーン全体の期間指定の範囲内に入っている必要があります。
                      ends_at:
                        type: string
                        format: date-time
                        title: '商品個別のキャンペーン終了日時'
                        description: |-
                          このルールを適用する終了日時を指定します。
                          デフォルトではキャンペーン全体の終了日時が指定されます。
                          商品個別にキャンペーン期間指定をする場合は、キャンペーン全体の期間指定の範囲内に入っている必要があります。
                      group_id:
                        type: integer
                        minimum: 1
                        title: '商品グループID'
                        description: |-
                          複数の商品グループからの組み合わせ購入によって発火するキャンペーンで使用する商品グループIDです。
                          キャンペーンのパラメータ exist_in_each_product_groups を真に設定し、product_based_point_rules中の全てのルールでgroup_idを指定する必要があります。
                          デフォルトでは未指定です。
                    example: |-
                      {
                        "point_amount": 5,
                        "point_amount_unit": "percent",
                        "product_code": "4912345678904",
                        "is_multiply_by_count": true,
                        "required_count": 2
                      }

                  title: '商品情報ベースのポイント付与ルール'
                  nullable: true
                  description:  |-
                    商品情報をベースとしてポイント付与を行うルールを指定します。
                    ルールは商品ごとに設定可能で、ルールの配列として指定します。
                    amount_based_point_rules と product_based_point_rules はどちらか一方しか指定できません。
                    event が payment か external-transaction の時のみ有効です。
                    各ルールの順序は問わず、適用可能なものは全て適用されます。
                    一つの決済の中で複数の商品がキャンペーン適用可能な場合はそれぞれの商品についてのルールが適用され、ポイント付与額はその合算になります。

                    例:
                    ```javascript
                    [
                      // 対象商品の購入額から5%ポイント付与。複数購入時は単価の5%が付与される。
                      {
                        "point_amount": 5,
                        "point_amount_unit": "percent",
                        "product_code": "4912345678904",
                      },
                      // 対象商品の購入額から5%ポイント付与。複数購入時は購入総額の5%が付与される。
                      {
                        "point_amount": 5,
                        "point_amount_unit": "percent",
                        "product_code": "4912345678904",
                        "is_multiply_by_count": true,
                      },
                      // 対象商品を2つ以上購入したら500ポイント付与(固定額付与)
                      {
                        "point_amount": 500,
                        "point_amount_unit": "absolute",
                        "product_code": "4912345678904",
                        "required_count": 2
                      },
                      // 書籍は10%ポイント付与
                      // ※ISBNの形式はレジがポケペイに送信する形式に準じます
                      {
                        "point_amount": 10,
                        "point_amount_unit": "percent",
                        "product_code": "978-%",
                      },
                      // 一部の出版社の書籍は10%ポイント付与
                      {
                        "point_amount": 10,
                        "point_amount_unit": "percent",
                        "product_code": "978-4-01-%", // 旺文社
                      }
                    ]
                    ```

                blacklisted_product_rules:
                  type: array
                  items:
                    type: object
                    properties:
                      product_code:
                        type: string
                        maxLength: 64
                        title: '対象の製品コード'
                        description: |-
                          対象の製品コード (JANコードやISBNコードなど) を指定します。(必須項目)

                          SQLのLIKE文のようにワイルドカードを使った製品コードのパターンを指定することもできます (_ で任意の1文字にマッチし、 % で任意文字列にマッチします。 例: 978-% でISBNコード)
                        items:
                          type: string
                      classification_code:
                        type: string
                        maxLength: 64
                        title: '対象の商品分類コード'
                        description: |-
                          対象の商品分類コード (書籍のCコードなど) を指定します。(任意項目)

                          SQLのLIKE文のようにワイルドカードを使った製品コードのパターンを指定することもできます (_ で任意の1文字にマッチし、 % で任意文字列にマッチします。 例: 978-% でISBNコード)
                        items:
                          type: string
                    example: |-
                      {
                        "product_code": "4912345678904",
                        "classification_code": "c123"
                      }

                  title: '商品情報ベースのキャンペーンで除外対象にする商品リスト'
                  description:  |-
                    商品情報をベースとしてポイント付与を行う際に、事前に除外対象とする商品リストを指定します。
                    除外対象の商品コード、または分類コードのパターンの配列として指定します。
                    取引時には、まずここで指定した除外対象商品が除かれ、残った商品に対して `product_based_point_rules` のルール群が適用されます。

                applicable_days_of_week:
                  type: array
                  items:
                    type: integer
                    minimum: 0
                    maximum: 6
                  nullable: true
                  title: 'キャンペーンを適用する曜日 (複数指定)'
                  description: |-
                    キャンペーンを適用する曜日を指定します (複数指定)。
                    曜日は整数で表します。月曜を 0 とし、日曜を 6 とします。
                    指定しなかった場合は全日を対象にします (曜日による適用条件なし)
                applicable_time_ranges:
                  type: array
                  items:
                    type: object
                    properties:
                      from:
                        type: string
                        description: |-
                          時間帯の開始時刻 (HH:mmの形式)
                      to:
                        type: string
                        description: |-
                          時間帯の終了時刻 (HH:mmの形式)
                    example: |-
                      {
                        "from": "12:00",
                        "to": "23:59"
                      }

                  nullable: true
                  title: 'キャンペーンを適用する時間帯 (複数指定)'
                  description: |-
                    キャンペーンを適用する時間帯を指定します (複数指定可)。
                    時間帯はfromとtoからなるオブジェクトで指定します。
                    fromとtoは両方必要です。
                applicable_shop_ids:
                  type: array
                  items:
                    type: string
                    format: uuid
                  nullable: true
                  title: 'キャンペーン適用対象となる店舗IDのリスト'
                  description: |-
                    キャンペーンを適用する店舗IDを指定します (複数指定)。
                    指定しなかった場合は全店舗が対象になります。
                blacklisted_shop_ids:
                  type: array
                  items:
                    type: string
                    format: uuid
                  nullable: true
                  title: 'キャンペーン適用対象外となる店舗IDのリスト(ブラックリスト方式)'
                  description: |-
                    キャンペーンの適用対象外となる店舗IDをブラックリスト方式で指定します (複数指定可)。
                    このパラメータが指定されている場合、blacklisted_shop_idsに含まれていない店舗全てがキャンペーンの適用対象になります。
                    blacklisted_shop_idsとapplicable_shop_idsは同時には指定できません。ホワイトリスト方式を使うときはapplicable_shop_idsを指定してください。
                minimum_number_of_products:
                  type: integer
                  minimum: 1
                  nullable: true
                  title: 'キャンペーンを適用する1会計内の商品個数の下限'
                  description: |-
                    このパラメータを指定すると、取引時の1会計内のルールに適合する商品個数がminimum_number_of_productsを超えたときにのみキャンペーンが発火するようになります。
                minimum_number_of_amount:
                  type: integer
                  minimum: 1
                  nullable: true
                  title: 'キャンペーンを適用する1会計内の商品総額の下限'
                  description: |-
                    このパラメータを指定すると、取引時の1会計内のルールに適合する商品総額がminimum_number_of_amountを超えたときにのみキャンペーンが発火するようになります。
                minimum_number_for_combination_purchase:
                  type: integer
                  minimum: 1
                  nullable: true
                  title: '複数種類の商品を同時購入するときの商品種別数の下限'
                  description: |-
                    複数種別の商品を同時購入したとき、同時購入キャンペーンの対象となる商品種別数の下限です。

                    このパラメータを指定するときは product_based_point_rules で商品毎のルールが指定されている必要があります。
                    例えば、A商品とB商品とC商品のうち、キャンペーンの発火のために2商品以上が同時購入される必要があるときは 2 を指定します。

                    例1: 商品A, Bが同時購入されたときに固定ポイント額(200ポイント)付与
                    ```javascript
                    {
                      minimum_number_for_combination_purchase: 2,
                      product_based_point_rules: [
                        {
                          "point_amount": 100,
                          "point_amount_unit": "absolute",
                          "product_code": "商品Aの商品コード"
                        },
                        {
                          "point_amount": 100,
                          "point_amount_unit": "absolute",
                          "product_code": "商品Bの商品コード"
                        }
                      ]
                    }
                    ```

                    例2: 商品A, Bが3個ずつ以上同時購入されたときに固定ポイント額(200ポイント)付与
                    ```javascript
                    {
                      minimum_number_for_combination_purchase: 2,
                      product_based_point_rules: [
                        {
                          "point_amount": 100,
                          "point_amount_unit": "absolute",
                          "product_code": "商品Aの商品コード",
                          "required_count": 3
                        },
                        {
                          "point_amount": 100,
                          "point_amount_unit": "absolute",
                          "product_code": "商品Bの商品コード",
                          "required_count": 3
                        }
                      ]
                    }
                    ```

                    例2: 商品A, B, Cのうち2商品以上が同時購入されたときに総額の10%ポイントが付与
                    ```javascript
                    {
                      minimum_number_for_combination_purchase: 2,
                      product_based_point_rules: [
                        {
                          "point_amount": 10,
                          "point_amount_unit": "percent",
                          "product_code": "商品Aの商品コード",
                          "is_multiply_by_count": true,
                        },
                        {
                          "point_amount": 10,
                          "point_amount_unit": "percent",
                          "product_code": "商品Bの商品コード",
                          "is_multiply_by_count": true,
                        },
                        {
                          "point_amount": 10,
                          "point_amount_unit": "percent",
                          "product_code": "商品Cの商品コード",
                          "is_multiply_by_count": true,
                        }
                      ]
                    }
                    ```
                exist_in_each_product_groups:
                  type: boolean
                  title: '複数の商品グループにつき1種類以上の商品購入によって発火するキャンペーンの指定フラグ'
                  description: |-
                    複数の商品グループの各グループにつき1種類以上の商品が購入されることによって発火するキャンペーンであるときに真を指定します。デフォルトは偽です。

                    このパラメータを指定するときは product_based_point_rules で商品毎のルールが指定され、さらにその中でgroup_idが指定されている必要があります。group_idは正の整数です。
                    exist_in_each_product_groupsが指定されているにも関わらず商品毎のルールでgroup_idが指定されていないものが含まれている場合はinvalid_parametersエラー(missing group_id, エラーコード400)が返ります。

                    例えば、商品グループA(商品コードa1, a2)、商品グループB(商品コードb1, b2)の2つの商品グループがあるとします。
                    このとき、各商品グループからそれぞれ少なくとも1種類以上の商品が購入されることにより発火するキャンペーンに対するリクエストパラメータは以下のようなものになります。

                    ```javascript
                    {
                      exist_in_each_product_groups: true,
                      product_based_point_rules: [
                        {
                          "point_amount": 100,
                          "point_amount_unit": "absolute",
                          "product_code": "a1",
                          "group_id": 1
                        },
                        {
                          "point_amount": 100,
                          "point_amount_unit": "absolute",
                          "product_code": "a2",
                          "group_id": 1
                        },
                        {
                          "point_amount": 200,
                          "point_amount_unit": "absolute",
                          "product_code": "b1",
                          "group_id": 2
                        },
                        {
                          "point_amount": 200,
                          "point_amount_unit": "absolute",
                          "product_code": "b2",
                          "group_id": 2
                        }
                      ]
                    }
                    ```

                    このキャンペーンが設定された状態で、商品a1、b1が同時に購入された場合、各商品に対する個別のルールが適用された上での総和がポイント付与値になります。つまり100 + 200=300がポイント付与値になります。商品a1、a2、 b1、b2が同時に購入された場合は100 + 100 + 200 + 200=600がポイント付与値になります。 商品a1、a2が同時に購入された場合は全商品グループから1種以上購入されるという条件を満たしていないためポイントは付与されません。

                    ポイント付与値を各商品毎のルールの総和ではなく固定値にしたい場合には、max_point_amountを指定します。
                    例えば以下のようなリクエストパラメータ指定の場合を考えます。

                    ```javascript
                    {
                      max_point_amount: 100,
                      exist_in_each_product_groups: true,
                      product_based_point_rules: [
                        {
                          "point_amount": 100,
                          "point_amount_unit": "absolute",
                          "product_code": "a1",
                          "group_id": 1
                        },
                        {
                          "point_amount": 100,
                          "point_amount_unit": "absolute",
                          "product_code": "a2",
                          "group_id": 1
                        },
                        {
                          "point_amount": 100,
                          "point_amount_unit": "absolute",
                          "product_code": "b1",
                          "group_id": 2
                        },
                        {
                          "point_amount": 100,
                          "point_amount_unit": "absolute",
                          "product_code": "b2",
                          "group_id": 2
                        }
                      ]
                    }
                    ```

                    このキャンペーンが設定された状態で、商品a1、b1が同時に購入された場合、各商品に対する個別のルールが適用された上での総和がポイント付与値になりますが、付与値の上限が100ポイントになります。つまり100 + 200=300と計算されますが上限額の100ポイントが実際の付与値になります。商品a1、a2、 b1、b2が同時に購入された場合は100 + 100 + 200 + 200=600ですが上限額の100がポイント付与値になります。 商品a1、a2が同時に購入された場合は全商品グループから1種以上購入されるという条件を満たしていないためポイントは付与されません。
                max_point_amount:
                  type: integer
                  minimum: 1
                  nullable: true
                  title: 'キャンペーンによって付与されるポイントの上限'
                  description: |-
                    キャンペーンによって付与される1取引当たりのポイント数の上限を指定します。デフォルトは未指定です。

                    このパラメータが指定されている場合、amount_based_point_rules や product_based_point_rules によって計算されるポイント付与値がmax_point_amountを越えている場合、max_point_amountの値がポイント付与値となり、越えていない場合はその値がポイント付与値となります。
                max_total_point_amount:
                  type: integer
                  minimum: 1
                  nullable: true
                  title: 'キャンペーンによって付与されるの1人当たりの累計ポイントの上限'
                  description: |-
                    キャンペーンによって付与される1人当たりの累計ポイント数の上限を指定します。デフォルトは未指定です。

                    このパラメータが指定されている場合、各ユーザに対してそのキャンペーンによって過去付与されたポイントの累積値が記録されるようになります。
                    累積ポイント数がmax_total_point_amountを超えない限りにおいてキャンペーンで算出されたポイントが付与されます。

                applicable_account_metadata:
                  description: |-
                    ウォレットに紐付くメタデータが特定の値を持つときにのみ発火するキャンペーンを登録します。
                    メタデータの属性名 key とメタデータの値 value の組をオブジェクトとして指定します。
                    ウォレットのメタデータはCreateUserAccountやUpdateCustomerAccountで登録できます。

                    オプショナルパラメータtestによって比較方法を指定することができます。
                    デフォルトは equal で、その他に not-equalを指定可能です。

                    例1: 取引が行なわれたウォレットのメタデータに住所として東京が指定されているときのみ発火

                    ```javascript
                    {
                      "key": "prefecture",
                      "value": "tokyo"
                    }
                    ```

                    例2: 取引が行なわれたウォレットのメタデータに住所として東京以外が指定されているときのみ発火

                    ```javascript
                    {
                      "key": "prefecture",
                      "value": "tokyo",
                      "test": "not-equal"
                    }
                    ```

                  type: object
                  nullable: true
                  properties:
                    key:
                      type: string
                      description: |-
                        メタデータの属性名
                    value:
                      type: string
                      description: |-
                        メタデータの値
                    test:
                      type: string
                      enum: [equal, not-equal]
                      description: |-
                        メタデータの値の比較方法。デフォルトはequal
                  example: |-
                    {
                      "key": "sex",
                      "value": "male"
                    }

                applicable_transaction_metadata:
                  description: |-
                    取引時に指定するメタデータが特定の値を持つときにのみ発火するキャンペーンを登録します。
                    メタデータの属性名 key とメタデータの値 value の組をオブジェクトとして指定します。
                    取引のメタデータはCreatePaymentTransactionやCreateExternalTransactionで登録できます。

                    オプショナルパラメータtestによって比較方法を指定することができます。
                    デフォルトは equal で、その他に not-equalを指定可能です。

                    例1: 取引のメタデータに会員ランクとしてbronzeが指定されているときのみ発火

                    ```javascript
                    {
                      "key": "rank",
                      "value": "bronze"
                    }
                    ```

                    例2: 取引のメタデータに会員ランクとしてbronze以外が指定されているときのみ発火

                    ```javascript
                    {
                      "key": "rank",
                      "value": "bronze",
                      "test": "not-equal"
                    }
                    ```

                  type: object
                  nullable: true
                  properties:
                    key:
                      type: string
                      description: |-
                        メタデータの属性名
                    value:
                      type: string
                      description: |-
                        メタデータの値
                    test:
                      type: string
                      enum: [equal, not-equal]
                      description: |-
                        メタデータの値の比較方法。デフォルトはequal
                  example: |-
                    {
                      "key": "rank",
                      "value": "bronze"
                    }

                budget_caps_amount:
                  title: 'キャンペーン予算上限'
                  type: integer
                  minimum: 1
                  maximum: 10000000000
                  nullable: true
                  description: |-
                    キャンペーンの予算上限を指定します。

                    キャンペーン予算上限が設定されておらずこのパラメータに数値が指定されている場合、このキャンペーンの適用により付与されたポイント全体を定期的に集計し、その合計が上限を越えていた場合にはキャンペーンを無効にします。
                    一度この値を越えて無効となったキャンペーンを再度有効にすることは出来ません。
                    キャンペーン予算上限が設定されておらずこのパラメータにnullが指定されている場合、何も発生しない。
                    キャンペーン予算上限が設定されておりこのパラメータにnullが指定された場合、キャンペーン予算上限は止まります。

      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Campaign'
        '400':
          $ref: '#/components/responses/BadRequest'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'
  /user-stats:
    post:
      tags:
        - Transaction
      summary: '指定期間内の顧客が行った取引の統計情報をCSVでダウンロードする'
      description: |-
        期間を指定して、期間内に発行マネーの全顧客が行った取引の総額・回数などをCSVでダウンロードする機能です。
        CSVの作成は非同期で行われるため完了まで少しの間待つ必要がありますが、完了時にダウンロードできるURLをレスポンスとして返します。
        このURLの有効期限はリクエスト日時から7日間です。

        ダウンロードできるCSVのデータは以下のものです。

        * organization_code: 取引を行った組織コード
        * private_money_id: 取引されたマネーのID
        * private_money_name: 取引されたマネーの名前
        * user_id: 決済したユーザーID
        * user_external_id: 決済したユーザーの外部ID
        * payment_money_amount: 指定期間内に決済に使ったマネーの総額
        * payment_point_amount: 指定期間内に決済に使ったポイントの総額
        * payment_transaction_count: 指定期間内に決済した回数。キャンセルされた取引は含まない

        また、指定期間より前の決済を時間をおいてキャンセルした場合などには payment_money_amount, payment_point_amount, payment_transaction_count が負の値になることもあることに留意してください。
      x-pokepay-operator-name: "RequestUserStats"
      x-pokepay-allow-server-side: true
      requestBody:
        required: true
        content:
          application/json:
            schema:
              required: ["from", "to"]
              x-pokepay-conditional-parameters: {<: [from, to]}
              properties:
                from:
                  title: '集計期間の開始時刻'
                  type: string
                  format: date-time
                  description: |-
                    集計する期間の開始時刻をISO8601形式で指定します。
                    時刻は現在時刻、及び `to` で指定する時刻以前である必要があります。
                  example: '2022-05-20T17:56:49.000000+09:00'
                to:
                  title: '集計期間の終了時刻'
                  type: string
                  format: date-time
                  description: |-
                    集計する期間の終了時刻をISO8601形式で指定します。
                    時刻は現在時刻、及び `from` で指定する時刻の間である必要があります。
                  example: '2023-12-10T01:16:11.000000+09:00'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserStatsOperation'
        '400':
          $ref: '#/components/responses/InvalidParameters'
        '403':
          $ref: '#/components/responses/UnpermittedAdminUser'
        '503':
          $ref: '#/components/responses/UserStatsOperationServiceUnavailable'

  /user-stats/terminate:
    post:
      tags:
        - Transaction
      summary: 'RequestUserStatsのタスクを強制終了する'
      description: |-
        RequestUserStatsによるファイル生成のタスクを強制終了するためのAPIです。
        RequestUserStatsのレスポンス中の `operation_id` をキーにして強制終了リクエストを送ります。
        既に集計タスクが終了している場合は何も行いません。
        発行体に対して結果通知用のWebhook URLが設定されている場合、強制終了成功時には以下のような内容のPOSTリクエストが送られます。

        - task: "process_user_stats_operation"
        - operation_id: 強制終了対象のタスクID
        - status: "terminated"
      x-pokepay-operator-name: "TerminateUserStats"
      x-pokepay-allow-server-side: true
      requestBody:
        required: true
        content:
          application/json:
            schema:
              required: ["operation_id"]
              properties:
                operation_id:
                  type: string
                  format: uuid
                  title: '集計タスクID'
                  description: |-
                    強制終了対象の集計タスクIDです。
                    必須パラメータであり、指定されたタスクIDが存在しない場合は `user_stats_operation_not_found`エラー(422)が返ります。
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserStatsOperation'
        '400':
          $ref: '#/components/responses/InvalidParameters'
        '403':
          $ref: '#/components/responses/UnpermittedAdminUser'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'

  /webhooks:
    post:
      x-pokepay-operator-name: "CreateWebhook"
      x-pokepay-allow-server-side: true
      tags:
        - Webhook
      summary: webhookの作成
      description: |-
        ワーカータスクの処理が終了したことを通知するためのWebhookを登録します
        このAPIにより指定したタスクの終了時に、指定したURLにPOSTリクエストを送信します。
        このとき、リクエストボディは `{"task": <タスク名>}` という値になります。
      requestBody:
        required: true
        content:
          application/json:
            schema:
              required: ["task", "url"]
              properties:
                task:
                  type: string
                  enum: ["bulk_shops", "process_user_stats_operation"]
                  title: タスク名
                  description: ワーカータスク名を指定します
                url:
                  type: string
                  title: URL
                  description: 通知先のURLを指定します
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OrganizationWorkerTaskWebhook'
        '400':
          $ref: '#/components/responses/InvalidParameters'
        '403':
          $ref: '#/components/responses/Forbidden'
        '409':
          $ref: '#/components/responses/Conflict'
    get:
      x-pokepay-operator-name: "ListWebhooks"
      x-pokepay-allow-server-side: true
      tags:
        - Webhook
      summary: 作成したWebhookの一覧を返す
      requestBody:
        required: true
        content:
          application/json:
            schema:
              required: []
              properties:
                page:
                  type: integer
                  default: 1
                  minimum: 1
                  title: 'ページ番号'
                  description: 取得したいページ番号です。
                  example: 1
                per_page:
                  type: integer
                  default: 50
                  minimum: 1
                  title: '1ページ分の取得数'
                  description: 1ページ分の取得数です。デフォルトでは 50 になっています。
                  example: 50
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedOrganizationWorkerTaskWebhook'
        '400':
          $ref: '#/components/responses/InvalidParameters'
        '403':
          $ref: '#/components/responses/Forbidden'
  /webhooks/{webhook_id}:
    patch:
      x-pokepay-operator-name: "UpdateWebhook"
      x-pokepay-allow-server-side: true
      tags:
        - Webhook
      summary: Webhookの更新
      description: 指定したWebhookの内容を更新します
      parameters:
        - in: path
          name: webhook_id
          required: true
          schema:
            type: string
            format: uuid
            title: 'Webhook ID'
          description: |-
            更新するWebhookのIDです。
      requestBody:
        required: true
        content:
          application/json:
            schema:
              required: []
              properties:
                url:
                  type: string
                  title: URL
                  description: 変更するURLを指定します
                is_active:
                  type: boolean
                  title: 有効/無効
                  description: trueならWebhookによる通知が有効になり、falseなら無効になります
                task:
                  type: string
                  enum: ["bulk_shops", "process_user_stats_operation"]
                  title: タスク名
                  description: 指定したタスクが終了したときにWebhookによる通知がされます
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OrganizationWorkerTaskWebhook'
        '400':
          $ref: '#/components/responses/InvalidParameters'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
        '409':
          $ref: '#/components/responses/Conflict'

    delete:
      x-pokepay-operator-name: "DeleteWebhook"
      x-pokepay-allow-server-side: true
      tags:
        - Webhook
      summary: Webhookの削除
      description: 指定したWebhookを削除します
      parameters:
        - in: path
          name: webhook_id
          required: true
          schema:
            type: string
            format: uuid
            title: 'Webhook ID'
          description: |-
            削除するWebhookのIDです。
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OrganizationWorkerTaskWebhook'
        '400':
          $ref: '#/components/responses/InvalidParameters'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'

  /user-devices:
    post:
      x-pokepay-operator-name: "CreateUserDevice"
      x-pokepay-allow-server-side: true
      tags:
        - UserDevice
      summary: ユーザーのデバイス登録
      description: ユーザーのデバイスを新規に登録します
      requestBody:
        required: true
        content:
          application/json:
            schema:
              required: [user_id]
              properties:
                user_id:
                  type: string
                  format: uuid
                  title: 'ユーザーID'
                metadata:
                  type: string
                  format: json
                  title: ユーザーデバイスのメタデータ
                  description: |
                    ユーザーのデバイス用の情報をメタデータを保持するために用います。
                    例: 端末の固有情報やブラウザのUser-Agent
                  example: '{"user_agent": "Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:120.0) Gecko/20100101 Firefox/120.0"}'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserDevice'
        '403':
          $ref: '#/components/responses/UnpermittedAdminUser'
        '404':
          $ref: '#/components/responses/NotFound'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'

  /user-devices/{user_device_id}:
    get:
      x-pokepay-operator-name: "GetUserDevice"
      x-pokepay-allow-server-side: true
      tags:
        - UserDevice
      summary: ユーザーのデバイスを取得
      description: ユーザーのデバイスの情報を取得します
      parameters:
        - in: path
          name: user_device_id
          required: true
          schema:
            type: string
            format: uuid
            title: ユーザーデバイスID
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserDevice'
        '400':
          $ref: '#/components/responses/InvalidParameters'
        '403':
          $ref: '#/components/responses/UnpermittedAdminUser'
        '404':
          $ref: '#/components/responses/NotFound'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'

  /user-devices/{user_device_id}/activate:
    post:
      x-pokepay-operator-name: "ActivateUserDevice"
      x-pokepay-allow-server-side: true
      tags:
        - UserDevice
      summary: デバイスの有効化
      description: |
        指定のデバイスを有効化し、それ以外の同一ユーザーのデバイスを無効化します。
      parameters:
        - in: path
          name: user_device_id
          required: true
          schema:
            type: string
            format: uuid
            title: "ユーザーデバイスID"
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserDevice'
        '400':
          $ref: '#/components/responses/InvalidParameters'
        '403':
          $ref: '#/components/responses/UnpermittedAdminUser'
        '404':
          $ref: '#/components/responses/NotFound'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'
        '503':
          $ref: '#/components/responses/UserStatsOperationServiceUnavailable'

  /user-devices/{user_device_id}/banks:
    post:
      x-pokepay-operator-name: "CreateBank"
      x-pokepay-allow-server-side: true
      tags:
        - BankPay
      summary: 銀行口座の登録
      description: |
        銀行口座の登録を始めるAPIです。レスポンスに含まれるredirect_urlをユーザーの端末で開き銀行を登録します。

        ユーザーが銀行口座の登録に成功すると、callback_urlにリクエストが行われます。
        アプリの場合はDeep Linkを使うことを想定しています。
      parameters:
        - in: path
          name: user_device_id
          required: true
          schema:
            type: string
            format: uuid
            title: "デバイスID"
      requestBody:
        required: true
        content:
          application/json:
            schema:
              required: ["private_money_id", "callback_url", "kana"]
              properties:
                private_money_id:
                  type: string
                  format: uuid
                  title: 'マネーID'
                callback_url:
                  type: string
                  maxLength: 256
                  example: '<Deep Link>'
                  title: 'コールバックURL'
                kana:
                  type: string
                  maxLength: 30
                  example: 'ポケペイタロウ'
                  title: 'ユーザーの氏名 (片仮名で指定)'
                email:
                  type: string
                  format: email
                  maxLength: 300
                  title: 'ユーザーのメールアドレス'
                birthdate:
                  type: string
                  maxLength: 8
                  title: '生年月日'
                  example: '19901142'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BankRegisteringInfo'
        '400':
          $ref: '#/components/responses/InvalidParameters'
        '403':
          $ref: '#/components/responses/UnpermittedAdminUser'
        '404':
          $ref: '#/components/responses/NotFound'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'
        '503':
          $ref: '#/components/responses/UserStatsOperationServiceUnavailable'
    get:
      x-pokepay-operator-name: "ListBanks"
      x-pokepay-allow-server-side: true
      tags:
        - BankPay
      summary: 登録した銀行の一覧
      description: 登録した銀行を一覧します
      parameters:
        - in: path
          name: user_device_id
          required: true
          schema:
            type: string
            format: uuid
            title: "デバイスID"
      requestBody:
        required: true
        content:
          application/json:
            schema:
              properties:
                private_money_id:
                  type: string
                  format: uuid
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Banks'
        '400':
          $ref: '#/components/responses/InvalidParameters'
        '403':
          $ref: '#/components/responses/UnpermittedAdminUser'
        '404':
          $ref: '#/components/responses/NotFound'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'
    delete:
      x-pokepay-operator-name: "DeleteBanks"
      x-pokepay-allow-server-side: true
      tags:
        - BankPay
      summary: 銀行口座の削除
      description: 銀行口座を削除します
      parameters:
        - in: path
          name: user_device_id
          required: true
          schema:
            type: string
            format: uuid
            title: "デバイスID"
      requestBody:
        required: true
        content:
          application/json:
            schema:
              required: [bank_id]
              properties:
                bank_id:
                  type: string
                  format: uuid
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BankDeleted'
        '400':
          $ref: '#/components/responses/InvalidParameters'
        '403':
          $ref: '#/components/responses/UnpermittedAdminUser'
        '404':
          $ref: '#/components/responses/NotFound'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'

  /user-devices/{user_device_id}/banks/topup:
    post:
      x-pokepay-operator-name: "CreateBankTopupTransaction"
      x-pokepay-allow-server-side: true
      tags:
        - BankPay
      summary: 銀行からのチャージ
      description: 指定のマネーのアカウントにbank_idの口座を用いてチャージを行います。
      parameters:
        - in: path
          name: user_device_id
          required: true
          schema:
            type: string
            format: uuid
            title: "デバイスID"
      requestBody:
        required: true
        content:
          application/json:
            schema:
              required: ["private_money_id", "amount", "bank_id", "request_id"]
              properties:
                private_money_id:
                  type: string
                  format: uuid
                  title: 'マネーID'
                amount:
                  type: integer
                  minimum: 1
                  title: 'チャージ金額'
                bank_id:
                  type: string
                  format: uuid
                  title: '銀行ID'
                receiver_user_id:
                  type: string
                  format: uuid
                  title: '受け取りユーザーID (デフォルトは自身)'
                request_id:
                  type: string
                  format: uuid
                  title: 'リクエストID'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TransactionDetail'
        '400':
          $ref: '#/components/responses/InvalidParameters'
        '403':
          $ref: '#/components/responses/UnpermittedAdminUser'
        '404':
          $ref: '#/components/responses/NotFound'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'

  /coupons:
    get:
      x-pokepay-operator-name: "ListCoupons"
      x-pokepay-allow-server-side: true
      tags:
        - Coupon
      summary: クーポン一覧の取得
      description: 指定したマネーのクーポン一覧を取得します
      requestBody:
        required: true
        content:
          application/json:
            schema:
              required: [private_money_id]
              properties:
                private_money_id:
                  type: string
                  format: uuid
                  title: '対象クーポンのマネーID'
                  description: |
                    対象クーポンのマネーIDです(必須項目)。
                    存在しないマネーIDを指定した場合はprivate_money_not_foundエラー(422)が返ります。
                coupon_id:
                  type: string
                  title: 'クーポンID'
                  description: |
                    指定されたクーポンIDで結果をフィルターします。
                    部分一致(前方一致)します。
                coupon_name:
                  type: string
                  title: 'クーポン名'
                  description: |
                    指定されたクーポン名で結果をフィルターします。
                issued_shop_name:
                  type: string
                  title: '発行店舗名'
                  description: |
                    指定された発行店舗で結果をフィルターします。
                available_shop_name:
                  type: string
                  title: '利用可能店舗名'
                  description: |
                    指定された利用可能店舗で結果をフィルターします。
                available_from:
                  type: string
                  format: date-time
                  title: '利用可能期間 (開始日時)'
                  description: |
                    利用可能期間でフィルターします。フィルターの開始日時をISO8601形式で指定します。
                available_to:
                  type: string
                  format: date-time
                  title: '利用可能期間 (終了日時)'
                  description: |
                    利用可能期間でフィルターします。フィルターの終了日時をISO8601形式で指定します。
                page:
                  type: integer
                  default: 1
                  minimum: 1
                  title: 'ページ番号'
                  description: 取得したいページ番号です。
                  example: 1
                per_page:
                  type: integer
                  default: 50
                  minimum: 1
                  title: '1ページ分の取得数'
                  description: 1ページ分の取得数です。デフォルトでは 50 になっています。
                  example: 50
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedCoupons'
        '400':
          $ref: '#/components/responses/InvalidParameters'
        '403':
          $ref: '#/components/responses/UnpermittedAdminUser'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'
    post:
      x-pokepay-operator-name: "CreateCoupon"
      x-pokepay-allow-server-side: true
      tags:
        - Coupon
      summary: クーポンの登録
      description: 新しいクーポンを登録します
      requestBody:
        required: true
        content:
          application/json:
            schema:
              required: ["private_money_id", "name", "starts_at", "ends_at", "issued_shop_id"]
              x-pokepay-conditional-parameters:
                xor: [discount_amount, discount_percentage]
                xnor: [is_shop_specified, available_shop_ids]
              properties:
                private_money_id:
                  type: string
                  format: uuid
                name:
                  type: string
                  maxLength: 128
                description:
                  type: string
                  maxLength: 256
                discount_amount:
                  type: integer
                  minimum: 0
                discount_percentage:
                  type: number
                  minimum: 0
                discount_upper_limit:
                  type: integer
                  minimum: 0
                starts_at:
                  type: string
                  format: date-time
                ends_at:
                  type: string
                  format: date-time
                display_starts_at:
                  type: string
                  format: date-time
                  title: 'クーポンの掲載期間(開始日時)'
                display_ends_at:
                  type: string
                  format: date-time
                  title: 'クーポンの掲載期間(終了日時)'
                is_disabled:
                  type: boolean
                  title: '無効化フラグ'
                is_hidden:
                  type: boolean
                  title: 'クーポン一覧に掲載されるかどうか'
                  description: |
                    アプリに表示されるクーポン一覧に掲載されるかどうか。
                    主に一時的に掲載から外したいときに用いられる。そのためis_publicの設定よりも優先される。
                is_public:
                  type: boolean
                  title: 'アプリ配信なしで受け取れるかどうか'
                code:
                  type: string
                  title: 'クーポン受け取りコード'
                usage_limit:
                  type: integer
                  title: 'ユーザごとの利用可能回数(NULLの場合は無制限)'
                  default: 1
                min_amount:
                  type: integer
                  title: 'クーポン適用可能な最小取引額'
                issued_shop_id:
                  type: string
                  format: uuid
                  title: '発行元の店舗ID'
                is_shop_specified:
                  type: boolean
                  title: '特定店舗限定のクーポンかどうか'
                available_shop_ids:
                  type: array
                  items:
                    type: string
                    format: uuid
                  title: '利用可能店舗リスト'
                storage_id:
                  type: string
                  format: uuid
                  title: "ストレージID"
                  description: "Storage APIでアップロードしたクーポン画像のStorage IDを指定します"
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CouponDetail'
        '400':
          $ref: '#/components/responses/InvalidParameters'
        '403':
          $ref: '#/components/responses/UnpermittedAdminUser'
        '404':
          $ref: '#/components/responses/NotFound'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'

  /coupons/{coupon_id}:
    get:
      x-pokepay-operator-name: "GetCoupon"
      x-pokepay-allow-server-side: true
      tags:
        - Coupon
      summary: クーポンの取得
      description: 指定したIDを持つクーポンを取得します
      parameters:
        - in: path
          name: coupon_id
          required: true
          schema:
            type: string
            format: uuid
            title: 'クーポンID'
          description: |-
            取得するクーポンのIDです。
            UUIDv4フォーマットである必要があり、フォーマットが異なる場合は InvalidParametersエラー(400)が返ります。
            指定したIDのクーポンが存在しない場合はCouponNotFoundエラー(422)が返ります。
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CouponDetail'
        '400':
          $ref: '#/components/responses/InvalidParameters'
        '403':
          $ref: '#/components/responses/UnpermittedAdminUser'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'
    patch:
      x-pokepay-operator-name: "UpdateCoupon"
      x-pokepay-allow-server-side: true
      tags:
        - Coupon
      summary: クーポンの更新
      description: 指定したクーポンを更新します
      parameters:
        - in: path
          name: coupon_id
          required: true
          schema:
            type: string
            format: uuid
            title: 'クーポンID'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              x-pokepay-conditional-parameters: {or: [discount_amount, discount_percentage]}
              properties:
                name:
                  type: string
                  maxLength: 128
                description:
                  type: string
                  maxLength: 256
                discount_amount:
                  type: integer
                  nullable: true
                  minimum: 0
                discount_percentage:
                  type: number
                  nullable: true
                  minimum: 0
                discount_upper_limit:
                  type: integer
                  nullable: true
                  minimum: 0
                starts_at:
                  type: string
                  format: date-time
                ends_at:
                  type: string
                  format: date-time
                display_starts_at:
                  type: string
                  format: date-time
                  nullable: true
                  title: 'クーポンの掲載期間(開始日時)'
                display_ends_at:
                  type: string
                  format: date-time
                  nullable: true
                  title: 'クーポンの掲載期間(終了日時)'
                is_disabled:
                  type: boolean
                  title: '無効化フラグ'
                is_hidden:
                  type: boolean
                  title: 'クーポン一覧に掲載されるかどうか'
                  description: |
                    アプリに表示されるクーポン一覧に掲載されるかどうか。
                    主に一時的に掲載から外したいときに用いられる。そのためis_publicの設定よりも優先される。
                is_public:
                  type: boolean
                  title: 'アプリ配信なしで受け取れるかどうか'
                code:
                  type: string
                  nullable: true
                  title: 'クーポン受け取りコード'
                usage_limit:
                  type: integer
                  nullable: true
                  title: 'ユーザごとの利用可能回数(NULLの場合は無制限)'
                min_amount:
                  type: integer
                  nullable: true
                  title: 'クーポン適用可能な最小取引額'
                is_shop_specified:
                  type: boolean
                  title: '特定店舗限定のクーポンかどうか'
                available_shop_ids:
                  type: array
                  items:
                    type: string
                    format: uuid
                  title: '利用可能店舗リスト'
                storage_id:
                  type: string
                  format: uuid
                  title: "ストレージID"
                  description: "Storage APIでアップロードしたクーポン画像のStorage IDを指定します"
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CouponDetail'
        '400':
          $ref: '#/components/responses/InvalidParameters'
        '403':
          $ref: '#/components/responses/UnpermittedAdminUser'
        '404':
          $ref: '#/components/responses/NotFound'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'

  /seven-bank-atm-sessions/{qr_info}:
    get:
      x-pokepay-operator-name: "GetSevenBankATMSession"
      x-pokepay-allow-server-side: true
      tags:
        - SevenBankATMSession
      summary: セブン銀行ATMセッションの取得
      description: セブン銀行ATMセッションを取得します
      parameters:
        - in: path
          name: qr_info
          required: true
          schema:
            type: string
            title: 'QRコードの情報'
          description: |-
            取得するセブン銀行ATMチャージのQRコードの情報です。
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SevenBankATMSession'
        '400':
          $ref: '#/components/responses/InvalidParameters'
        '403':
          $ref: '#/components/responses/UnpermittedAdminUser'
        '404':
          $ref: '#/components/responses/NotFound'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'