Fintecture Customers API — Verifications

naftiko: 1.0.0-alpha2
info:
  label: Fintecture Customers API — Verifications
  description: 'Fintecture Customers API — Verifications. 3 operations. Lead operation: Initiate Customer Verification.'
  tags: [Fintecture, Customers, KYC, Verifications]
  created: '2026-05-25'
  modified: '2026-05-25'
binds:
  - namespace: env
    keys:
      FINTECTURE_CUSTOMER_TOKEN: FINTECTURE_CUSTOMER_TOKEN
capability:
  consumes:
    - type: http
      namespace: customers-verifications
      baseUri: https://api.fintecture.com
      description: Customer identity verifications.
      resources:
        - name: v1-customer-verification
          path: /v1/customers/{customer_id}/verification
          operations:
            - name: initiatecustomerverification
              method: POST
              description: Initiate Customer Verification
              outputRawFormat: json
              outputParameters: [{ name: result, type: object, value: '$.' }]
              inputParameters:
                - { name: customer_id, in: path, required: true }
                - { name: body, in: body, required: true }
        - name: v1-customer-verifications-list
          path: /v1/customers/{customer_id}/verifications
          operations:
            - name: listallcustomerverifications
              method: GET
              description: List All Customer Verifications
              outputRawFormat: json
              outputParameters: [{ name: result, type: object, value: '$.' }]
              inputParameters:
                - { name: customer_id, in: path, required: true }
        - name: v1-customer-verification-by-id
          path: /v1/customers/{customer_id}/verification/{verification_id}
          operations:
            - name: getcustomerverificationbyid
              method: GET
              description: Get A Verification
              outputRawFormat: json
              outputParameters: [{ name: result, type: object, value: '$.' }]
              inputParameters:
                - { name: customer_id, in: path, required: true }
                - { name: verification_id, in: path, required: true }
      authentication:
        type: bearer
        value: '{{env.FINTECTURE_CUSTOMER_TOKEN}}'
        placement: header
  exposes:
    - type: rest
      namespace: customers-verifications-rest
      port: 8080
      resources:
        - path: /v1/v1/customers/{customer_id}/verification
          name: v1-customer-verification
          operations:
            - { method: POST, name: initiatecustomerverification, call: customers-verifications.initiatecustomerverification, with: { customer_id: rest.customer_id, body: rest.body } }
    - type: mcp
      namespace: customers-verifications-mcp
      port: 9090
      transport: http
      tools:
        - name: fintecture-initiate-customer-verification
          description: Initiate Customer Verification
          hints: { readOnly: false, destructive: false, idempotent: false }
          call: customers-verifications.initiatecustomerverification
          with: { customer_id: tools.customer_id, body: tools.body }
        - name: fintecture-list-customer-verifications
          description: List All Customer Verifications
          hints: { readOnly: true, destructive: false, idempotent: true }
          call: customers-verifications.listallcustomerverifications
          with: { customer_id: tools.customer_id }
        - name: fintecture-get-customer-verification
          description: Get A Verification
          hints: { readOnly: true, destructive: false, idempotent: true }
          call: customers-verifications.getcustomerverificationbyid
          with: { customer_id: tools.customer_id, verification_id: tools.verification_id }