naftiko: 1.0.0-alpha2
info:
  label: Bread Pay Platform — Buyers
  description: 'Bread Pay Platform API — Buyers. Retrieve a buyer record by ID and list personalized payment options. Self-contained Naftiko capability.'
  tags:
    - Bread Pay
    - Bread Financial
    - BNPL
    - Buyers
    - Payment Options
  created: '2026-05-23'
  modified: '2026-05-23'
binds:
  - namespace: env
    keys:
      BREAD_CLIENT_ID: BREAD_CLIENT_ID
      BREAD_CLIENT_SECRET: BREAD_CLIENT_SECRET
capability:
  consumes:
    - type: http
      namespace: bread-pay-platform-buyers
      baseUri: https://api.platform.breadpayments.com/api
      description: Bread Pay Platform Buyers consumer.
      resources:
        - name: buyer-id
          path: /buyer/{id}
          operations:
            - name: getBuyer
              method: GET
              description: Bread Pay Get A Buyer
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: payment-options
          path: /payment-options
          operations:
            - name: listPaymentOptions
              method: GET
              description: Bread Pay List Payment Options
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: array
                  value: $.
      authentication:
        type: oauth2
        flow: client_credentials
        tokenUrl: https://auth.platform.breadpayments.com/auth/sso/token
        clientId: '{{env.BREAD_CLIENT_ID}}'
        clientSecret: '{{env.BREAD_CLIENT_SECRET}}'
  exposes:
    - type: rest
      namespace: bread-pay-platform-buyers-rest
      port: 8080
      description: REST adapter for Bread Pay Platform Buyers, prefixed with /v1.
      resources:
        - path: /v1/buyer/{id}
          name: buyer-id
          description: REST surface for a single buyer.
          operations:
            - method: GET
              name: getBuyer
              description: Bread Pay Get A Buyer
              call: bread-pay-platform-buyers.getBuyer
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/payment-options
          name: payment-options
          description: REST surface for buyer payment options.
          operations:
            - method: GET
              name: listPaymentOptions
              description: Bread Pay List Payment Options
              call: bread-pay-platform-buyers.listPaymentOptions
              outputParameters:
                - type: array
                  mapping: $.
    - type: mcp
      namespace: bread-pay-platform-buyers-mcp
      port: 9090
      transport: http
      description: MCP adapter for Bread Pay Platform Buyers.
      tools:
        - name: bread-pay-get-buyer
          description: Bread Pay Get A Buyer
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: bread-pay-platform-buyers.getBuyer
          outputParameters:
            - type: object
              mapping: $.
        - name: bread-pay-list-payment-options
          description: Bread Pay List Payment Options
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: bread-pay-platform-buyers.listPaymentOptions
          outputParameters:
            - type: array
              mapping: $.