PMC API Mobile payments v1.1

General notes

The PMC API is designed to facilitate the payment of short-term parking fees via mobile applications from third parties. This API enables payment transactions through a central server connected to the PMC, supporting multiple parking facilities. However, it’s essential that each parking facility is compatible with this payment system. Parking spots are identified using the query parameter gmtpId, which contains the installation number.

The usage of this API is outlined in four main steps:

  1. Identification of the parking card based on available parking card identification.

  2. Calculation of the payment amount according to the parking duration and the time until which the payment is required.

  3. Creation of a receipt for the amount paid.

  4. Marking the parking card as paid to finalize the transaction.

For effective use, it’s crucial to follow these steps in sequence to ensure the transaction is correctly processed. This structured approach guarantees a seamless experience for both parking providers and users, making it a versatile solution for integrating parking payment systems into third-party mobile applications.

API detail

CARD INFO

In this section you can find all the variants of Get card info request.

Card Info CardNumber

Authorization: KERNEL_CARDS

curl -X GET -H "Accept: application/json" "{{APIUrl}}/v1/kernel/cards?cardNumber={{cardNumber}}&gmtpId={{gmtpId}}"
GET %7B%7BAPIUrl%7D%7D/v1/kernel/cards?cardNumber={{cardNumber}}&gmtpId={{gmtpId}} HTTP/1.1
Host: 
Accept: application/json
Status 200 OK
Content-Type application/json 
[
    {
        "accessId": "",
        "idCard": "",
        "number": "",
        "validFrom": "",
        "validTill": "",
        "entryTime": "",
        "exitTime": "",
        "entryType": "",
        "credit": "",
        "valid": "",
        "blocked": "",
        "cardNotice": "",
        "zoneId": "",
        "reservationId": "",
        "ownerId": "",
        "createdBy": "",
        "createdWhen": "",
        "invalidatedBy": "",
        "invalidatedWhen": "",
        "timeMark": "",
        "initialCredit": "",
        "blocations": [
            {
                "cardId": "",
                "reason": "",
                "blockedWhen": "",
                "blockedBy": "",
                "blockType": ""
            },
            {
                "cardId": "",
                "reason": "",
                "blockedWhen": "",
                "blockedBy": "",
                "blockType": ""
            }
        ],
        "aliases": [
            "",
            ""
        ],
        "lpns": [
            "",
            ""
        ],
        "tokens": [
            "",
            ""
        ],
        "zones": [
            "",
            ""
        ],
        "cardGroups": [
            "",
            ""
        ],
        "barCode": "",
        "qrCode": "",
        "pin": ""
    },
    {
        "accessId": "",
        "idCard": "",
        "number": "",
        "validFrom": "",
        "validTill": "",
        "entryTime": "",
        "exitTime": "",
        "entryType": "",
        "credit": "",
        "valid": "",
        "blocked": "",
        "cardNotice": "",
        "zoneId": "",
        "reservationId": "",
        "ownerId": "",
        "createdBy": "",
        "createdWhen": "",
        "invalidatedBy": "",
        "invalidatedWhen": "",
        "timeMark": "",
        "initialCredit": "",
        "blocations": [
            {
                "cardId": "",
                "reason": "",
                "blockedWhen": "",
                "blockedBy": "",
                "blockType": ""
            },
            {
                "cardId": "",
                "reason": "",
                "blockedWhen": "",
                "blockedBy": "",
                "blockType": ""
            }
        ],
        "aliases": [
            "",
            ""
        ],
        "lpns": [
            "",
            ""
        ],
        "tokens": [
            "",
            ""
        ],
        "zones": [
            "",
            ""
        ],
        "cardGroups": [
            "",
            ""
        ],
        "barCode": "",
        "qrCode": "",
        "pin": ""
    }
]
Status 400 Bad Request
Status 403 Forbidden
Status 500 Internal Server Error

Card Info SEARCH

Authorization: KERNEL_CARDS

