Skip to main content
API docs by Redocly

Fees Manager API (v1)

Download OpenAPI specification:Download

API for manage rules to apply fees (v1.155.0)

Diagnostics

GetDiagnosticsInfo

Get current platform diagnostics data

Responses

Response samples

Content type
{
  • "applicationName": "string",
  • "applicationVersion": "string",
  • "environment": "string",
  • "properties": {
    }
}

Playground

CalculateFees

Calculates fees for provided operation details

Request Body schema:
required

Request with operation details

partnerKey
required
string non-empty

Key of partner where fee should be calculated

dealerKey
required
string or null

Key of dealer where fee should be calculated

operationType
required
string non-empty

Operation type

storeId
required
string or null <uuid>

Optional store identifier

amount
required
number <double> >= 0

Amount of operation

operationDate
required
string <date-time>

Date/time of operation initialization

required
object or null

Tags associated to the operation

Responses

Request samples

Content type
{
  • "partnerKey": "PARTNER_KEY",
  • "dealerKey": "DEALER_KEY",
  • "operationType": "CashDeposit",
  • "storeId": "d4c3b2a1-6f5e-0987-dcba-0123456789ab",
  • "amount": 100,
  • "operationDate": "2026-01-16T11:30:00+01:00",
  • "tags": {
    }
}

Response samples

Content type
{
  • "operationAmount": 100,
  • "feesOnBeneficiaries": [
    ]
}

ExplainCalculation

Executes calculation of fees using provided operation details and provides explanation for each rule evaluated during calculation process

Request Body schema:
required

Request with operation details

partnerKey
required
string non-empty

Key of partner where fee should be calculated

dealerKey
required
string or null

Key of dealer where fee should be calculated

operationType
required
string non-empty

Operation type

storeId
required
string or null <uuid>

Optional store identifier

amount
required
number <double> >= 0

Amount of operation

operationDate
required
string <date-time>

Date/time of operation initialization

required
object or null

Tags associated to the operation

Responses

Request samples

Content type
{
  • "partnerKey": "PARTNER_KEY",
  • "dealerKey": "DEALER_KEY",
  • "operationType": "CashDeposit",
  • "storeId": "d4c3b2a1-6f5e-0987-dcba-0123456789ab",
  • "amount": 100,
  • "operationDate": "2026-01-16T11:30:00+01:00",
  • "tags": {
    }
}

Response samples

Content type
{
  • "operationAmount": 100,
  • "feesByBeneficiary": [
    ],
  • "processedRuleResults": [
    ]
}

Rules

GetAllFeeRules

Returns a list of all fee rules available on authenticated partner

query Parameters
fromDate
string <date-time>
toDate
string <date-time>
pageSize
integer <int32>
Default: 50
pageNumber
integer <int32>
Default: 0

Responses

Response samples

Content type
{
  • "totalCount": 2,
  • "limitCount": null,
  • "items": [
    ]
}

CreateFeeRule

Creates a new rule, on partner, dealer or store, using provided data, that apply fee on single operation type

Request Body schema:
required

Request containing the rule data

operationType
required
string non-empty

Operation type associated with the rule

beneficiary
required
string non-empty

Code of beneficiary that will get the fees added by this rule (Ex. FLOWE, PARTNER, DEALER)

debtor
required
string non-empty

Entity that will pay the fee. Values: Customer, Store, Dealer, Partner, Flowe

code
required
string non-empty

Unique code of the rule (should never change)

dealerKey
required
string or null

Key of the dealer where the rule is active

storeId
required
string or null <uuid>

Store where the rule is active

name
required
string non-empty

Short description of the rule

description
required
string non-empty

More extended description of the rule

startValidity
required
string or null <date-time>

The date from which the rule is active; if null, rule was always valid

endValidity
required
string or null <date-time>

The date until which the rule is active; if null, rule will be always valid

minOperationAmount
required
number or null <double>

Minum amount of single operation that activates the rule. Ex1. Deposit operation: 15 eur, Rule with MinOperationAmount 10 eur => Rule Active. Ex2. Deposit operation: 15 euro, Rule with MinOperationAmount 20 eur => Rule Skipped

maxOperationAmount
required
number or null <double>

Maximum amount of single operation that activates the rule. Ex1. Deposit operation: 15 eur, Rule with MaxOperationAmount 10 eur => Rule Skipped. Ex2. Deposit operation: 15 euro, Rule with MaxOperationAmount 20 eur => Rule Active

minPartnerOperationsCount
required
integer or null <int32>

Minimum count of operations complete on partner that activates the rule. Ex. Fingroove with 1500 operations, Rule with 1000 MinPartnerOperationsCount => Rule Active

maxPartnerOperationsCount
required
integer or null <int32>

Maximum count of operations complete on partner that activates the rule. Ex. Fingroove with 1500 operations, Rule with 2000 MaxPartnerOperationsCount => Rule Active

calculationType
required
string non-empty

Type of calculation that is used for current rule (sum fixed, sum percentage, override fixed, ect)

calculationPrimaryValue
required
number <double> >= 0

