Vantiv Chargeback API — Chargebacks

naftiko: 1.0.0-alpha2
info:
  label: Vantiv Chargeback API — Chargebacks
  description: 'Vantiv Chargeback API — Chargebacks. 3 operations. Lead operation: List Chargebacks. Self-contained Naftiko
    capability covering one Vantiv business surface.'
  tags:
  - Vantiv
  - Chargebacks
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    VANTIV_API_KEY: VANTIV_API_KEY
capability:
  consumes:
  - type: http
    namespace: chargeback-chargebacks
    baseUri: https://services.vantivprelive.com/services/chargebacks
    description: Vantiv Chargeback API — Chargebacks business capability. Self-contained, no shared references.
    resources:
    - name: chargebacks
      path: /chargebacks
      operations:
      - name: listchargebacks
        method: GET
        description: List Chargebacks
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: date
          in: query
          type: string
          description: Filter chargebacks by activity date (YYYY-MM-DD)
        - name: financialImpact
          in: query
          type: boolean
          description: Filter to only return chargebacks with financial impact
        - name: responded
          in: query
          type: boolean
          description: Filter by whether the chargeback has been responded to
    - name: chargebacks-caseId
      path: /chargebacks/{caseId}
      operations:
      - name: getchargeback
        method: GET
        description: Get Chargeback
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: caseId
          in: path
          type: integer
          description: Unique chargeback case identifier
          required: true
    - name: chargebacks-caseId-response
      path: /chargebacks/{caseId}/response
      operations:
      - name: respondtochargeback
        method: PUT
        description: Respond To Chargeback
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: caseId
          in: path
          type: integer
          description: Unique chargeback case identifier
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    authentication:
      type: basic
      username: '{{env.VANTIV_USER}}'
      password: '{{env.VANTIV_PASS}}'
  exposes:
  - type: rest
    namespace: chargeback-chargebacks-rest
    port: 8080
    description: REST adapter for Vantiv Chargeback API — Chargebacks. One Spectral-compliant resource per consumed operation,
      prefixed with /v1.
    resources:
    - path: /v1/chargebacks
      name: chargebacks
      description: REST surface for chargebacks.
      operations:
      - method: GET
        name: listchargebacks
        description: List Chargebacks
        call: chargeback-chargebacks.listchargebacks
        with:
          date: rest.date
          financialImpact: rest.financialImpact
          responded: rest.responded
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/chargebacks/{caseid}
      name: chargebacks-caseid
      description: REST surface for chargebacks-caseId.
      operations:
      - method: GET
        name: getchargeback
        description: Get Chargeback
        call: chargeback-chargebacks.getchargeback
        with:
          caseId: rest.caseId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/chargebacks/{caseid}/response
      name: chargebacks-caseid-response
      description: REST surface for chargebacks-caseId-response.
      operations:
      - method: PUT
        name: respondtochargeback
        description: Respond To Chargeback
        call: chargeback-chargebacks.respondtochargeback
        with:
          caseId: rest.caseId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: chargeback-chargebacks-mcp
    port: 9090
    transport: http
    description: MCP adapter for Vantiv Chargeback API — Chargebacks. One tool per consumed operation, routed inline through
      this capability's consumes block.
    tools:
    - name: list-chargebacks
      description: List Chargebacks
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: chargeback-chargebacks.listchargebacks
      with:
        date: tools.date
        financialImpact: tools.financialImpact
        responded: tools.responded
      outputParameters:
      - type: object
        mapping: $.
    - name: get-chargeback
      description: Get Chargeback
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: chargeback-chargebacks.getchargeback
      with:
        caseId: tools.caseId
      outputParameters:
      - type: object
        mapping: $.
    - name: respond-chargeback
      description: Respond To Chargeback
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: chargeback-chargebacks.respondtochargeback
      with:
        caseId: tools.caseId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.