curl -X GET -H "Accept: application/json" "{{APIUrl}}/v1/kernel/cards?search={{cardNumberShort}}&gmtpId={{gmtpId}}"
GET %7B%7BAPIUrl%7D%7D/v1/kernel/cards?search={{cardNumberShort}}&gmtpId={{gmtpId}} HTTP/1.1
Host: 
Accept: application/json
Status 200 OK
Content-Type application/json 
[
    {
        "accessId": "",
        "idCard": "",
        "number": "",
        "validFrom": "",
        "validTill": "",
        "entryTime": "",
        "exitTime": "",
        "entryType": "",
        "credit": "",
        "valid": "",
        "blocked": "",
        "cardNotice": "",
        "zoneId": "",
        "reservationId": "",
        "ownerId": "",
        "createdBy": "",
        "createdWhen": "",
        "invalidatedBy": "",
        "invalidatedWhen": "",
        "timeMark": "",
        "initialCredit": "",
        "blocations": [
            {
                "cardId": "",
                "reason": "",
                "blockedWhen": "",
                "blockedBy": "",
                "blockType": ""
            },
            {
                "cardId": "",
                "reason": "",
                "blockedWhen": "",
                "blockedBy": "",
                "blockType": ""
            }
        ],
        "aliases": [
            "",
            ""
        ],
        "lpns": [
            "",
            ""
        ],
        "tokens": [
            "",
            ""
        ],
        "zones": [
            "",
            ""
        ],
        "cardGroups": [
            "",
            ""
        ],
        "barCode": "",
        "qrCode": "",
        "pin": ""
    },
    {
        "accessId": "",
        "idCard": "",
        "number": "",
        "validFrom": "",
        "validTill": "",
        "entryTime": "",
        "exitTime": "",
        "entryType": "",
        "credit": "",
        "valid": "",
        "blocked": "",
        "cardNotice": "",
        "zoneId": "",
        "reservationId": "",
        "ownerId": "",
        "createdBy": "",
        "createdWhen": "",
        "invalidatedBy": "",
        "invalidatedWhen": "",
        "timeMark": "",
        "initialCredit": "",
        "blocations": [
            {
                "cardId": "",
                "reason": "",
                "blockedWhen": "",
                "blockedBy": "",
                "blockType": ""
            },
            {
                "cardId": "",
                "reason": "",
                "blockedWhen": "",
                "blockedBy": "",
                "blockType": ""
            }
        ],
        "aliases": [
            "",
            ""
        ],
        "lpns": [
            "",
            ""
        ],
        "tokens": [
            "",
            ""
        ],
        "zones": [
            "",
            ""
        ],
        "cardGroups": [
            "",
            ""
        ],
        "barCode": "",
        "qrCode": "",
        "pin": ""
    }
]
Status 400 Bad Request
Status 403 Forbidden
Status 500 Internal Server Error

Card Info QR

Authorization: KERNEL_CARDS

curl -X GET -H "Accept: application/json" "{{APIUrl}}/v1/kernel/cards?qrCode={{cardQRcode}}&gmtpId={{gmtpId}}"
GET %7B%7BAPIUrl%7D%7D/v1/kernel/cards?qrCode={{cardQRcode}}&gmtpId={{gmtpId}} HTTP/1.1
Host: 
Accept: application/json
Status 200 OK
Content-Type application/json 
[
    {
        "accessId": "",
        "idCard": "",
        "number": "",
        "validFrom": "",
        "validTill": "",
        "entryTime": "",
        "exitTime": "",
        "entryType": "",
        "credit": "",
        "valid": "",
        "blocked": "",
        "cardNotice": "",
        "zoneId": "",
        "reservationId": "",
        "ownerId": "",
        "createdBy": "",
        "createdWhen": "",
        "invalidatedBy": "",
        "invalidatedWhen": "",
        "timeMark": "",
        "initialCredit": "",
        "blocations": [
            {
                "cardId": "",
                "reason": "",
                "blockedWhen": "",
                "blockedBy": "",
                "blockType": ""
            },
            {
                "cardId": "",
                "reason": "",
                "blockedWhen": "",
                "blockedBy": "",
                "blockType": ""
            }
        ],
        "aliases": [
            "",
            ""
        ],
        "lpns": [
            "",
            ""
        ],
        "tokens": [
            "",
            ""
        ],
        "zones": [
            "",
            ""
        ],
        "cardGroups": [
            "",
            ""
        ],
        "barCode": "",
        "qrCode": "",
        "pin": ""
    },
    {
        "accessId": "",
        "idCard": "",
        "number": "",
        "validFrom": "",
        "validTill": "",
        "entryTime": "",
        "exitTime": "",
        "entryType": "",
        "credit": "",
        "valid": "",
        "blocked": "",
        "cardNotice": "",
        "zoneId": "",
        "reservationId": "",
        "ownerId": "",
        "createdBy": "",
        "createdWhen": "",
        "invalidatedBy": "",
        "invalidatedWhen": "",
        "timeMark": "",
        "initialCredit": "",
        "blocations": [
            {
                "cardId": "",
                "reason": "",
                "blockedWhen": "",
                "blockedBy": "",
                "blockType": ""
            },
            {
                "cardId": "",
                "reason": "",
                "blockedWhen": "",
                "blockedBy": "",
                "blockType": ""
            }
        ],
        "aliases": [
            "",
            ""
        ],
        "lpns": [
            "",
            ""
        ],
        "tokens": [
            "",
            ""
        ],
        "zones": [
            "",
            ""
        ],
        "cardGroups": [
            "",
            ""
        ],
        "barCode": "",
        "qrCode": "",
        "pin": ""
    }
]
Status 400 Bad Request
Status 403 Forbidden
Status 500 Internal Server Error

Card Info BARCODE

Authorization: KERNEL_CARDS

