naftiko: 1.0.0-alpha2
info:
  label: Bread Classic Merchant — Transactions & Shipping
  description: 'Bread Classic Merchant API — Transactions, Carts and Shipping. Covers the legacy bread-classic surface still documented at docs.breadpayments.com.'
  tags:
    - Bread Classic
    - Bread Financial
    - BNPL
    - Transactions
    - Carts
    - Shipping
    - Legacy
  created: '2026-05-23'
  modified: '2026-05-23'
binds:
  - namespace: env
    keys:
      BREAD_LEGACY_TOKEN: BREAD_LEGACY_TOKEN
capability:
  consumes:
    - type: http
      namespace: bread-classic-transactions
      baseUri: https://api.breadpayments.com
      description: Bread Classic Merchant API consumer.
      resources:
        - name: carts
          path: /carts
          operations:
            - name: createCart
              method: POST
              description: Bread Classic Create A Cart
              outputRawFormat: json
              inputParameters:
                - name: body
                  in: body
                  type: object
                  required: true
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: cart-id
          path: /carts/{cartID}
          operations:
            - name: getCart
              method: GET
              description: Bread Classic Get A Cart
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: transaction-id
          path: /transactions/{transactionID}
          operations:
            - name: getTransactionClassic
              method: GET
              description: Bread Classic Get A Transaction
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
            - name: updateTransactionClassic
              method: PUT
              description: Bread Classic Update A Transaction
              outputRawFormat: json
              inputParameters:
                - name: body
                  in: body
                  type: object
                  required: true
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: transaction-id-shipping
          path: /transactions/{transactionID}/shipping
          operations:
            - name: addTransactionShipping
              method: POST
              description: Bread Classic Add Transaction Shipping
              outputRawFormat: json
              inputParameters:
                - name: body
                  in: body
                  type: object
                  required: true
              outputParameters:
                - name: result
                  type: object
                  value: $.
            - name: getTransactionShipping
              method: GET
              description: Bread Classic Get Transaction Shipping
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
      authentication:
        type: bearer
        token: '{{env.BREAD_LEGACY_TOKEN}}'
  exposes:
    - type: rest
      namespace: bread-classic-transactions-rest
      port: 8080
      description: REST adapter for the legacy Bread Classic Merchant API.
      resources:
        - path: /v1/carts
          name: carts
          description: REST surface for Bread Classic carts.
          operations:
            - method: POST
              name: createCart
              call: bread-classic-transactions.createCart
              with:
                body: rest.body
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/transactions/{transactionID}/shipping
          name: transaction-id-shipping
          description: REST surface for transaction shipping.
          operations:
            - method: POST
              name: addTransactionShipping
              call: bread-classic-transactions.addTransactionShipping
              with:
                body: rest.body
              outputParameters:
                - type: object
                  mapping: $.
            - method: GET
              name: getTransactionShipping
              call: bread-classic-transactions.getTransactionShipping
              outputParameters:
                - type: object
                  mapping: $.
    - type: mcp
      namespace: bread-classic-transactions-mcp
      port: 9090
      transport: http
      description: MCP adapter for Bread Classic Merchant API.
      tools:
        - name: bread-classic-create-cart
          description: Bread Classic Create A Cart
          hints:
            readOnly: false
            destructive: false
            idempotent: false
          call: bread-classic-transactions.createCart
          with:
            body: tools.body
          outputParameters:
            - type: object
              mapping: $.
        - name: bread-classic-get-cart
          description: Bread Classic Get A Cart
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: bread-classic-transactions.getCart
          outputParameters:
            - type: object
              mapping: $.
        - name: bread-classic-get-transaction
          description: Bread Classic Get A Transaction
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: bread-classic-transactions.getTransactionClassic
          outputParameters:
            - type: object
              mapping: $.
        - name: bread-classic-update-transaction
          description: Bread Classic Update A Transaction (authorize/cancel/settle/refund)
          hints:
            readOnly: false
            destructive: true
            idempotent: false
          call: bread-classic-transactions.updateTransactionClassic
          with:
            body: tools.body
          outputParameters:
            - type: object
              mapping: $.
        - name: bread-classic-add-shipping
          description: Bread Classic Add Transaction Shipping
          hints:
            readOnly: false
            destructive: false
            idempotent: false
          call: bread-classic-transactions.addTransactionShipping
          with:
            body: tools.body
          outputParameters:
            - type: object
              mapping: $.
        - name: bread-classic-get-shipping
          description: Bread Classic Get Transaction Shipping
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: bread-classic-transactions.getTransactionShipping
          outputParameters:
            - type: object
              mapping: $.