Integration with specification
Bellow you can find detailed specification of transmissible and receivable data.
If it's available (there is PHP with required version in your server), we strongly advise to use libwebtopay library to generate requests and process callbacks.
Structure of request data
You should send data of the form in GET or POST method. Address: https://www.paysera.com/pay/
There are always 2 fields sent: data and sign.
Generating request fields from parameters
All parameters are joined to URL-encoded string. For example:
array('param1' => 'abc', 'param2' => 'Some string with symbols %=&') 'param1=abc¶m2=Some+string+with+symbols+%25%3D%26'In PHP language this is done by function
Result string is encoded in base64 encoding. For example:
'param1=abc¶m2=Some+string+with+symbols+%25%3D%26' 'cGFyYW0xPWFiYyZwYXJhbTI9U29tZStzdHJpbmcrd2l0aCtzeW1ib2xzKyUyNSUzRCUyNg=='In PHP language this is done by function
In the result string symbols "/" are replaced with "_", and symbols
"+" with "-". We get similar to base64 encoding, which is safe to
send in URL without further processing. For example:
'MViDYlV7V0iHR2w2OkJjRFFpY11hizJDhk+EZjl/' 'MViDYlV7V0iHR2w2OkJjRFFpY11hizJDhk-EZjl_'In PHP language this is done by function
The final result string is signed - the sign
parameter is generated. Algorithm to generate sign
sign = md5(data + password)Here md5 is cryptographic hash function, data - encoded parameters, password - your project password.
Available request parameters
|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.|
|cancelurl||255||Yes||Full address (URL), to which the client is directed after he clicks the link to return to the shop.|
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.|
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:
If these variables are not specified, the default purpose text will be used.
Example of a payment purpose:
Payment for goods made to order [order_nr] in website [site_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.: Mėnulio g. 7 - 7). 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||20||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||2||No||Payer's country code. The list with country codes can be found here. Necessary for certain payment methods.|
|only_payments||0||No||Show only those payment methods that are separated by commas.|
|disallow_payments||0||No||Hide payment methods separated by comma.|
|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: "Manage projects" -> "Payment gateway" (for a specific project) -> "Allow test payments" (check).|
|time_limit||19||No||The parameter indicating the final date for payment; the date is given in “yyyy-mm-dd HH:MM:SS” format. The minimum value is 15 minutes from the current moment; the maximum value is 3 days. Note: works only with certain payment methods.|
|personcode||255||No||This parameter can be used for user authentication. If the user’s identification number is transferred, together with callback Paysera will return personcodestatus parameter, which will indicate whether the personal code corresponds to the transferred one.|
|developerid||11||No||In case you are labeled as a developer in our system, you have to transfer this parameter in your installed project (projects). The value of the parameter - your unique user number.|
Can be set to 0 or 1. If it is set to 1, the payer can skip the additional step where he needs to accept consent using PIS payment. If this parameter is used, additional text is required to be added to your page:
Please be informed that the account information and payment initiation services will be provided to you by Paysera in accordance with these Rules. By proceeding with this payment, you agree to receive this service and the service terms and conditions.
* Final length may vary depending on payment type specification
For more information on callbacks - see the chapter Callback .