curl -X GET -H "Accept: application/json" "{{APIUrl}}/v1/kernel/cards?barCode={{cardBarCode}}&gmtpId={{gmtpId}}"
GET %7B%7BAPIUrl%7D%7D/v1/kernel/cards?barCode={{cardBarCode}}&gmtpId={{gmtpId}} HTTP/1.1
Host: 
Accept: application/json
Status 200 OK
Content-Type application/json 
[
    {
        "accessId": "",
        "idCard": "",
        "number": "",
        "validFrom": "",
        "validTill": "",
        "entryTime": "",
        "exitTime": "",
        "entryType": "",
        "credit": "",
        "valid": "",
        "blocked": "",
        "cardNotice": "",
        "zoneId": "",
        "reservationId": "",
        "ownerId": "",
        "createdBy": "",
        "createdWhen": "",
        "invalidatedBy": "",
        "invalidatedWhen": "",
        "timeMark": "",
        "initialCredit": "",
        "blocations": [
            {
                "cardId": "",
                "reason": "",
                "blockedWhen": "",
                "blockedBy": "",
                "blockType": ""
            },
            {
                "cardId": "",
                "reason": "",
                "blockedWhen": "",
                "blockedBy": "",
                "blockType": ""
            }
        ],
        "aliases": [
            "",
            ""
        ],
        "lpns": [
            "",
            ""
        ],
        "tokens": [
            "",
            ""
        ],
        "zones": [
            "",
            ""
        ],
        "cardGroups": [
            "",
            ""
        ],
        "barCode": "",
        "qrCode": "",
        "pin": ""
    },
    {
        "accessId": "",
        "idCard": "",
        "number": "",
        "validFrom": "",
        "validTill": "",
        "entryTime": "",
        "exitTime": "",
        "entryType": "",
        "credit": "",
        "valid": "",
        "blocked": "",
        "cardNotice": "",
        "zoneId": "",
        "reservationId": "",
        "ownerId": "",
        "createdBy": "",
        "createdWhen": "",
        "invalidatedBy": "",
        "invalidatedWhen": "",
        "timeMark": "",
        "initialCredit": "",
        "blocations": [
            {
                "cardId": "",
                "reason": "",
                "blockedWhen": "",
                "blockedBy": "",
                "blockType": ""
            },
            {
                "cardId": "",
                "reason": "",
                "blockedWhen": "",
                "blockedBy": "",
                "blockType": ""
            }
        ],
        "aliases": [
            "",
            ""
        ],
        "lpns": [
            "",
            ""
        ],
        "tokens": [
            "",
            ""
        ],
        "zones": [
            "",
            ""
        ],
        "cardGroups": [
            "",
            ""
        ],
        "barCode": "",
        "qrCode": "",
        "pin": ""
    }
]
Status 400 Bad Request
Status 403 Forbidden
Status 500 Internal Server Error

Card Info SMSCODE

Authorization: KERNEL_CARDS

curl -X GET -H "Accept: application/json" "{{APIUrl}}/v1/kernel/cards?gmtpId={{gmtpId}}&smsCode={{cardSMScode}}"
GET %7B%7BAPIUrl%7D%7D/v1/kernel/cards?gmtpId={{gmtpId}}&smsCode={{cardSMScode}} HTTP/1.1
Host: 
Accept: application/json
Status 200 OK
Content-Type application/json 
[
    {
        "accessId": "",
        "idCard": "",
        "number": "",
        "validFrom": "",
        "validTill": "",
        "entryTime": "",
        "exitTime": "",
        "entryType": "",
        "credit": "",
        "valid": "",
        "blocked": "",
        "cardNotice": "",
        "zoneId": "",
        "reservationId": "",
        "ownerId": "",
        "createdBy": "",
        "createdWhen": "",
        "invalidatedBy": "",
        "invalidatedWhen": "",
        "timeMark": "",
        "initialCredit": "",
        "blocations": [
            {
                "cardId": "",
                "reason": "",
                "blockedWhen": "",
                "blockedBy": "",
                "blockType": ""
            },
            {
                "cardId": "",
                "reason": "",
                "blockedWhen": "",
                "blockedBy": "",
                "blockType": ""
            }
        ],
        "aliases": [
            "",
            ""
        ],
        "lpns": [
            "",
            ""
        ],
        "tokens": [
            "",
            ""
        ],
        "zones": [
            "",
            ""
        ],
        "cardGroups": [
            "",
            ""
        ],
        "barCode": "",
        "qrCode": "",
        "pin": ""
    },
    {
        "accessId": "",
        "idCard": "",
        "number": "",
        "validFrom": "",
        "validTill": "",
        "entryTime": "",
        "exitTime": "",
        "entryType": "",
        "credit": "",
        "valid": "",
        "blocked": "",
        "cardNotice": "",
        "zoneId": "",
        "reservationId": "",
        "ownerId": "",
        "createdBy": "",
        "createdWhen": "",
        "invalidatedBy": "",
        "invalidatedWhen": "",
        "timeMark": "",
        "initialCredit": "",
        "blocations": [
            {
                "cardId": "",
                "reason": "",
                "blockedWhen": "",
                "blockedBy": "",
                "blockType": ""
            },
            {
                "cardId": "",
                "reason": "",
                "blockedWhen": "",
                "blockedBy": "",
                "blockType": ""
            }
        ],
        "aliases": [
            "",
            ""
        ],
        "lpns": [
            "",
            ""
        ],
        "tokens": [
            "",
            ""
        ],
        "zones": [
            "",
            ""
        ],
        "cardGroups": [
            "",
            ""
        ],
        "barCode": "",
        "qrCode": "",
        "pin": ""
    }
]
Status 400 Bad Request
Status 403 Forbidden
Status 500 Internal Server Error

Card Info NOTICE

Authorization: KERNEL_CARDS

