Sign in
Fee collection

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.

post/v1/accounts/{account_id}/transactions/fees

Path parameters

account_idstring required

Request body

type'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' required

The type of fee. Note that you may only collect the types of fees that have been enabled for you.

original_transaction_idstring

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_referencestring

Optional reference for the fee transaction to be populated by you.

idempotency_keystring

Optional idempotency key to be used when creating the fee transaction.

valuta_datestring

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 request

{
  "type": "ChargeAccountMaintenance",
  "amount": {
    "value": 499,
    "currency": "EUR"
  },
  "initiator_reference": "2022_08_acc_maint",
  "idempotency_key": "653e91ae-7e93-4106-a33c-00607dae851e"
}

Response

The operation was successful.

typestring

The type of fee. Note that you may only collect the types of fees that have been enabled for you.

reconciliation_idstring

An ID linking a fee transaction to an account booking for reconciliation.

initiator_referencestring

Optional reference for the fee transaction to be populated by you.

original_transaction_idstring

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.

solaris_initiatedboolean

A field to indicate whether the fee transaction solaris initiated or not.

valuta_datestring

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 response

{
  "type": "ChargeAccountMaintenance",
  "amount": {
    "value": 499,
    "currency": "EUR"
  },
  "reconciliation_id": "938cfdf93ef54bdcbd4e955584da3bf0fct",
  "initiator_reference": "2022_08_acct_maint",
  "original_transaction_id": "6d4659e500ef4b10aa48d6b08d0d3e7b",
  "valuta_date": "2023-06-01"
}