Payment-GetPaymentState-v2

Barion API: Request the current state of a payment

GET	/v2/Payment/GetPaymentState

The /payment/getpaymentstate API endpoint is used to query the details and current state of a given payment.

Prerequisites before use:

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

v2 This API endpoint is available in API v2 only.

Use cases

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

• Responsive Web Payment

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.

Output properties

Property name	Property type	Description
PaymentId	Guid	The identifier of the payment in the Barion system.
PaymentRequestId	string	The identifier of the payment in the shop's system.
POSId	Guid	The public identifier of the shop that created the payment.
POSName	string	The name of the shop that created the payment.
POSOwnerEmail	string	The e-mail address of the owner of the shop that created the payment.
Status	PaymentStatus	The current status of the payment in the Barion system.
PaymentType	string	The type of the payment. Can be Immediate or Reservation.
AllowedFundingSources	string[]	The allowed funding sources that were defined when creating the payment.
FundingSource	string	The funding source that was used to complete the payment. If the payment is not yet completed, this is empty. Can be Balance or BankCard.
FundingInformation	FundingInformation	Detailed information about the funding source that was used to complete the payment. If the payment is not yet completed, this is empty.
GuestCheckout	bool	Indicates whether the payment allows guest checkout.
CreatedAt	DateTime	The timestamp showing when the payment was created.
StartedAt	DateTime	The timestamp showing when a reservation payment was started. If the payment type is not reservation, this is empty.
CompletedAt	DateTime	The timestamp showing when the payment was completed. If the payment is not yet completed, this is empty.
ValidUntil	DateTime	Timestamp showing the expiration time of the payment time window. The payment must be completed before this elapses.
ReservedUntil	DateTime	Timestamp showing the expiration time of the reservation time window. The reserved payment must be finished before this elapses. If the payment type is not reservation, this is empty.
Transactions	DetailedPaymentTransaction[]	An array containing a detailed structure of all transactions associated with the payment.
Total	decimal	The total amount of the payment at the time of the request. If a reservation was finished with a lower amount, or a previously completed payment was refunded, this can be less than at the time of creation.
Currency	string	The 3 character ISO 4217 currency code of the payment.
SuggestedLocale	string	Indicates in which language the Barion Smart Gateway should be shown for the payer.
FraudRiskScore	int	A risk score computed by the anti-fraud analysis, between a range of 0 (completely legit) to 100 (certain fraud). Transactions under 10 are usually safe. Transactions between 10 and 30 are risky, caution is advised. Transactions over 30 are blocked automatically for being almost certainly fraudulent.
CallbackUrl	string	The URL (including the payment identifier) where the Barion system will send (or already sent) a request to whenever there is a change in the state of the payment.
RedirectUrl	string	The URL (including the payment identifier) where the payer gets (or already got) redirected to after the payment is or was completed or cancelled.