naftiko: 1.0.0-alpha2
info:
  label: Tamara Disputes API
  description: 'Tamara Disputes API. 2 operations. Lead operation: Tamara List Disputes. Self-contained Naftiko capability covering Tamara''s merchant dispute surface.'
  tags:
  - Tamara
  - Disputes
  - Chargebacks
  created: '2026-05-24'
  modified: '2026-05-24'
binds:
- namespace: env
  keys:
    TAMARA_API_TOKEN: TAMARA_API_TOKEN
capability:
  consumes:
  - type: http
    namespace: disputes
    baseUri: https://api.tamara.co
    description: Tamara Disputes API business capability.
    resources:
    - name: external-merchants-orders-disputes
      path: /external/merchants/orders/disputes/
      operations:
      - name: listdisputes
        method: GET
        description: Tamara List Disputes
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: order_id
          in: query
          type: string
        - name: merchant_order_reference_id
          in: query
          type: string
        - name: dispute_id
          in: query
          type: integer
        - name: order_status
          in: query
          type: string
        - name: dispute_status
          in: query
          type: string
        - name: is_parent
          in: query
          type: boolean
        - name: limit
          in: query
          type: integer
        - name: page
          in: query
          type: integer
        - name: x-requested-with
          in: header
          type: string
    - name: external-merchants-orders-disputes-dispute_id
      path: /external/merchants/orders/disputes/{dispute_id}
      operations:
      - name: updatedispute
        method: POST
        description: Tamara Update Dispute by ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: dispute_id
          in: path
          type: integer
          required: true
        - name: body
          in: body
          type: object
          required: true
          description: multipart/form-data (comment, attachment, delivery_provider, order_delivery_tracking_id).
    authentication:
      type: bearer
      token: '{{env.TAMARA_API_TOKEN}}'
  exposes:
  - type: rest
    namespace: disputes-rest
    port: 8080
    description: REST adapter for Tamara Disputes API.
    resources:
    - path: /v1/external/merchants/orders/disputes
      name: external-merchants-orders-disputes
      operations:
      - method: GET
        name: listdisputes
        description: Tamara List Disputes
        call: disputes.listdisputes
        with:
          order_id: rest.order_id
          merchant_order_reference_id: rest.merchant_order_reference_id
          dispute_id: rest.dispute_id
          order_status: rest.order_status
          dispute_status: rest.dispute_status
          is_parent: rest.is_parent
          limit: rest.limit
          page: rest.page
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/external/merchants/orders/disputes/{dispute-id}
      name: external-merchants-orders-disputes-dispute-id
      operations:
      - method: POST
        name: updatedispute
        description: Tamara Update Dispute by ID
        call: disputes.updatedispute
        with:
          dispute_id: rest.dispute_id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: disputes-mcp
    port: 9090
    transport: http
    description: MCP adapter for Tamara Disputes API.
    tools:
    - name: tamara-list-disputes
      description: Tamara List Disputes
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: disputes.listdisputes
      with:
        order_id: tools.order_id
        merchant_order_reference_id: tools.merchant_order_reference_id
        dispute_id: tools.dispute_id
        order_status: tools.order_status
        dispute_status: tools.dispute_status
        is_parent: tools.is_parent
        limit: tools.limit
        page: tools.page
      outputParameters:
      - type: object
        mapping: $.
    - name: tamara-update-dispute
      description: Tamara Update Dispute by ID
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: disputes.updatedispute
      with:
        dispute_id: tools.dispute_id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.