curl -X GET -H "Accept: application/json" "{{APIUrl}}/v1/kernel/cards?gmtpId={{gmtpId}}¬ice={{cardNotice}}"
GET %7B%7BAPIUrl%7D%7D/v1/kernel/cards?gmtpId={{gmtpId}}¬ice={{cardNotice}} HTTP/1.1
Host: 
Accept: application/json
Status 200 OK
Content-Type application/json 
[
    {
        "accessId": "",
        "idCard": "",
        "number": "",
        "validFrom": "",
        "validTill": "",
        "entryTime": "",
        "exitTime": "",
        "entryType": "",
        "credit": "",
        "valid": "",
        "blocked": "",
        "cardNotice": "",
        "zoneId": "",
        "reservationId": "",
        "ownerId": "",
        "createdBy": "",
        "createdWhen": "",
        "invalidatedBy": "",
        "invalidatedWhen": "",
        "timeMark": "",
        "initialCredit": "",
        "blocations": [
            {
                "cardId": "",
                "reason": "",
                "blockedWhen": "",
                "blockedBy": "",
                "blockType": ""
            },
            {
                "cardId": "",
                "reason": "",
                "blockedWhen": "",
                "blockedBy": "",
                "blockType": ""
            }
        ],
        "aliases": [
            "",
            ""
        ],
        "lpns": [
            "",
            ""
        ],
        "tokens": [
            "",
            ""
        ],
        "zones": [
            "",
            ""
        ],
        "cardGroups": [
            "",
            ""
        ],
        "barCode": "",
        "qrCode": "",
        "pin": ""
    },
    {
        "accessId": "",
        "idCard": "",
        "number": "",
        "validFrom": "",
        "validTill": "",
        "entryTime": "",
        "exitTime": "",
        "entryType": "",
        "credit": "",
        "valid": "",
        "blocked": "",
        "cardNotice": "",
        "zoneId": "",
        "reservationId": "",
        "ownerId": "",
        "createdBy": "",
        "createdWhen": "",
        "invalidatedBy": "",
        "invalidatedWhen": "",
        "timeMark": "",
        "initialCredit": "",
        "blocations": [
            {
                "cardId": "",
                "reason": "",
                "blockedWhen": "",
                "blockedBy": "",
                "blockType": ""
            },
            {
                "cardId": "",
                "reason": "",
                "blockedWhen": "",
                "blockedBy": "",
                "blockType": ""
            }
        ],
        "aliases": [
            "",
            ""
        ],
        "lpns": [
            "",
            ""
        ],
        "tokens": [
            "",
            ""
        ],
        "zones": [
            "",
            ""
        ],
        "cardGroups": [
            "",
            ""
        ],
        "barCode": "",
        "qrCode": "",
        "pin": ""
    }
]
Status 400 Bad Request
Status 403 Forbidden
Status 500 Internal Server Error

GET PRICE

In this section you can find all the variants of Get price request.

Get Price - Till Now

Authorization: KERNEL_CARDS and (CARD_ACCESS_<id> or CARD_ACCESS_ALL)

curl -X GET -H "Accept: application/json" "{{APIUrl}}/v1/kernel/cards/{{idCard}}/payment?payTillNow=true&gmtpId={{gmtpId}}"
GET %7B%7BAPIUrl%7D%7D/v1/kernel/cards/%7B%7BidCard%7D%7D/payment?payTillNow=true&gmtpId={{gmtpId}} HTTP/1.1
Host: 
Accept: application/json
Status 200 OK
Content-Type application/json 
{
    "idCard": "",
    "number": "",
    "addCredit": "",
    "payTill": "",
    "priceWithVAT": "",
    "vatCharge": "",
    "vatValue": "",
    "cardState": "",
    "items": [
        {
            "idCardJournal": "",
            "type": "",
            "count": "",
            "description": "",
            "priceWithVAT": "",
            "vatCharge": "",
            "vatValue": "",
            "notice": ""
        },
        {
            "idCardJournal": "",
            "type": "",
            "count": "",
            "description": "",
            "priceWithVAT": "",
            "vatCharge": "",
            "vatValue": "",
            "notice": ""
        }
    ]
}
Status 404 Not Found
Content-Type application/json 
{
    "idCard": "",
    "number": "",
    "addCredit": "",
    "payTill": "",
    "priceWithVAT": "",
    "vatCharge": "",
    "vatValue": "",
    "cardState": "",
    "items": [
        {
            "idCardJournal": "",
            "type": "",
            "count": "",
            "description": "",
            "priceWithVAT": "",
            "vatCharge": "",
            "vatValue": "",
            "notice": ""
        },
        {
            "idCardJournal": "",
            "type": "",
            "count": "",
            "description": "",
            "priceWithVAT": "",
            "vatCharge": "",
            "vatValue": "",
            "notice": ""
        }
    ]
}

Get Price - Till Preset

Authorization: KERNEL_CARDS and (CARD_ACCESS_<id> or CARD_ACCESS_ALL)

