Synctera API — Card Transaction Simulations

naftiko: 1.0.0-alpha2
info:
  label: Synctera API — Card Transaction Simulations
  description: 'Synctera API — Card Transaction Simulations. 9 operations. Lead operation: Simulate authorization. Self-contained
    Naftiko capability covering one Synctera business surface.'
  tags:
  - Synctera
  - Card Transaction Simulations
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    SYNCTERA_API_KEY: SYNCTERA_API_KEY
capability:
  consumes:
  - type: http
    namespace: synctera-card-transaction-simulations
    baseUri: https://api.synctera.com/v0
    description: Synctera API — Card Transaction Simulations business capability. Self-contained, no shared references.
    resources:
    - name: cards-transaction_simulations-authorization
      path: /cards/transaction_simulations/authorization
      operations:
      - name: simulateauthorization
        method: POST
        description: Simulate authorization
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: cards-transaction_simulations-authorization-advice
      path: /cards/transaction_simulations/authorization/advice
      operations:
      - name: simulateauthorizationadvice
        method: POST
        description: Simulate authorization advice
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: cards-transaction_simulations-clearing
      path: /cards/transaction_simulations/clearing
      operations:
      - name: simulateclearing
        method: POST
        description: Simulate clearing or refund
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: cards-transaction_simulations-financial
      path: /cards/transaction_simulations/financial
      operations:
      - name: simulatefinancial
        method: POST
        description: Simulate financial
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: cards-transaction_simulations-financial-advice
      path: /cards/transaction_simulations/financial/advice
      operations:
      - name: simulatefinancialadvice
        method: POST
        description: Simulate financial advice
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: cards-transaction_simulations-financial-balance_inquiry
      path: /cards/transaction_simulations/financial/balance_inquiry
      operations:
      - name: simulatebalanceinquiry
        method: POST
        description: Simulate balance inquiry
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: cards-transaction_simulations-financial-original_credit
      path: /cards/transaction_simulations/financial/original_credit
      operations:
      - name: simulateoriginalcredit
        method: POST
        description: Simulate OCT
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: cards-transaction_simulations-financial-withdrawal
      path: /cards/transaction_simulations/financial/withdrawal
      operations:
      - name: simulatewithdrawal
        method: POST
        description: Simulate ATM withdrawal
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: cards-transaction_simulations-reversal
      path: /cards/transaction_simulations/reversal
      operations:
      - name: simulatereversal
        method: POST
        description: Simulate reversal
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    authentication:
      type: bearer
      token: '{{env.SYNCTERA_API_KEY}}'
  exposes:
  - type: rest
    namespace: synctera-card-transaction-simulations-rest
    port: 8080
    description: REST adapter for Synctera API — Card Transaction Simulations. One Spectral-compliant resource per consumed
      operation, prefixed with /v1.
    resources:
    - path: /v1/cards/transaction-simulations/authorization
      name: cards-transaction-simulations-authorization
      description: REST surface for cards-transaction_simulations-authorization.
      operations:
      - method: POST
        name: simulateauthorization
        description: Simulate authorization
        call: synctera-card-transaction-simulations.simulateauthorization
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/cards/transaction-simulations/authorization/advice
      name: cards-transaction-simulations-authorization-advice
      description: REST surface for cards-transaction_simulations-authorization-advice.
      operations:
      - method: POST
        name: simulateauthorizationadvice
        description: Simulate authorization advice
        call: synctera-card-transaction-simulations.simulateauthorizationadvice
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/cards/transaction-simulations/clearing
      name: cards-transaction-simulations-clearing
      description: REST surface for cards-transaction_simulations-clearing.
      operations:
      - method: POST
        name: simulateclearing
        description: Simulate clearing or refund
        call: synctera-card-transaction-simulations.simulateclearing
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/cards/transaction-simulations/financial
      name: cards-transaction-simulations-financial
      description: REST surface for cards-transaction_simulations-financial.
      operations:
      - method: POST
        name: simulatefinancial
        description: Simulate financial
        call: synctera-card-transaction-simulations.simulatefinancial
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/cards/transaction-simulations/financial/advice
      name: cards-transaction-simulations-financial-advice
      description: REST surface for cards-transaction_simulations-financial-advice.
      operations:
      - method: POST
        name: simulatefinancialadvice
        description: Simulate financial advice
        call: synctera-card-transaction-simulations.simulatefinancialadvice
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/cards/transaction-simulations/financial/balance-inquiry
      name: cards-transaction-simulations-financial-balance-inquiry
      description: REST surface for cards-transaction_simulations-financial-balance_inquiry.
      operations:
      - method: POST
        name: simulatebalanceinquiry
        description: Simulate balance inquiry
        call: synctera-card-transaction-simulations.simulatebalanceinquiry
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/cards/transaction-simulations/financial/original-credit
      name: cards-transaction-simulations-financial-original-credit
      description: REST surface for cards-transaction_simulations-financial-original_credit.
      operations:
      - method: POST
        name: simulateoriginalcredit
        description: Simulate OCT
        call: synctera-card-transaction-simulations.simulateoriginalcredit
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/cards/transaction-simulations/financial/withdrawal
      name: cards-transaction-simulations-financial-withdrawal
      description: REST surface for cards-transaction_simulations-financial-withdrawal.
      operations:
      - method: POST
        name: simulatewithdrawal
        description: Simulate ATM withdrawal
        call: synctera-card-transaction-simulations.simulatewithdrawal
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/cards/transaction-simulations/reversal
      name: cards-transaction-simulations-reversal
      description: REST surface for cards-transaction_simulations-reversal.
      operations:
      - method: POST
        name: simulatereversal
        description: Simulate reversal
        call: synctera-card-transaction-simulations.simulatereversal
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: synctera-card-transaction-simulations-mcp
    port: 9090
    transport: http
    description: MCP adapter for Synctera API — Card Transaction Simulations. One tool per consumed operation, routed inline
      through this capability's consumes block.
    tools:
    - name: simulate-authorization
      description: Simulate authorization
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: synctera-card-transaction-simulations.simulateauthorization
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: simulate-authorization-advice
      description: Simulate authorization advice
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: synctera-card-transaction-simulations.simulateauthorizationadvice
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: simulate-clearing-refund
      description: Simulate clearing or refund
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: synctera-card-transaction-simulations.simulateclearing
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: simulate-financial
      description: Simulate financial
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: synctera-card-transaction-simulations.simulatefinancial
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: simulate-financial-advice
      description: Simulate financial advice
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: synctera-card-transaction-simulations.simulatefinancialadvice
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: simulate-balance-inquiry
      description: Simulate balance inquiry
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: synctera-card-transaction-simulations.simulatebalanceinquiry
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: simulate-oct
      description: Simulate OCT
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: synctera-card-transaction-simulations.simulateoriginalcredit
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: simulate-atm-withdrawal
      description: Simulate ATM withdrawal
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: synctera-card-transaction-simulations.simulatewithdrawal
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: simulate-reversal
      description: Simulate reversal
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: synctera-card-transaction-simulations.simulatereversal
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.