Value used for calculation. This value rapresents fixed amount summed to fees, or percentage of operation than has overriden total fees, etc.

required
object

Tag associated with the rule

isRoundDown
required
boolean

Indicates whether the fee calculated for this rule must be rounded down (if true) or rounded up (if false as by default).

Responses

Request samples

Content type
{
  • "operationType": "CashDeposit",
  • "beneficiary": "PARTNER",
  • "debtor": "Customer",
  • "code": "QGM-GM-CD-PA-01",
  • "dealerKey": "DEALER_KEY",
  • "storeId": "d4c3b2a1-6f5e-0987-dcba-0123456789ab",
  • "name": "[PARTNER_KEY/DEALER_KEY] CashDeposit (Partner)",
  • "description": "Cash Deposit Fee for Partner",
  • "startValidity": "2026-01-10T11:30:00+01:00",
  • "endValidity": null,
  • "minOperationAmount": 1,
  • "maxOperationAmount": 200,
  • "minPartnerOperationsCount": 0,
  • "maxPartnerOperationsCount": 5000,
  • "calculationType": "FixedAmount",
  • "calculationPrimaryValue": 0.5,
  • "tag": {
    },
  • "isRoundDown": false
}

Response samples

Content type
{
  • "ruleId": "b1a2c3d4-e5f6-7890-abcd-ef1234567890",
  • "partnerKey": "PARTNER_KEY",
  • "operationType": "CashDeposit",
  • "beneficiary": "PARTNER",
  • "debtor": "Customer",
  • "code": "QGM-GM-CD-PA-01",
  • "dealerKey": "DEALER_KEY",
  • "storeId": "d4c3b2a1-6f5e-0987-dcba-0123456789ab",
  • "name": "[PARTNER_KEY/DEALER_KEY] CashDeposit (Partner)",
  • "description": "Cash Deposit Fee for Partner",
  • "startValidity": "2026-01-10T11:30:00+01:00",
  • "endValidity": null,
  • "minOperationAmount": 1,
  • "maxOperationAmount": 200,
  • "minPartnerOperationsCount": 0,
  • "maxPartnerOperationsCount": 5000,
  • "calculationType": "FixedAmount",
  • "calculationPrimaryValue": 0.5,
  • "creationDate": "2026-01-10T11:30:00+01:00",
  • "lastUpdateDate": "2026-01-10T11:30:00+01:00",
  • "tag": {
    },
  • "isRoundDown": false
}

GetDealerRules

Returns a list of all fee rules available on authenticated partner for a given dealer

path Parameters
dealerKey
required
string

Dealer identifier

Responses

Response samples

Content type
[
  • {
    },
  • {
    }
]

GetStoreRules

Returns a list of all fee rules available on authenticated partner for a given dealer

path Parameters
dealerKey
required
string

Dealer identifier

storeId
required
string <uuid>

Store identifier

Responses

Response samples

Content type
[
  • {
    },
  • {
    }
]

GetFeeRule

Returns a single fee rule existing on storage

path Parameters
ruleId
required
string <uuid>

Fee rule identifier

Responses

Response samples

Content type
{
  • "ruleId": "b1a2c3d4-e5f6-7890-abcd-ef1234567890",
  • "partnerKey": "PARTNER_KEY",
  • "operationType": "CashDeposit",
  • "beneficiary": "PARTNER",
  • "debtor": "Customer",
  • "code": "QGM-GM-CD-PA-01",
  • "dealerKey": "DEALER_KEY",
  • "storeId": "d4c3b2a1-6f5e-0987-dcba-0123456789ab",
  • "name": "[PARTNER_KEY/DEALER_KEY] CashDeposit (Partner)",
  • "description": "Cash Deposit Fee for Partner",
  • "startValidity": "2026-01-10T11:30:00+01:00",
  • "endValidity": null,
  • "minOperationAmount": 1,
  • "maxOperationAmount": 200,
  • "minPartnerOperationsCount": 0,
  • "maxPartnerOperationsCount": 5000,
  • "calculationType": "FixedAmount",
  • "calculationPrimaryValue": 0.5,
  • "creationDate": "2026-01-10T11:30:00+01:00",
  • "lastUpdateDate": "2026-01-10T11:30:00+01:00",
  • "tag": {
    },
  • "isRoundDown": false
}

UpdateFeeRule

Updates a existing rule, on partner, dealer or store, using provided data, that apply fee on single operation type

path Parameters
ruleId
required
string <uuid>

Fee rule identifier

Request Body schema:
required

Request containing the rule data

name
required
string non-empty

Short description of the rule

description
required
string non-empty

More extended description of the rule

debtor
required
string non-empty

Entity that will pay the fee. Values: Customer, Store, Dealer, Partner, Flowe

beneficiary
required
string non-empty

Entity that will receive the fee. Values: FLOWE, PARTNER, DEALER

startValidity
required
string or null <date-time>

The date from which the rule is active; if null, rule was always valid

endValidity
required
string or null <date-time>

The date until which the rule is active; if null, rule will be always valid

minOperationAmount
required
number or null <double>

