Kushki · Capability

Kushki Card Present API — Terminals

Kushki Card Present — Terminals. 4 operations. Lead operation: Kushki Create Card Present Charge. Self-contained Naftiko capability covering Kushki One terminal management and EMV/contactless sale and void.

Kushki Card Present API — Terminals is a Naftiko capability published by Kushki, one of 10 capabilities the APIs.io network indexes for this provider. It bundles 4 operations across the GET and POST methods rooted at /v1/card-present.

The capability includes 2 read-only operations and 2 state-changing operations. Lead operation: Kushki List Terminals. Can be deployed as a REST endpoint, MCP tool, or Agent Skill via Naftiko.

Tagged areas include Kushki, Card Present, POS, and EMV.

Run with Naftiko KushkiCard PresentPOSEMV

What You Can Do

GET
Listterminals — Kushki List Terminals
/v1/card-present/terminals
GET
Getterminal — Kushki Get Terminal
/v1/card-present/terminals/{terminal-id}
POST
Createcardpresentcharge — Kushki Create Card Present Charge
/v1/card-present/charges
POST
Voidcardpresentcharge — Kushki Void Card Present Charge
/v1/card-present/charges/{ticket-number}/void

MCP Tools

kushki-list-terminals

Kushki List Terminals

read-only idempotent
kushki-get-terminal

Kushki Get Terminal

read-only idempotent
kushki-create-card-present-charge

Kushki Create Card Present Charge

kushki-void-card-present-charge

Kushki Void Card Present Charge

idempotent

Capability Spec

card-present-terminals.yaml Raw ↑ 
naftiko: 1.0.0-alpha2
info:
  label: Kushki Card Present API — Terminals
  description: 'Kushki Card Present — Terminals. 4 operations. Lead operation: Kushki Create Card Present Charge. Self-contained Naftiko capability covering Kushki One terminal management and EMV/contactless sale and void.'
  tags:
    - Kushki
    - Card Present
    - POS
    - EMV
  created: '2026-05-24'
  modified: '2026-05-24'
binds:
  - namespace: env
    keys:
      KUSHKI_PRIVATE_MERCHANT_ID: KUSHKI_PRIVATE_MERCHANT_ID
capability:
  consumes:
    - type: http
      namespace: card-present-terminals
      baseUri: https://api.kushkipagos.com
      description: Kushki One terminal management and card-present sale/void.
      resources:
        - name: cardpresent-v1-terminals
          path: /cardpresent/v1/terminals
          operations:
            - name: listterminals
              method: GET
              description: Kushki List Terminals
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: cardpresent-v1-terminals-id
          path: /cardpresent/v1/terminals/{terminalId}
          operations:
            - name: getterminal
              method: GET
              description: Kushki Get Terminal
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
              inputParameters:
                - name: terminalId
                  in: path
                  type: string
                  required: true
        - name: cardpresent-v1-charges
          path: /cardpresent/v1/charges
          operations:
            - name: createcardpresentcharge
              method: POST
              description: Kushki Create Card Present Charge
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
              inputParameters:
                - name: body
                  in: body
                  type: object
                  required: true
        - name: cardpresent-v1-charges-id-void
          path: /cardpresent/v1/charges/{ticketNumber}/void
          operations:
            - name: voidcardpresentcharge
              method: POST
              description: Kushki Void Card Present Charge
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
              inputParameters:
                - name: ticketNumber
                  in: path
                  type: string
                  required: true
      authentication:
        type: apikey
        key: Private-Merchant-Id
        value: '{{env.KUSHKI_PRIVATE_MERCHANT_ID}}'
        placement: header
  exposes:
    - type: rest
      namespace: card-present-terminals-rest
      port: 8080
      resources:
        - path: /v1/card-present/terminals
          name: cardpresent-v1-terminals
          operations:
            - method: GET
              name: listterminals
              description: Kushki List Terminals
              call: card-present-terminals.listterminals
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/card-present/terminals/{terminal-id}
          name: cardpresent-v1-terminals-id
          operations:
            - method: GET
              name: getterminal
              description: Kushki Get Terminal
              call: card-present-terminals.getterminal
              with:
                terminalId: rest.path.terminal-id
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/card-present/charges
          name: cardpresent-v1-charges
          operations:
            - method: POST
              name: createcardpresentcharge
              description: Kushki Create Card Present Charge
              call: card-present-terminals.createcardpresentcharge
              with:
                body: rest.body
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/card-present/charges/{ticket-number}/void
          name: cardpresent-v1-charges-id-void
          operations:
            - method: POST
              name: voidcardpresentcharge
              description: Kushki Void Card Present Charge
              call: card-present-terminals.voidcardpresentcharge
              with:
                ticketNumber: rest.path.ticket-number
              outputParameters:
                - type: object
                  mapping: $.
    - type: mcp
      namespace: card-present-terminals-mcp
      port: 9090
      transport: http
      tools:
        - name: kushki-list-terminals
          description: Kushki List Terminals
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: card-present-terminals.listterminals
          outputParameters:
            - type: object
              mapping: $.
        - name: kushki-get-terminal
          description: Kushki Get Terminal
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: card-present-terminals.getterminal
          with:
            terminalId: tools.terminalId
          outputParameters:
            - type: object
              mapping: $.
        - name: kushki-create-card-present-charge
          description: Kushki Create Card Present Charge
          hints:
            readOnly: false
            destructive: false
            idempotent: false
          call: card-present-terminals.createcardpresentcharge
          with:
            body: tools.body
          outputParameters:
            - type: object
              mapping: $.
        - name: kushki-void-card-present-charge
          description: Kushki Void Card Present Charge
          hints:
            readOnly: false
            destructive: true
            idempotent: true
          call: card-present-terminals.voidcardpresentcharge
          with:
            ticketNumber: tools.ticketNumber
          outputParameters:
            - type: object
              mapping: $.