curl -X GET -H "Accept: application/json" "{{APIUrl}}/v1/kernel/cards/{{idCard}}/payment?payTillNow=true&gmtpId={{gmtpId}}"
GET %7B%7BAPIUrl%7D%7D/v1/kernel/cards/%7B%7BidCard%7D%7D/payment?payTillNow=true&gmtpId={{gmtpId}} HTTP/1.1
Host: 
Accept: application/json
Status 200 OK
Content-Type application/json 
{
    "idCard": "",
    "number": "",
    "addCredit": "",
    "payTill": "",
    "priceWithVAT": "",
    "vatCharge": "",
    "vatValue": "",
    "cardState": "",
    "items": [
        {
            "idCardJournal": "",
            "type": "",
            "count": "",
            "description": "",
            "priceWithVAT": "",
            "vatCharge": "",
            "vatValue": "",
            "notice": ""
        },
        {
            "idCardJournal": "",
            "type": "",
            "count": "",
            "description": "",
            "priceWithVAT": "",
            "vatCharge": "",
            "vatValue": "",
            "notice": ""
        }
    ]
}
Status 404 Not Found
Content-Type application/json 
{
    "idCard": "",
    "number": "",
    "addCredit": "",
    "payTill": "",
    "priceWithVAT": "",
    "vatCharge": "",
    "vatValue": "",
    "cardState": "",
    "items": [
        {
            "idCardJournal": "",
            "type": "",
            "count": "",
            "description": "",
            "priceWithVAT": "",
            "vatCharge": "",
            "vatValue": "",
            "notice": ""
        },
        {
            "idCardJournal": "",
            "type": "",
            "count": "",
            "description": "",
            "priceWithVAT": "",
            "vatCharge": "",
            "vatValue": "",
            "notice": ""
        }
    ]
}

Get Price - Till Date

Authorization: KERNEL_CARDS and (CARD_ACCESS_<id> or CARD_ACCESS_ALL)

curl -X GET -H "Accept: application/json" "{{APIUrl}}/v1/kernel/cards/{{idCard}}/payment?payTill=2024-01-12T09:05:51.628Z&gmtpId={{gmtpId}}"
GET %7B%7BAPIUrl%7D%7D/v1/kernel/cards/%7B%7BidCard%7D%7D/payment?payTill=2024-01-12T09:05:51.628Z&gmtpId={{gmtpId}} HTTP/1.1
Host: 
Accept: application/json
Status 200 OK
Content-Type application/json 
{
    "idCard": "",
    "number": "",
    "addCredit": "",
    "payTill": "",
    "priceWithVAT": "",
    "vatCharge": "",
    "vatValue": "",
    "cardState": "",
    "items": [
        {
            "idCardJournal": "",
            "type": "",
            "count": "",
            "description": "",
            "priceWithVAT": "",
            "vatCharge": "",
            "vatValue": "",
            "notice": ""
        },
        {
            "idCardJournal": "",
            "type": "",
            "count": "",
            "description": "",
            "priceWithVAT": "",
            "vatCharge": "",
            "vatValue": "",
            "notice": ""
        }
    ]
}
Status 404 Not Found
Content-Type application/json 
{
    "idCard": "",
    "number": "",
    "addCredit": "",
    "payTill": "",
    "priceWithVAT": "",
    "vatCharge": "",
    "vatValue": "",
    "cardState": "",
    "items": [
        {
            "idCardJournal": "",
            "type": "",
            "count": "",
            "description": "",
            "priceWithVAT": "",
            "vatCharge": "",
            "vatValue": "",
            "notice": ""
        },
        {
            "idCardJournal": "",
            "type": "",
            "count": "",
            "description": "",
            "priceWithVAT": "",
            "vatCharge": "",
            "vatValue": "",
            "notice": ""
        }
    ]
}

Get Price - addCredit

Authorization: KERNEL_CARDS and (CARD_ACCESS_<id> or CARD_ACCESS_ALL)

curl -X GET -H "Accept: application/json" "{{APIUrl}}/v1/kernel/cards/{{idCard}}/payment?addCredit=1440&gmtpId={{gmtpId}}"
GET %7B%7BAPIUrl%7D%7D/v1/kernel/cards/%7B%7BidCard%7D%7D/payment?addCredit=1440&gmtpId={{gmtpId}} HTTP/1.1
Host: 
Accept: application/json
Status 200 OK
Content-Type application/json 
{
    "idCard": "",
    "number": "",
    "addCredit": "",
    "payTill": "",
    "priceWithVAT": "",
    "vatCharge": "",
    "vatValue": "",
    "cardState": "",
    "items": [
        {
            "idCardJournal": "",
            "type": "",
            "count": "",
            "description": "",
            "priceWithVAT": "",
            "vatCharge": "",
            "vatValue": "",
            "notice": ""
        },
        {
            "idCardJournal": "",
            "type": "",
            "count": "",
            "description": "",
            "priceWithVAT": "",
            "vatCharge": "",
            "vatValue": "",
            "notice": ""
        }
    ]
}
Status 404 Not Found
Content-Type application/json 
{
    "idCard": "",
    "number": "",
    "addCredit": "",
    "payTill": "",
    "priceWithVAT": "",
    "vatCharge": "",
    "vatValue": "",
    "cardState": "",
    "items": [
        {
            "idCardJournal": "",
            "type": "",
            "count": "",
            "description": "",
            "priceWithVAT": "",
            "vatCharge": "",
            "vatValue": "",
            "notice": ""
        },
        {
            "idCardJournal": "",
            "type": "",
            "count": "",
            "description": "",
            "priceWithVAT": "",
            "vatCharge": "",
            "vatValue": "",
            "notice": ""
        }
    ]
}

MAKE RECEIPT

In this section you can find out how to make a simple receipt for your payment.

