Fee model

The Pismo platform allows you to define dynamic fee models and apply them to your operations. A fee model is a structure that defines a collection of fees with custom calculations. You can define the method used to calculate the fee, using a fixed value or a percentage.

Processing codes

Once a fee model is created, you can apply it to financial operations within an organization , program, or account based on processing codes, which identify an operation, such as purchases or debits. Each financial operation within the platform has its processing code. Some you can configure, while others are fixed in the card network flow. Talk to your Pismo representative to get, or create, processing codes.

📘

Note that If the operation doesn't match the defined processing codes, the fee is ignored.

Example fee model

In the following example, the fee model structure defines:

  • A fee with the greater calculation method with an additional fixed value fee to be applied to processing codes 02 and 0040,
  • A fee with the percentage calculation method to be applied to processing codes 0100 and 0020.

📘

Fee IDs

The fee id fields are used by the Pismo transaction team to make accounting entries. Talk to your Pismo representative about getting fee IDs for your operations.

Example fee model payload
{
     "calculation_basis": "PRINCIPAL_AMOUNT",
     "model_description": "Fee model applied to org",
     "fees": [
          {
               "description": "Fee wdl",
               "type": "sellos",
               "id": "dom_wdl",
               "calculation": {
                    "calculation_method": "GREATER",
                    "fixed": 30,
                    "percentage": 2.5
               },
               "filters": {
                    "processing_codes": [
                         "02",
                         "0040"
                    ]
               },
               "additional_fees": [
                    {
                         "description": "Foreign currency fixed surcharge",
                         "type": "sellos",
                         "id": "a_wdl",
                         "calculation_method": "FIXED",
                         "value": 10
                    }
               ]
          }
          {
               "description": "Fee abc",
               "type": "sellos",
               "id": "a_abc",
               "calculation": {
                    "calculation_method": "PERCENTAGE",
                    "value": 0.5
               },
               "filters": {
                    "processing_codes": [
                         "0100",
                         "0020"
                    ]
               }
          } 
     ]
}

Accumulator fee model

The accumulator fee model collects totals based on specified transaction types and applies fees on a scheduled basis. It is a special case in that you have to call the Create accumulator configuration endpoint to get an identifier for the configuration you can use when creating an accumulator fee model.