Dátové modely

`QrPayment`

Reprezentuje QR platbu.

Názov	Typ	Popis
`transactionId`	`string`	ID platby. Reťazec s prefixom `QR-` nasledovaný 32 alfanumerickými znakmi.
`amount`	`number`	Suma platby. Kladné nenulové číslo s presnosťou najviac na dve desatinné miesta.
`currencyCode`	`string`	Peňažná mena vo formáte ISO4217, v ktorej je platba evidovaná. V rámci QR platieb je povolená iba hodnota `EUR`.
`merchant`	`QrPaymentMerchant`	Informácie o obchodníkovi, ktorému majú byť prostriedky zaslané.
`payments`	`QrPaymentEntry[]`	Úhrady viazané k tejto platbe.
`createdAt`	`string (date)`	Dátum a čas vytvorenia ID platby. Textový reťazec vo formáte ISO8601, vyjadrený v UTC. Napríklad: `2025-10-23T08:45:05Z`
`expiresAt`	`string (date)`	Dátum a čas vytvorenia ID platby. Textový reťazec vo formáte ISO8601, vyjadrený v UTC. Napríklad: `2025-10-23T08:47:05Z`
`status`	`string (PaymentStatus)`	Stav platby. Napríklad `pending`.
`paidAmount`	`number`	Suma prijatých prostriedkov. Kladné nenulové číslo s presnosťou najviac na dve desatinné miesta.
`remainingAmount`	`number`	Suma zostavajúca k úhrade. Kladné nenulové číslo s presnosťou najviac na dve desatinné miesta.
`overpaidAmount`	`number`	Suma úhrad prevyšujúca sumu platby. Kladné nenulové číslo s presnosťou najviac na dve desatinné miesta.
`recipientMessage`	`string?`	Voliteľná správa pre príjemcu platby, prenášaná v platobnom odkaze.
`links`	`QrPaymentLink[]`	Platobné odkazy, ktorými je možné uhradiť zostávajúcu čiastku platby. Kolekcia je prázdna prípade, ak je platba uhradená alebo exspirovaná (stavy `paid`, `overpaid` alebo `expired`).

`PaymentStatus`

Stav QR platby.

Povolené hodnoty:

Hodnota	Popis
`pending`	Platba bola vytvorená, ale zatiaľ nebola prijatá žiadna úhrada.
`partiallyPaid`	Prijatá čiastočná úhrada, platba zatiaľ nie je úplne zaplatená.
`paid`	Platba je úplne uhradená – prijatá suma sa rovná požadovanej sume.
`overpaid`	Prijatá suma presahuje požadovanú hodnotu (preplatok).
`expired`	Platba vypršala pred úplnou úhradou.

`QrPaymentMerchant`

Informácie o obchodníkovi, ktorému majú byť prostriedky QR platby zaslané.

Názov	Typ	Popis
`iban`	`string`	IBAN účtu obchodníka.
`name`	`string`	Meno obchodníka.

`QrPaymentEntry`

Informácie o úhrade ku QR platbe.

Názov	Typ	Popis
`amount`	`number`	Suma úhrady. Kladné nenulové číslo s presnosťou najviac na dve desatinné miesta.
`receivedAt`	`string (date)`	Dátum a čas prijatia informácie o úhrade. Textový reťazec vo formáte ISO8601, vyjadrený v UTC. Napríklad: `2025-10-23T08:45:35Z`

`QrPaymentLink`

Platobný odkaz QR platby.

Názov	Typ	Popis
`provider`	`string`	Poskytovateľ platobného odkazu.
`version`	`string`	Verzia platobného odkazu
`url`	`string (URL)`	URL adresa platobnej linky.

Schémy platobných liniek

Aktuálne sú podporované nasledovné platobné linky:

Poskytovateľ	Verzia	Popis
`payme`	`1.3`	Payme štandard platný od 9.10.2025 do 31.12.2025. Používaný len v rámci pilotného testovania. Nie je určený pre produkčné použitie.
`payme`	`2.0`	Payme štandard platný od 1.1.2026.

Data Models

`QrPayment`

Represents a QR payment.

Name	Type	Description
`transactionId`	`string`	Payment ID. A string prefixed with `QR-` followed by 32 alphanumeric characters.
`amount`	`number`	Payment amount. A positive non-zero number with a precision of up to two decimal places.
`currencyCode`	`string`	Currency in ISO4217 format in which the payment is recorded. Only the value `EUR` is allowed for QR payments.
`merchant`	`QrPaymentMerchant`	Information about the merchant to whom the funds are to be transferred.
`payments`	`QrPaymentEntry[]`	Payments associated with this QR payment.
`createdAt`	`string (date)`	Date and time when the payment ID was created. A text string in ISO8601 format, expressed in UTC. Example: `2025-10-23T08:45:05Z`.
`expiresAt`	`string (date)`	Date and time when the payment ID expires. A text string in ISO8601 format, expressed in UTC. Example: `2025-10-23T08:47:05Z`.
`status`	`string (PaymentStatus)`	Current status of the payment. For example: `pending`.
`paidAmount`	`number`	The total amount of funds received. A positive non-zero number with a precision of up to two decimal places.
`remainingAmount`	`number`	The remaining amount to be paid. A positive non-zero number with a precision of up to two decimal places.
`overpaidAmount`	`number`	The amount received exceeding the requested payment. A positive non-zero number with a precision of up to two decimal places.
`links`	`QrPaymentLink[]`	Payment links that can be used to pay the remaining amount. The collection is empty if the payment is already settled or expired (statuses `paid`, `overpaid`, or `expired`).

`PaymentStatus`

Represents the status of a QR payment.

Allowed values:

Value	Description
`pending`	The payment has been created, but no incoming payment has been received yet.
`partiallyPaid`	A partial payment has been received, but the full amount is not yet covered.
`paid`	The payment has been fully settled; the received amount equals the requested amount.
`overpaid`	The received amount exceeds the requested amount (overpayment).
`expired`	The payment has expired before being fully paid.

`QrPaymentMerchant`

Information about the merchant to whom the QR payment funds should be sent.

Name	Type	Description
`iban`	`string`	Merchant’s bank account IBAN.
`name`	`string`	Merchant’s name.

`QrPaymentEntry`

Information about a received payment related to the QR payment.

Name	Type	Description
`amount`	`number`	Payment amount. A positive non-zero number with a precision of up to two decimal places.
`receivedAt`	`string (date)`	Date and time when the payment information was received. A text string in ISO8601 format, expressed in UTC. Example: `2025-10-23T08:45:35Z`.

`QrPaymentLink`

A payment link associated with the QR payment.

Name	Type	Description
`provider`	`string`	Payment link provider.
`version`	`string`	Version of the payment link.
`url`	`string (URL)`	URL of the payment link.

Payment Link Schemes

The following payment link schemes are currently supported:

Provider	Version	Description
`payme`	`1.3`	Payme standard valid from October 9, 2025 to December 31, 2025.
`payme`	`2.0`	Payme standard valid from January 1, 2026.