Use this endpoint in order to create a simplified receipt record for a specific station.

Use this endpoint in order to create a simplified receipt record.

curl -X POST -H "Content-Type: application/json" -H "Accept: application/json" -d '{
  "addCredit": "",
  "cardState": "",
  "idCard": "",
  "items": [
    {
      "count": "",
      "description": "",
      "idCardJournal": "",
      "notice": "",
      "priceWithVAT": "",
      "type": "",
      "vatCharge": "",
      "vatValue": ""
    },
    {
      "count": "",
      "description": "",
      "idCardJournal": "",
      "notice": "",
      "priceWithVAT": "",
      "type": "",
      "vatCharge": "",
      "vatValue": ""
    }
  ],
  "number": "",
  "priceWithVAT": "",
  "vatCharge": "",
  "vatValue": ""
}

' "{{APIUrl}}/v1/kernel/receipts/station/:idStation/simple?currencyId=&paymentkindId=&receiptItemName="
POST %7B%7BAPIUrl%7D%7D/v1/kernel/receipts/station/:idStation/simple?currencyId=&paymentkindId=&receiptItemName= HTTP/1.1
Host: 
Content-Type: application/json
Accept: application/json

{
  "addCredit": "",
  "cardState": "",
  "idCard": "",
  "items": [
    {
      "count": "",
      "description": "",
      "idCardJournal": "",
      "notice": "",
      "priceWithVAT": "",
      "type": "",
      "vatCharge": "",
      "vatValue": ""
    },
    {
      "count": "",
      "description": "",
      "idCardJournal": "",
      "notice": "",
      "priceWithVAT": "",
      "type": "",
      "vatCharge": "",
      "vatValue": ""
    }
  ],
  "number": "",
  "priceWithVAT": "",
  "vatCharge": "",
  "vatValue": ""
}
Status 200 OK
Content-Type application/json 
{
    "BKP": "",
    "FIK": "",
    "TaxID": "",
    "adjustment": "",
    "copy": "",
    "createdBy": "",
    "createdWhen": "",
    "fiscalData": "",
    "idReceipt": "",
    "items": [
        {
            "adjustment": "",
            "count": "",
            "description": "",
            "discountName": "",
            "idItem": "",
            "notice": "",
            "priceWithVAT": "",
            "typeId": "",
            "vatCharge": ""
        },
        {
            "adjustment": "",
            "count": "",
            "description": "",
            "discountName": "",
            "idItem": "",
            "notice": "",
            "priceWithVAT": "",
            "typeId": "",
            "vatCharge": ""
        }
    ],
    "notice": "",
    "number": "",
    "paymentKindId": "",
    "pkp": "",
    "priceWithVAT": "",
    "receivedCurrencyId": "",
    "receivedMoney": "",
    "reserved1": "",
    "reserved2": "",
    "reserved3": "",
    "returnedCurrencyId": "",
    "returnedMoney": "",
    "shiftNumber": "",
    "state": "",
    "stationId": "",
    "transactionData": "",
    "type": "",
    "vats": [
        {
            "base": "",
            "charge": "",
            "value": ""
        },
        {
            "base": "",
            "charge": "",
            "value": ""
        }
    ],
    "year": ""
}
Status 201 Created
Content-Type application/json 
{
    "BKP": "",
    "FIK": "",
    "TaxID": "",
    "adjustment": "",
    "copy": "",
    "createdBy": "",
    "createdWhen": "",
    "fiscalData": "",
    "idReceipt": "",
    "items": [
        {
            "adjustment": "",
            "count": "",
            "description": "",
            "discountName": "",
            "idItem": "",
            "notice": "",
            "priceWithVAT": "",
            "typeId": "",
            "vatCharge": ""
        },
        {
            "adjustment": "",
            "count": "",
            "description": "",
            "discountName": "",
            "idItem": "",
            "notice": "",
            "priceWithVAT": "",
            "typeId": "",
            "vatCharge": ""
        }
    ],
    "notice": "",
    "number": "",
    "paymentKindId": "",
    "pkp": "",
    "priceWithVAT": "",
    "receivedCurrencyId": "",
    "receivedMoney": "",
    "reserved1": "",
    "reserved2": "",
    "reserved3": "",
    "returnedCurrencyId": "",
    "returnedMoney": "",
    "shiftNumber": "",
    "state": "",
    "stationId": "",
    "transactionData": "",
    "type": "",
    "vats": [
        {
            "base": "",
            "charge": "",
            "value": ""
        },
        {
            "base": "",
            "charge": "",
            "value": ""
        }
    ],
    "year": ""
}
Status 400 Bad Request
Status 401 Unauthorized
Status 403 Forbidden
Status 404 Not Found

CONFIRM PAYMENT

In this section you can find out how to confirm the payment.

Payment confirm

Authorization: KERNEL_CARDS and (CARD_ACCESS_<id> or CARD_ACCESS_ALL)