Minum amount of single operation that activates the rule. Ex1. Deposit operation: 15 eur, Rule with MinOperationAmount 10 eur => Rule Active. Ex2. Deposit operation: 15 euro, Rule with MinOperationAmount 20 eur => Rule Skipped

maxOperationAmount
required
number or null <double>

Maximum amount of single operation that activates the rule. Ex1. Deposit operation: 15 eur, Rule with MaxOperationAmount 10 eur => Rule Skipped. Ex2. Deposit operation: 15 euro, Rule with MaxOperationAmount 20 eur => Rule Active

minPartnerOperationsCount
required
integer or null <int32>

Minimum count of operations complete on partner that activates the rule. Ex. Fingroove with 1500 operations, Rule with 1000 MinPartnerOperationsCount => Rule Active

maxPartnerOperationsCount
required
integer or null <int32>

Maximum count of operations complete on partner that activates the rule. Ex. Fingroove with 1500 operations, Rule with 2000 MaxPartnerOperationsCount => Rule Active

calculationType
required
string non-empty

Type of calculation that is used for current rule (sum fixed, sum percentage, override fixed, ect)

calculationPrimaryValue
required
number <double> >= 0

Value used for calculation. This value rapresents fixed amount summed to fees, or percentage of operation than has overriden total fees, etc.

required
object

Tag associated with the rule

isRoundDown
required
boolean

Indicates whether the fee calculated for this rule must be rounded down (if true) or rounded up (if false as by default).

Responses

Request samples

Content type
{
  • "name": "[PARTNER_KEY/DEALER_KEY] CashDeposit (Partner)",
  • "description": "Cash Deposit Fee for Partner",
  • "debtor": "Customer",
  • "beneficiary": "PARTNER",
  • "startValidity": "2026-01-10T11:30:00+01:00",
  • "endValidity": null,
  • "minOperationAmount": 1,
  • "maxOperationAmount": 200,
  • "minPartnerOperationsCount": 0,
  • "maxPartnerOperationsCount": 5000,
  • "calculationType": "FixedAmount",
  • "calculationPrimaryValue": 0.5,
  • "tag": {
    },
  • "isRoundDown": false
}

Response samples

Content type
{
  • "ruleId": "b1a2c3d4-e5f6-7890-abcd-ef1234567890",
  • "partnerKey": "PARTNER_KEY",
  • "operationType": "CashDeposit",
  • "beneficiary": "PARTNER",
  • "debtor": "Customer",
  • "code": "QGM-GM-CD-PA-01",
  • "dealerKey": "DEALER_KEY",
  • "storeId": "d4c3b2a1-6f5e-0987-dcba-0123456789ab",
  • "name": "[PARTNER_KEY/DEALER_KEY] CashDeposit (Partner)",
  • "description": "Cash Deposit Fee for Partner",
  • "startValidity": "2026-01-10T11:30:00+01:00",
  • "endValidity": null,
  • "minOperationAmount": 1,
  • "maxOperationAmount": 200,
  • "minPartnerOperationsCount": 0,
  • "maxPartnerOperationsCount": 5000,
  • "calculationType": "FixedAmount",
  • "calculationPrimaryValue": 0.5,
  • "creationDate": "2026-01-10T11:30:00+01:00",
  • "lastUpdateDate": "2026-01-10T11:30:00+01:00",
  • "tag": {
    },
  • "isRoundDown": false
}

DeleteFeeRule

Deletes an existing fee rule

path Parameters
ruleId
required
string <uuid>

Identifier of the rule to delete

Responses

Response samples

Content type
{
  • "ruleId": "b1a2c3d4-e5f6-7890-abcd-ef1234567890",
  • "partnerKey": "PARTNER_KEY",
  • "operationType": "CashDeposit",
  • "beneficiary": "PARTNER",
  • "debtor": "Customer",
  • "code": "QGM-GM-CD-PA-01",
  • "dealerKey": "DEALER_KEY",
  • "storeId": "d4c3b2a1-6f5e-0987-dcba-0123456789ab",
  • "name": "[PARTNER_KEY/DEALER_KEY] CashDeposit (Partner)",
  • "description": "Cash Deposit Fee for Partner",
  • "startValidity": "2026-01-10T11:30:00+01:00",
  • "endValidity": null,
  • "minOperationAmount": 1,
  • "maxOperationAmount": 200,
  • "minPartnerOperationsCount": 0,
  • "maxPartnerOperationsCount": 5000,
  • "calculationType": "FixedAmount",
  • "calculationPrimaryValue": 0.5,
  • "creationDate": "2026-01-10T11:30:00+01:00",
  • "lastUpdateDate": "2026-01-10T11:30:00+01:00",
  • "tag": {
    },
  • "isRoundDown": false
}

SwapFeeRulePriorities

Swaps the execution priority between two rules

path Parameters
firstRuleId
required
string <uuid>

First fee rule identifier

secondRuleId
required
string <uuid>

Second fee rule identifier

Responses

Response samples

Content type
{
  • "errorCode": "string",
  • "errorDescription": "string",
  • "errorProperties": {
    }
}