General information

It is possible to view all the callbacks Paysera sent to your system and response your system provided.

bank.paysera.com -> Projects and Activities -> Received payments -> Info sign near the specific payment.

Here you can see the url that was used for a callback and your system response. You can use this url to trigger callback manually.

Always check payment status - only status 1 means successful payment.

Check whether the payment is not made for testing purposes (by status parameter), whether the service for this payment has not yet been provided (by orderid parameter), whether the amount and currency match the ones saved in the order.

Callback structure

Paysera sends answer to your indicated address: callbackurl. Additional GET parameters (list of description is below) are added to your indicated address callbackurl. All these parameters are transmissible with prefix callbackurl.

Callback parameters

Parameter
Length
Description
projectid
11
Unique project number. Only activated projects can accept payments.
orderid
40
Order number from your system.
lang
3
It is possible to indicate the user language (ISO 639-2/B: LIT, RUS, ENG, etc.). If Paysera does not support the selected language, the system will automatically choose a language according to the IP address or ENG language by default.
amount
11
Amount in cents the client has to pay.
currency
3
Payment currency (i.e USD, EUR, etc.) you want the client to pay in. If the selected currency cannot be accepted by a specific payment method, the system will convert it automatically to the acceptable currency, according to the currency rate of the day. Payamount and paycurrency answers will be sent to your website.
payment
20
Payment type. If provided, the payment will be made by the specified method (for example by using the specified bank). If not specified, the payer will be immediately provided with the payment types to choose from. You can get payment types in real time by using WebToPay library.
country
2
Payer's country (LT, EE, LV, GB, PL, DE). All possible types of payment in that country are immediately indicated to the payer, after selecting a country.
paytext
0
Payment purpose visible when making the payment.
_ss2
0
Parameter, which checks if you get the answer from our server. This is the most reliable way to check it.
_ss1
0
Parameter, which checks if you get the answer from our server. This is not as reliable as _ss2 to check it. You can download script example from Here .
name
255
Payer's name received from the payment system. Sent only if the payment system provides such.
surename
255
Payer's surname received from the payment system. Sent only if the payment system provides such.
status
255
Payment status:
0 - Payment has not been executed
1 - Payment successful
2 - Payment order accepted, but not yet executed
error
20
test
1
The parameter, which allows to test the connection. The payment is not executed, but the result is returned immediately, as if the payment has been made.
payment_country
2
Country of the payment method. If the payment method is available in more than one country (international) – the parameter is not sent. The country is provided in the two-character (ISO 3166-1 alpha-2) format, e.g.: LT, PL, RU, EE.
payer_ip_country
2
Country of the payer established by the IP address of the payer. The country is provided in two-character (ISO 3166-1 alpha-2) format, e.g.: LT, PL, RU, EE.
payer_country
2
Country of the payer established by the country of the payment method, and if the payment method is international – by the IP address of the payer. The country is provided in the two-character (ISO 3166-1 alpha-2) format, e.g.: LT, PL, RU, EE.
p_email
0
Payer's email address is necessary. If the email address is not received, the client will be requested to enter it. Paysera system will inform the payer about the payment status by this address.
requestid
40
It is a request number, which we receive when the user presses on the logo of the bank. We transfer this request number to the link provided in the "callbackurl" field.
payamount
0
Amount of the transfer in cents. It can differ, if it was converted to another currency.
paycurrency
0
The transferred payment currency (i.e USD, EUR, etc.). It can differ from the one you requested, if the currency could not be accepted by the selected payment method.
version
9
A version number of Paysera system specification (API).