curl -X POST -H "Content-Type: application/json" -H "Accept: application/json" -d '{
    "priceWithVAT": {{cardPrice}},
    "addCredit":{{cardCreditAdd}},
    "items": {{ReceiptItems}},
    "receiptYear": {{ReceiptNumber}},
    "receiptNumber": {{ReceiptYear}}
}' "{{APIUrl}}/v1/kernel/cards/{{idCard}}/payment?payTillNow=true&gmtpId={{gmtpId}}"
POST %7B%7BAPIUrl%7D%7D/v1/kernel/cards/%7B%7BidCard%7D%7D/payment?payTillNow=true&gmtpId={{gmtpId}} HTTP/1.1
Host: 
Content-Type: application/json
Accept: application/json

{
    "priceWithVAT": {{cardPrice}},
    "addCredit":{{cardCreditAdd}},
    "items": {{ReceiptItems}},
    "receiptYear": {{ReceiptNumber}},
    "receiptNumber": {{ReceiptYear}}
}
Status 200 OK
Content-Type application/json 
{
    "accessId": "",
    "idCard": "",
    "number": "",
    "validFrom": "",
    "validTill": "",
    "entryTime": "",
    "exitTime": "",
    "entryType": "",
    "credit": "",
    "valid": "",
    "blocked": "",
    "cardNotice": "",
    "zoneId": "",
    "reservationId": "",
    "ownerId": "",
    "createdBy": "",
    "createdWhen": "",
    "invalidatedBy": "",
    "invalidatedWhen": "",
    "timeMark": "",
    "initialCredit": "",
    "blocations": [
        {
            "cardId": "",
            "reason": "",
            "blockedWhen": "",
            "blockedBy": "",
            "blockType": ""
        },
        {
            "cardId": "",
            "reason": "",
            "blockedWhen": "",
            "blockedBy": "",
            "blockType": ""
        }
    ],
    "aliases": [
        "",
        ""
    ],
    "lpns": [
        "",
        ""
    ],
    "tokens": [
        "",
        ""
    ],
    "zones": [
        "",
        ""
    ],
    "cardGroups": [
        "",
        ""
    ],
    "barCode": "",
    "qrCode": "",
    "pin": ""
}
Status 404 Not Found
Content-Type application/json 
{
    "accessId": "",
    "idCard": "",
    "number": "",
    "validFrom": "",
    "validTill": "",
    "entryTime": "",
    "exitTime": "",
    "entryType": "",
    "credit": "",
    "valid": "",
    "blocked": "",
    "cardNotice": "",
    "zoneId": "",
    "reservationId": "",
    "ownerId": "",
    "createdBy": "",
    "createdWhen": "",
    "invalidatedBy": "",
    "invalidatedWhen": "",
    "timeMark": "",
    "initialCredit": "",
    "blocations": [
        {
            "cardId": "",
            "reason": "",
            "blockedWhen": "",
            "blockedBy": "",
            "blockType": ""
        },
        {
            "cardId": "",
            "reason": "",
            "blockedWhen": "",
            "blockedBy": "",
            "blockType": ""
        }
    ],
    "aliases": [
        "",
        ""
    ],
    "lpns": [
        "",
        ""
    ],
    "tokens": [
        "",
        ""
    ],
    "zones": [
        "",
        ""
    ],
    "cardGroups": [
        "",
        ""
    ],
    "barCode": "",
    "qrCode": "",
    "pin": ""
}

STATIC DATA

Obtain the list of Static info or a specific record.

Use this endpoint to obtain a list of all Static info or a specific static information record specified by its name.

curl -X GET -H "Accept: application/json" "{{APIUrl}}/v1/config/staticInformations?gmtpId={{gmtpId}}"
GET %7B%7BAPIUrl%7D%7D/v1/config/staticInformations?gmtpId={{gmtpId}} HTTP/1.1
Host: 
Accept: application/json
Status 200 OK
Content-Type application/json 
[
    {
        "description": "",
        "idStaticInfo": "",
        "name": "",
        "value": ""
    },
    {
        "description": "",
        "idStaticInfo": "",
        "name": "",
        "value": ""
    }
]
Status 401 Unauthorized
Status 403 Forbidden
Status 404 Not Found

Create a new static information record.

Use this endpoint to create a new static information record.

curl -X POST -H "Content-Type: application/json" -H "Accept: application/json" -d '{
  "description": "StaticData1",
  "name": "StaticData1",
  "value": "STATIC DATA VALUE"
}' "{{APIUrl}}/v1/config/staticInformations?gmtpId={{gmtpId}}"
POST %7B%7BAPIUrl%7D%7D/v1/config/staticInformations?gmtpId={{gmtpId}} HTTP/1.1
Host: 
Content-Type: application/json
Accept: application/json

{
  "description": "StaticData1",
  "name": "StaticData1",
  "value": "STATIC DATA VALUE"
}
Status 200 OK
Content-Type application/json 
{
    "description": "",
    "idStaticInfo": "",
    "name": "",
    "value": ""
}
Status 201 Created
Content-Type application/json 
{
    "description": "",
    "idStaticInfo": "",
    "name": "",
    "value": ""
}
Status 400 Bad Request
Status 401 Unauthorized
Status 403 Forbidden
Status 404 Not Found

Obtain details of a static information record by its ID.

Use this endpoint to obtain the details of a static information record by its ID.

