openapi: 3.2.0
info:
  title: Falcon Fee API
  version: 1.0.0
  description: 'Operations tagged Fee across 2 of this provider''s published API definitions: falcon-assign-a-fee-model-to-a-program-openapi.yml, falcon-fee-apis-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://stage1.tab.kitecash.in/cc-open-api/falcon/v1
tags:
- name: Fee
paths:
  /fee/assign:
    post:
      summary: Assign a Fee Model to a Program
      description: Use this endpoint to assign a fee model to a program.
      operationId: assign-fee-model
      parameters:
      - in: header
        name: x-tenant-id
        schema:
          type: string
        required: true
        example: falcon
      - in: header
        name: Authorization
        schema:
          type: string
        required: true
        example: Bearer {access_token}
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
              - programeID
              - feeModelID
              properties:
                programeID:
                  type: string
                  description: The unique ID of the program to which the fee model will be assigned.
                  example: SFCC01
                feeModelID:
                  type: string
                  description: The unique ID of the fee model to be assigned.
                  example: FEE01
      responses:
        '200':
          description: ok
          content:
            application/json:
              schema:
                type: object
                example: {}
        '400':
          description: Invalid request parameters.
        '401':
          description: Unauthorized access.
        '500':
          description: Internal server error.
      tags:
      - Fee
    servers:
    - url: https://stage1.tab.kitecash.in/cc-open-api/falcon/v1
  /fee:
    post:
      security:
      - bearerAuth: []
      summary: Add a Fee Model
      description: Use this endpoint to create a new fee model with configurations approved by issuer.
      operationId: add-fee-model
      parameters:
      - name: x-tenant-id
        in: header
        required: true
        schema:
          type: string
          example: falcon
      - name: Authorization
        in: header
        required: true
        schema:
          type: string
          example: Bearer {{access_token}}
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - feeModelID
              - feeModelName
              - cardType
              - cardCategory
              - cardSubCategory
              - cardProduct
              - cardBrand
              - cardNetwork
              properties:
                revolvingInterestRate:
                  type: string
                  description: Revolving interest rate for the card
                  example: 3.5%
                joiningFee:
                  type: integer
                  description: Joining fee for the card
                  example: 500
                annualFee:
                  type: integer
                  description: Annual fee of the card
                  example: 1000
                penalFee:
                  type: integer
                  description: Penal fee of the card
                  example: 200
                penalInterestRate:
                  type: string
                  description: Penal interest rate of the card
                  example: 2.5%
                cardReplacementFee:
                  type: string
                  description: Card replacement fee
                  example: '100'
                cashAdvanceFee:
                  type: string
                  description: Cash advance fee
                  example: 2%
                cashAdvanceInterestRate:
                  type: string
                  description: Cash advance interest rate
                  example: 3%
                latePaymentFee:
                  type: string
                  description: Late payment fee
                  example: '500'
                gst:
                  type: string
                  description: GST applicable on fees
                  example: 18%
      responses:
        '200':
          description: ok
          content:
            application/json:
              schema:
                type: object
                example: {}
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
      tags:
      - Fee
    servers:
    - url: https://stage1.tab.kitecash.in/cc-open-api/falcon/v1
  /fee/post-fee:
    post:
      security:
      - bearerAuth: []
      summary: Post a Pending Fee
      description: Use this endpoint to post fee which is yet to be posted. This is only relevant for account closure purpose. Once this is posted, it should not be posted again for that reason. For example, If it is a overlimit fee which is to be charged once a month, it can only be charged in the next month if for any reason account is still not closed.
      operationId: post-pending-fee
      parameters:
      - name: x-tenant-id
        in: header
        required: true
        schema:
          type: string
          example: falcon
      - name: Authorization
        in: header
        required: true
        schema:
          type: string
          example: Bearer {{access_token}}
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - accountId
              properties:
                accountId:
                  type: string
                  description: ID of the account to be posted.
                  example: '202000004782'
      responses:
        '200':
          description: ok
          content:
            application/json:
              schema:
                type: object
                properties:
                  feetype:
                    type: string
                    description: Type of the fee posted
                    example: type
                  feeamount:
                    type: integer
                    description: Amount of the posted fee
                    example: 1000
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
      tags:
      - Fee
    servers:
    - url: https://stage1.tab.kitecash.in/cc-open-api/falcon/v1
  /fee/reverse:
    post:
      security:
      - bearerAuth: []
      summary: Reverse a Fee
      description: Use this endpoint to reverse either an already posted fee or interest, or post a fee or interest credit to an account.
      operationId: reverse-fee
      parameters:
      - name: x-tenant-id
        in: header
        required: true
        schema:
          type: string
          example: falcon
      - name: Authorization
        in: header
        required: true
        schema:
          type: string
          example: Bearer {{access_token}}
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - accountId
              - feeType
              - amount
              - narration
              properties:
                accountId:
                  type: string
                  description: ID of the account to be credited.
                  example: '202000004782'
                feeType:
                  type: string
                  description: Type of fee to be credited.
                  example: Reward Redemption Fee
                amount:
                  type: string
                  description: Amount to be credited.
                  example: '200'
                narration:
                  type: string
                  description: Narration for the fee.
                  example: Fees on cash advance
      responses:
        '200':
          description: ok
          content:
            application/json:
              schema:
                type: object
                example: {}
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
      tags:
      - Fee
    servers:
    - url: https://stage1.tab.kitecash.in/cc-open-api/falcon/v1
  /fee/{accountId}:
    get:
      security:
      - bearerAuth: []
      summary: View Yet to be Posted Fee
      description: Use this endpoint to view fees that should be charged if a customer requests for account closure.
      operationId: get-yet-to-be-posted-fee
      parameters:
      - name: x-tenant-id
        in: header
        required: true
        schema:
          type: string
          example: falcon
      - name: Authorization
        in: header
        required: true
        schema:
          type: string
          example: Bearer {{access_token}}
      - name: accountId
        in: path
        required: true
        schema:
          type: string
          description: ID of the account to be fetched.
          example: '202000004782'
      responses:
        '200':
          description: ok
          content:
            application/json:
              schema:
                type: object
                properties:
                  feetype:
                    type: string
                    description: Type of fee applicable.
                    example: Annual Fee
                  feeamount:
                    type: number
                    description: Amount of fee applicable.
                    example: 1000
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
      tags:
      - Fee
    servers:
    - url: https://stage1.tab.kitecash.in/cc-open-api/falcon/v1
  /fee/{feeModelID}:
    get:
      security:
      - bearerAuth: []
      summary: View a Fee Model
      description: Use this endpoint to fetch details of fees and charges in a particular fee model.
      operationId: get-fee-model
      parameters:
      - name: feeModelID
        in: path
        required: true
        schema:
          type: string
          description: ID of the fee model to be fetched.
          example: '12345'
      - name: x-tenant-id
        in: header
        required: true
        schema:
          type: string
          example: falcon
      - name: Authorization
        in: header
        required: true
        schema:
          type: string
          example: Bearer {{access_token}}
      responses:
        '200':
          description: ok
          content:
            application/json:
              schema:
                type: object
                properties:
                  feeModelID:
                    type: string
                    description: ID of the fee model
                    example: '12345'
                  revolvingInterestRate:
                    type: string
                    description: Revolving interest rate for the card
                    example: 3.5%
                  joiningFee:
                    type: integer
                    description: Joining fee for the card
                    example: 500
                  annualFee:
                    type: integer
                    description: Annual fee of the card
                    example: 1000
                  penalFee:
                    type: integer
                    description: Penal fee of the card
                    example: 200
                  penalInterestRate:
                    type: string
                    description: Penal interest rate of the card
                    example: 2.5%
                  cardReplacementFee:
                    type: string
                    description: Card replacement fee
                    example: '100'
                  cashAdvanceFee:
                    type: string
                    description: Cash advance fee
                    example: 2%
                  cashAdvanceInterestRate:
                    type: string
                    description: Cash advance interest rate
                    example: 3%
                  latePaymentFee:
                    type: string
                    description: Late payment fee
                    example: '500'
                  gst:
                    type: string
                    description: GST applicable on fees
                    example: 18%
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
      tags:
      - Fee
    servers:
    - url: https://stage1.tab.kitecash.in/cc-open-api/falcon/v1
x-refined-from:
- falcon-assign-a-fee-model-to-a-program-openapi.yml
- falcon-fee-apis-openapi.yml
x-provenance:
  method: searched
  source: https://docs.falconfs.com/reference
  harvested: '2026-10-14'
  tool: harvest-readme-openapi.py
  note: Assembled verbatim from the OpenAPI definition ReadMe embeds in each operation page of the provider's developer portal; paths and components merged by API title, nothing authored.
  assembled_from:
  - https://docs.falconfs.com/reference/add-program.md
  merge:
    pages: 1
    deduped: 0
    conflicts_kept_first: 0