Integration with specification

projectid

11

Yes

Unique project number. Only activated projects can accept payments.

orderid

40

Yes

Order number from your system.

accepturl

255

Yes

Full address (URL), to which the client is directed after a successful payment.
Seller should not rely on accepturl to confirm an order. Instead, order confirmation on the Seller side should be done per callbackurl.

cancelurl

255

Yes

Full address (URL), to which the client is directed after he clicks the link to return to the shop.

callbackurl

255

Yes

Full address (URL), to which a seller will get information about performed payment.

Script must return text "OK". Only then our system will register, that information about the payment has been received.

If there is no answer "OK", the message will be sent 4 times (when we get it, after an hour, after three hours and after 24 hours).

version

9

Yes

The version number of Paysera system specification (API).

lang

3

No

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

No

Amount in cents the client has to pay.

currency

3

No

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

No

Payment type. If provided, the payment will be made by the method specified (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

No

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

255*

No

Payment purpose visible when making the payment. If not specified, default text is used:

Payment for goods and services (for nb. [order_nr]) ([site_name]).

If you specify the payment purpose, it is necessary to include the following variables, which will be replaced with the appropriate values in the final purpose text:

[order_nr] - payment number.
[site_name] or [owner_name] - website address or company name.

p_firstname

255

No

Payer's name. Requested in the majority of payment methods. Necessary for certain payment methods.

p_lastname

255

No

Payer's surname. Requested in the majority of payment methods. Necessary for certain payment methods.

p_email

255

No

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.

p_street

255

No

Payer's address, to which goods will be sent (e.g.: Pilaitės pr. 16). Necessary for certain payment methods.

p_city

255

No

Payer's city, to which goods will be sent (e.g.: Vilnius). Necessary for certain payment methods.

p_state

255

No

Payer's state code (necessary, when buying in USA). Necessary for certain payment methods.

p_zip

20

No

Payer's postal code. Lithuanian postal codes can be found here . Necessary for certain payment methods.

p_countrycode

20

No

Payer's country code. The list with country codes can be found here . Necessary for certain payment methods.

test

1

No

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. To test, it is necessary to activate the mode for a particular project by logging in and selecting: "Projects and Activities" -> "My Projects" -> "Project Settings" -> "Paysera Checkout Settings" and check the box for "Allow Test Payments".

sign

255

Yes

Parameter with data signature. It is necessary to make sure that data is being sent from your website. If you use not a PHP programing language, you have to pay attention in coding when generating 'sign' parameter. PHP functions strlen() and strtolower() do not maintain UTF-8, because of that operations are being performed not with UTF-8, but with bytes: strlen('ąbčd') == 6 and strtolower('ĄBČD') == 'ĄbČd'.