curl -X GET -H "Accept: application/json" "{{APIUrl}}/v1/config/staticInformations/:id?gmtpId={{gmtpId}}"
GET %7B%7BAPIUrl%7D%7D/v1/config/staticInformations/:id?gmtpId={{gmtpId}} HTTP/1.1
Host: 
Accept: application/json
Status 200 OK
Content-Type application/json 
{
    "description": "",
    "idStaticInfo": "",
    "name": "",
    "value": ""
}
Status 401 Unauthorized
Status 403 Forbidden
Status 404 Not Found

Update properties of a static information record.

Use this endpoint to update/change properties of a static information record specified by its ID.

curl -X PUT -H "Content-Type: application/json" -H "Accept: application/json" -d '{
  "description": "",
  "idStaticInfo": "",
  "name": "",
  "value": ""
}' "{{APIUrl}}/v1/config/staticInformations/:id?gmtpId={{gmtpId}}"
PUT %7B%7BAPIUrl%7D%7D/v1/config/staticInformations/:id?gmtpId={{gmtpId}} HTTP/1.1
Host: 
Content-Type: application/json
Accept: application/json

{
  "description": "",
  "idStaticInfo": "",
  "name": "",
  "value": ""
}
Status 200 OK
Content-Type application/json 
{
    "description": "",
    "idStaticInfo": "",
    "name": "",
    "value": ""
}
Status 201 Created
Status 401 Unauthorized
Status 403 Forbidden
Status 404 Not Found

Delete static information record.

Use this endpoint to detele the static information record specified by its ID.

curl -X DELETE -H "Accept: application/json" "{{APIUrl}}/v1/config/staticInformations/:id?gmtpId={{gmtpId}}"
DELETE %7B%7BAPIUrl%7D%7D/v1/config/staticInformations/:id?gmtpId={{gmtpId}} HTTP/1.1
Host: 
Accept: application/json
Status 200 OK
Content-Type application/json
Status 204 No Content
Status 401 Unauthorized
Status 403 Forbidden
Status 404 Not Found

Update value property of static information.

Use this endpoint to update/change value of the static information specifed by its ID.

curl -X PUT -H "Accept: application/json" -H "Content-Type: application/json" "{{APIUrl}}/v1/config/staticInformations/:id/value?value=11&gmtpId={{gmtpId}}"
PUT %7B%7BAPIUrl%7D%7D/v1/config/staticInformations/:id/value?value=11&gmtpId={{gmtpId}} HTTP/1.1
Host: 
Accept: application/json
Content-Type: application/json
Status 200 OK
Content-Type application/json 
{
    "description": "",
    "idStaticInfo": "",
    "name": "",
    "value": ""
}
Status 201 Created
Status 401 Unauthorized
Status 403 Forbidden
Status 404 Not Found

ZONES

Obtain details of a Zone record based on its ID.

Use this endpoint to obtain the details of a Zone record based on its ID.

curl -X GET -H "Accept: application/json" "{{APIUrl}}/v1/config/zones/:id?gmtpId={{gmtpId}}"
GET %7B%7BAPIUrl%7D%7D/v1/config/zones/:id?gmtpId={{gmtpId}} HTTP/1.1
Host: 
Accept: application/json
Status 200 OK
Content-Type application/json 
{
    "capacity": "",
    "engage": "",
    "idZone": "",
    "name": "",
    "reservationCapacity": "",
    "reservationEngage": "",
    "visible": "",
    "lastActivity": ""
}
Status 401 Unauthorized
Status 403 Forbidden
Status 404 Not Found

Obtain the list of available Zone records.

Use this endpoint to obtain a list of Zonees currently available in the system.

curl -X GET -H "Accept: application/json" "{{APIUrl}}/v1/config/zones?gmtpId={{gmtpId}}&showAll=true"
GET %7B%7BAPIUrl%7D%7D/v1/config/zones?gmtpId={{gmtpId}}&showAll=true HTTP/1.1
Host: 
Accept: application/json
Status 200 OK
Content-Type application/json 
[
    {
        "capacity": "",
        "engage": "",
        "idZone": "",
        "name": "",
        "reservationCapacity": "",
        "reservationEngage": "",
        "visible": "",
        "lastActivity": ""
    },
    {
        "capacity": "",
        "engage": "",
        "idZone": "",
        "name": "",
        "reservationCapacity": "",
        "reservationEngage": "",
        "visible": "",
        "lastActivity": ""
    }
]
Status 401 Unauthorized
Status 403 Forbidden
Status 404 Not Found

PARKING INFO

This function returns informations about parkings specified by parking id.

Use this endpoint to get information of parkings. Empty param parking get all parkings.

curl -X GET -H "Accept: application/json" "{{APIUrl}}/v1/config/parkings?gmtpId={{gmtpId}}"
GET %7B%7BAPIUrl%7D%7D/v1/config/parkings?gmtpId={{gmtpId}} HTTP/1.1
Host: 
Accept: application/json
Status 200 OK
Content-Type application/json 
[
    {
        "futureIssue": "",
        "lastActivity": "",
        "latitude": "",
        "longitude": "",
        "name": "",
        "parkingId": "",
        "state": "",
        "tariffs": ""
    },
    {
        "futureIssue": "",
        "lastActivity": "",
        "latitude": "",
        "longitude": "",
        "name": "",
        "parkingId": "",
        "state": "",
        "tariffs": ""
    }
]
Status 400 Bad Request
Status 401 Unauthorized
Status 403 Forbidden
Status 404 Not Found