naftiko: 1.0.0-alpha2
info:
  label: Tamara Channel Partners API
  description: 'Tamara Channel Partners API. 5 operations. Lead operation: Tamara Create Merchant Onboarding. Self-contained Naftiko capability for PSPs and platforms that onboard merchants onto Tamara on behalf of customers and listen for onboarding-status webhook events.'
  tags:
  - Tamara
  - Channel Partners
  - Onboarding
  - KYB
  created: '2026-05-24'
  modified: '2026-05-24'
binds:
- namespace: env
  keys:
    TAMARA_PARTNER_TOKEN: TAMARA_PARTNER_TOKEN
capability:
  consumes:
  - type: http
    namespace: channel-partners
    baseUri: https://partner-api.tamara.co
    description: Tamara Channel Partners API business capability. Hosted on the dedicated partner subdomain.
    resources:
    - name: channel-partners-merchant-onboarding-create
      path: /channel-partners/merchant-onboarding/create
      operations:
      - name: createmerchantonboarding
        method: POST
        description: Tamara Create Merchant Onboarding
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          required: true
    - name: channel-partners-merchant-onboarding-onboardingcode
      path: /channel-partners/merchant-onboarding/{onboardingCode}
      operations:
      - name: retrievemerchantonboarding
        method: GET
        description: Tamara Retrieve Merchant Onboarding
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: onboardingCode
          in: path
          type: string
          required: true
    - name: channel-partners-merchant-merchantid-api-key
      path: /channel-partners/merchant/{merchantId}/api-key
      operations:
      - name: retrievemerchantapikeys
        method: GET
        description: Tamara Retrieve Merchant API Keys
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: merchantId
          in: path
          type: string
          required: true
    - name: channel-partners-webhooks-register
      path: /channel-partners/webhooks/register
      operations:
      - name: registerpartnerwebhook
        method: POST
        description: Tamara Register Channel Partner Webhook
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          required: true
    - name: channel-partners-webhooks
      path: /channel-partners/webhooks
      operations:
      - name: listpartnerwebhooks
        method: GET
        description: Tamara Retrieve Channel Partner Webhooks
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters: []
    authentication:
      type: bearer
      token: '{{env.TAMARA_PARTNER_TOKEN}}'
  exposes:
  - type: rest
    namespace: channel-partners-rest
    port: 8080
    description: REST adapter for Tamara Channel Partners API.
    resources:
    - path: /v1/channel-partners/merchant-onboarding/create
      name: channel-partners-merchant-onboarding-create
      operations:
      - method: POST
        name: createmerchantonboarding
        description: Tamara Create Merchant Onboarding
        call: channel-partners.createmerchantonboarding
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/channel-partners/merchant-onboarding/{onboarding-code}
      name: channel-partners-merchant-onboarding-onboarding-code
      operations:
      - method: GET
        name: retrievemerchantonboarding
        description: Tamara Retrieve Merchant Onboarding
        call: channel-partners.retrievemerchantonboarding
        with:
          onboardingCode: rest.onboardingCode
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/channel-partners/merchant/{merchant-id}/api-key
      name: channel-partners-merchant-merchant-id-api-key
      operations:
      - method: GET
        name: retrievemerchantapikeys
        description: Tamara Retrieve Merchant API Keys
        call: channel-partners.retrievemerchantapikeys
        with:
          merchantId: rest.merchantId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/channel-partners/webhooks/register
      name: channel-partners-webhooks-register
      operations:
      - method: POST
        name: registerpartnerwebhook
        description: Tamara Register Channel Partner Webhook
        call: channel-partners.registerpartnerwebhook
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/channel-partners/webhooks
      name: channel-partners-webhooks
      operations:
      - method: GET
        name: listpartnerwebhooks
        description: Tamara Retrieve Channel Partner Webhooks
        call: channel-partners.listpartnerwebhooks
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: channel-partners-mcp
    port: 9090
    transport: http
    description: MCP adapter for Tamara Channel Partners API.
    tools:
    - name: tamara-create-merchant-onboarding
      description: Tamara Create Merchant Onboarding
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: channel-partners.createmerchantonboarding
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: tamara-retrieve-merchant-onboarding
      description: Tamara Retrieve Merchant Onboarding
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: channel-partners.retrievemerchantonboarding
      with:
        onboardingCode: tools.onboardingCode
      outputParameters:
      - type: object
        mapping: $.
    - name: tamara-retrieve-merchant-api-keys
      description: Tamara Retrieve Merchant API Keys
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: channel-partners.retrievemerchantapikeys
      with:
        merchantId: tools.merchantId
      outputParameters:
      - type: object
        mapping: $.
    - name: tamara-register-channel-partner-webhook
      description: Tamara Register Channel Partner Webhook
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: channel-partners.registerpartnerwebhook
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: tamara-list-channel-partner-webhooks
      description: Tamara Retrieve Channel Partner Webhooks
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: channel-partners.listpartnerwebhooks
      outputParameters:
      - type: object
        mapping: $.