riverty logo

Docs

Parking Fee Information

Riverty Provides two different methods to indicate how much a parking customer should pay. No matter which method is used, Riverty will pay the entire amount of the invoice upfront. Riverty provides daily or weekly settlements depending on contract and country.

Standard Fees

Riverty provides the MerchantFee endpoint to allow merchants to charge a standard fee across of all invoices. This a convenient way of charging fees through Riverty, but is not required if a Parking Provider prefers to transfer fee information through individual Receivable requests. The Standard Fee can be set to begin and end by date based on seasonality, large events, or other factors.

{
  "currencyValue": "5.00",
  "taxAmount": "6.00",
  "taxRate": "20",
  "taxLabel": [
    {
      "languageCode": "en",
      "value": "VAT"
    }
  ],
  "description": [
    {
      "languageCode": "en",
      "value": "Parking Free for Riverty Shopping Mall"
    }
  ],
  "validFrom": "1.1.2023",
  "validTo": "31.12.2023",
  "feeType": "Fee"
}

Recievable Request Line Items

Individual line items can also be added to invoices via the Post Recievable request using the “segments” key. This method can be used in abscence of, or in combination with, the MerchantFee endpoint. Meaning a parking consumer may be charged the Standard Parking Fee via the MerchantFee and an “Overnight” parking fee via the Recievable Request.

"segments": [
        {
          "actualStart": "28.09.2023 13:09,
          "actualEnd": "29.09.2023 11:25",
          "assignedRight": {
            "id": "string",
            "name": [
              {
                "languageCode": "en",
                "value": "Overnight Parking"
              }
            ],
            "monetaryValue": {
              "value": {
                "currencyValue": "110.00",
                "currencyType": "NOK"
              },
              "taxIncluded": true,
              "taxLines": [
                {
                  "taxLabel": [
                    {
                      "languageCode": "en",
                      "value": "VAT"
                    }
                  ],
                  "taxRate": "10",
                  "taxAmount": "10"
                }
              ],
              "feeType": "Fee"
            }
          }