Payment-FinishReservation-v2

Barion API: Finish a pending reservation

POST	/v2/Payment/FinishReservation

The /payment/finishreservation API endpoint is used to finalize a pending reservation in the Barion system.

Prerequisites before use:

• Creating an account in Barion
• Creating a shop in Barion
• Start a payment
• API: /Payment/Start

Use cases

This API endpoint is designed to be used in the following scenarios:

• Payments with reservation

Input properties

Property name	Property type	Limitations and constraints	Description
POSKey	Guid	Required	The secret API key of the shop, generated by Barion. This lets the shop to authenticate through the Barion API, but does not provide access to the account owning the shop itself.
PaymentId	Guid	Required	The identifier of the payment in the Barion system.
Transactions	PaymentTransaction[]	Required	The payment transactions that the shop would like to finish.

Important things about the transaction structure

• The Transactions[] array should only contain the initial payment transactions. The additional transactions generated by the Barion system (e.g. fees) must not be included in the call.
• Each payment transaction can only be finished once.
• It is not neccessary to finish all transactions in the same API call, but one call must contain at least one transaction to finish.
• If a transaction is finished with a Total amount lesser than its initial value, the remaining amount is refunded to the payer.
• If the reservation period passes, all unfinished transactions are finished with zero amount.

Output properties

Property name	Property type	Description
Isuccessful	bool	Result of the transaction
PaymentId	Guid	The identifier of the newly initialized payment, generated by the Barion system.
PaymentRequestId	string	The payment identifier supplied by the API caller in the request.
Status	PaymentStatus	The status of the payment in the Barion system.
Transactions	ProcessedTransaction[]	Related transactions