# Create a fee collection transaction

Creates a fee transaction on the account specified in the URL. Solaris will debit the amount from the customer's account and transfer the funds to a Solaris settlement account. Each month, Solaris will pay out the amounts collected from fee transactions to your partner account.

Endpoint: POST /v1/accounts/{account_id}/transactions/fees
Version: 1.0

## Path parameters:

  - `account_id` (string, required)

## Request fields (application/json):

  - `type` (string, required)
    The type of fee. Note that you may only collect the types of fees that have been enabled for you.
    Enum: "ChargeATM", "ChargeATMForeignCurrency", "CashDepositRetail", "CashWithdrawalRetail", "ChargeCardDelivery", "ChargeCard", "ChargeVirtualCard", "ChargeReissuePhysicalCard", "ChargeAdditionalPhysicalCard", "ChargeAdditionalVirtualCard", "ChargeReissueVirtualCard", "ChargeCardMaintenance", "BoosterPackage", "ChargeAccountMaintenance", "ChargeTopUpCard", "ChargeAdditionalAccountMaintenance", "ChargeSharedAccount", "ChargeAuthorizedUser", "ChargeGamblingTransactionPartner", "ChargeSEPAInstantOutgoing", "ChargeSEPAInstantIncoming", "ChargeManualSepaTransferPartner", "ChargeIncomingSwift", "ChargeGamblingOrCashEquivalent", "ChargeFXCardTransaction"

  - `amount` (object, required)
    The amount of the fee transaction.
    Example: {"value":499,"currency":"EUR"}

  - `amount.value` (integer, required)
    The value of the fee, in Euro cents.
    Example: 499

  - `amount.currency` (string, required)
    The currency of the fee. Only EUR is currently supported.
    Example: "EUR"

  - `original_transaction_id` (string)
    Optional ID to be provided for fee types that relate to or are charged for individual transactions. In this case, you would provide the ID of the booking linked to the transaction.

  - `initiator_reference` (string)
    Optional reference for the fee transaction to be populated by you.
    Example: "2022_08_acc_maint"

  - `idempotency_key` (string)
    Optional idempotency key to be used when creating the fee transaction.
    Example: "653e91ae-7e93-4106-a33c-00607dae851e"

  - `valuta_date` (string)
    Optional valuta date provided by client. If both 'original_transaction_id' and 'valuta_date' are provided in the request payload, the provided valuta_data will be used.
    Example: "2023-06-01"

## Response 201 fields (application/json):

  - `type` (string)
    The type of fee. Note that you may only collect the types of fees that have been enabled for you.
    Example: "ChargeAccountMaintenance"

  - `amount` (object)
    The amount of the fee transaction.

  - `amount.value` (integer)
    Example: 499

  - `amount.currency` (string)
    Example: "EUR"

  - `reconciliation_id` (string)
    An ID linking a fee transaction to an account booking for reconciliation.
    Example: "938cfdf93ef54bdcbd4e955584da3bf0fct"

  - `initiator_reference` (string)
    Optional reference for the fee transaction to be populated by you.
    Example: "2022_08_acct_maint"

  - `original_transaction_id` (string)
    Optional ID to be provided for fee types that relate to or are charged for individual transactions. In this case, you would provide the ID of the booking linked to the transaction.
    Example: "6d4659e500ef4b10aa48d6b08d0d3e7b"

  - `solaris_initiated` (boolean)
    A field to indicate whether the fee transaction solaris initiated or not.

  - `valuta_date` (string)
    Optional valuta date provided by client. If both 'original_transaction_id' and 'valuta_date' are provided in the request payload, the provided valuta_data will be used.
    Example: "2023-06-01"

## Response 400 fields (application/json):

  - `id` (string)
    Example: "a95f2aaf-4e0c-4d49-8021-8a16a884ed86"

  - `code` (string)
    Example: "invalid_request"

  - `title` (string)
    Example: "Invalid Request"

  - `details` (string)
    Example: "Request is invalid"

## Response 403 fields (application/json):

  - `id` (string)
    Example: "a95f2aaf-4e0c-4d49-8021-8a16a884ed86"

  - `code` (string)
    Example: "unauthorized_action"

  - `title` (string)
    Example: "Unauthorized Action"

  - `details` (string)
    Example: "Unauthorized action is not allowed."

## Response 404 fields (application/json):

  - `id` (string)
    Example: "a95f2aaf-4e0c-4d49-8021-8a16a884ed86"

  - `code` (string)
    Example: "model_not_found"

  - `title` (string)
    Example: "Model Not Found"

  - `details` (string)
    Example: "Model was not found"

## Response 500 fields (application/json):

  - `id` (string)
    Example: "a95f2aaf-4e0c-4d49-8021-8a16a884ed86"

  - `code` (string)
    Example: "generic_error"

  - `title` (string)
    Example: "Internal Server Error"

  - `details` (string)
    Example: "Internal server error occurred"