Google Wallet API

naftiko: 1.0.0-alpha2
info:
  label: Google Wallet API
  description: The Google Wallet API enables developers to create and manage digital passes including event tickets, boarding
    passes, loyalty cards, gift cards, offers, transit passes, and generic passes. It provides REST endpoints for creating
    pass classes (templates) and pass objects (instances), managing issuers, handling media uploads, and generating JWT tokens
    for save-to-wallet functionality.
  tags:
  - Google
  - Wallet
  - API
  created: '2026-05-06'
  modified: '2026-05-06'
capability:
  consumes:
  - type: http
    namespace: google-wallet
    baseUri: https://walletobjects.googleapis.com/walletobjects/v1
    description: Google Wallet API HTTP API.
    resources:
    - name: genericclass
      path: /genericClass
      operations:
      - name: insertgenericclass
        method: POST
        description: Google Wallet Insert Generic Class
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: listgenericclasses
        method: GET
        description: Google Wallet List Generic Classes
        inputParameters:
        - name: issuerId
          in: query
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: genericclass-resourceid
      path: /genericClass/{resourceId}
      operations:
      - name: getgenericclass
        method: GET
        description: Google Wallet Get Generic Class
        inputParameters:
        - name: resourceId
          in: path
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: updategenericclass
        method: PUT
        description: Google Wallet Update Generic Class
        inputParameters:
        - name: resourceId
          in: path
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: genericobject
      path: /genericObject
      operations:
      - name: insertgenericobject
        method: POST
        description: Google Wallet Insert Generic Object
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: genericobject-resourceid
      path: /genericObject/{resourceId}
      operations:
      - name: getgenericobject
        method: GET
        description: Google Wallet Get Generic Object
        inputParameters:
        - name: resourceId
          in: path
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: eventticketclass
      path: /eventTicketClass
      operations:
      - name: inserteventticketclass
        method: POST
        description: Google Wallet Insert Event Ticket Class
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: loyaltyclass
      path: /loyaltyClass
      operations:
      - name: insertloyaltyclass
        method: POST
        description: Google Wallet Insert Loyalty Class
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: issuer
      path: /issuer
      operations:
      - name: listissuers
        method: GET
        description: Google Wallet List Issuers
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: jwt
      path: /jwt
      operations:
      - name: insertjwt
        method: POST
        description: Google Wallet Insert JWT
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: rest
    port: 8080
    namespace: google-wallet-rest
    description: REST adapter for Google Wallet API.
    resources:
    - path: /genericClass
      name: insertgenericclass
      operations:
      - method: POST
        name: insertgenericclass
        description: Google Wallet Insert Generic Class
        call: google-wallet.insertgenericclass
        outputParameters:
        - type: object
          mapping: $.
    - path: /genericClass
      name: listgenericclasses
      operations:
      - method: GET
        name: listgenericclasses
        description: Google Wallet List Generic Classes
        call: google-wallet.listgenericclasses
        outputParameters:
        - type: object
          mapping: $.
    - path: /genericClass/{resourceId}
      name: getgenericclass
      operations:
      - method: GET
        name: getgenericclass
        description: Google Wallet Get Generic Class
        call: google-wallet.getgenericclass
        with:
          resourceId: rest.resourceId
        outputParameters:
        - type: object
          mapping: $.
    - path: /genericClass/{resourceId}
      name: updategenericclass
      operations:
      - method: PUT
        name: updategenericclass
        description: Google Wallet Update Generic Class
        call: google-wallet.updategenericclass
        with:
          resourceId: rest.resourceId
        outputParameters:
        - type: object
          mapping: $.
    - path: /genericObject
      name: insertgenericobject
      operations:
      - method: POST
        name: insertgenericobject
        description: Google Wallet Insert Generic Object
        call: google-wallet.insertgenericobject
        outputParameters:
        - type: object
          mapping: $.
    - path: /genericObject/{resourceId}
      name: getgenericobject
      operations:
      - method: GET
        name: getgenericobject
        description: Google Wallet Get Generic Object
        call: google-wallet.getgenericobject
        with:
          resourceId: rest.resourceId
        outputParameters:
        - type: object
          mapping: $.
    - path: /eventTicketClass
      name: inserteventticketclass
      operations:
      - method: POST
        name: inserteventticketclass
        description: Google Wallet Insert Event Ticket Class
        call: google-wallet.inserteventticketclass
        outputParameters:
        - type: object
          mapping: $.
    - path: /loyaltyClass
      name: insertloyaltyclass
      operations:
      - method: POST
        name: insertloyaltyclass
        description: Google Wallet Insert Loyalty Class
        call: google-wallet.insertloyaltyclass
        outputParameters:
        - type: object
          mapping: $.
    - path: /issuer
      name: listissuers
      operations:
      - method: GET
        name: listissuers
        description: Google Wallet List Issuers
        call: google-wallet.listissuers
        outputParameters:
        - type: object
          mapping: $.
    - path: /jwt
      name: insertjwt
      operations:
      - method: POST
        name: insertjwt
        description: Google Wallet Insert JWT
        call: google-wallet.insertjwt
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    port: 9090
    namespace: google-wallet-mcp
    transport: http
    description: MCP adapter for Google Wallet API for AI agent use.
    tools:
    - name: insertgenericclass
      description: Google Wallet Insert Generic Class
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: google-wallet.insertgenericclass
      outputParameters:
      - type: object
        mapping: $.
    - name: listgenericclasses
      description: Google Wallet List Generic Classes
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: google-wallet.listgenericclasses
      with:
        issuerId: tools.issuerId
      inputParameters:
      - name: issuerId
        type: string
        description: issuerId
        required: true
      outputParameters:
      - type: object
        mapping: $.
    - name: getgenericclass
      description: Google Wallet Get Generic Class
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: google-wallet.getgenericclass
      with:
        resourceId: tools.resourceId
      inputParameters:
      - name: resourceId
        type: string
        description: resourceId
        required: true
      outputParameters:
      - type: object
        mapping: $.
    - name: updategenericclass
      description: Google Wallet Update Generic Class
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: google-wallet.updategenericclass
      with:
        resourceId: tools.resourceId
      inputParameters:
      - name: resourceId
        type: string
        description: resourceId
        required: true
      outputParameters:
      - type: object
        mapping: $.
    - name: insertgenericobject
      description: Google Wallet Insert Generic Object
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: google-wallet.insertgenericobject
      outputParameters:
      - type: object
        mapping: $.
    - name: getgenericobject
      description: Google Wallet Get Generic Object
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: google-wallet.getgenericobject
      with:
        resourceId: tools.resourceId
      inputParameters:
      - name: resourceId
        type: string
        description: resourceId
        required: true
      outputParameters:
      - type: object
        mapping: $.
    - name: inserteventticketclass
      description: Google Wallet Insert Event Ticket Class
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: google-wallet.inserteventticketclass
      outputParameters:
      - type: object
        mapping: $.
    - name: insertloyaltyclass
      description: Google Wallet Insert Loyalty Class
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: google-wallet.insertloyaltyclass
      outputParameters:
      - type: object
        mapping: $.
    - name: listissuers
      description: Google Wallet List Issuers
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: google-wallet.listissuers
      outputParameters:
      - type: object
        mapping: $.
    - name: insertjwt
      description: Google Wallet Insert JWT
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: google-wallet.insertjwt
      outputParameters:
      - type: object
        mapping: $.