Request Parameters

This page lists all available parameters for Paysera Checkout API integration.

Required Parameters

Parameter	Type	Max Length	Required	Description
projectid	integer	11	Yes	Your unique project ID. Only activated projects can accept payments.
orderid	string	40	Yes	Unique order number from your system.
accepturl	string	255	Yes	Full URL where customer is redirected after successful payment. Note: Do not rely on accepturl to confirm orders - use callbackurl instead.
cancelurl	string	255	Yes	Full URL where customer is redirected when they cancel the payment.
callbackurl	string	255	Yes	Full URL where Paysera sends payment status notifications. Script must return "OK" to acknowledge receipt.
version	string	9	Yes	API version number (e.g., "1.8" or "1.9").

Payment Details

Parameter	Type	Max Length	Required	Description
amount	integer	11	No	Payment amount in cents (e.g., 1000 = 10.00 EUR).
currency	string	3	No	Payment currency code (EUR, USD, etc.). If the currency is not supported by selected payment method, it will be converted automatically.
payment	string	20	No	Specific payment method code. If not specified, customer will choose from available methods. See Payment Types for available codes.
country	string	2	No	Customer's country code (LT, EE, LV, GB, PL, DE, etc.). Shows payment methods available in that country.
lang	string	3	No	Interface language (ISO 639-2/B: LIT, RUS, ENG, etc.). Falls back to IP-based or ENG if not supported.
paytext	string	255*	No	Payment purpose text. Use variables: [order_nr] for order number, [site_name] or [owner_name] for your company/site name.

Customer Information

Parameter	Type	Max Length	Required	Description
p_firstname	string	255	No**	Customer's first name. Required for some payment methods.
p_lastname	string	255	No**	Customer's last name. Required for some payment methods.
p_email	string	255	No**	Customer's email address. If not provided, customer will be asked to enter it.
p_street	string	255	No**	Customer's street address (e.g., "Pilaitės pr. 16"). Required for some payment methods.
p_city	string	255	No**	Customer's city (e.g., "Vilnius"). Required for some payment methods.
p_state	string	255	No**	Customer's state code (required for USA purchases). Required for some payment methods.
p_zip	string	20	No**	Customer's postal code. Lithuanian postal codes. Required for some payment methods.
p_countrycode	string	20	No**	Customer's country code. ISO country codes. Required for some payment methods.

Additional Options

Parameter	Type	Max Length	Required	Description
test	integer	1	No	Set to 1 for test payments. Must enable "Allow Test Payments" in project settings.
only_payments	string	-	No	Comma-separated list of payment method codes to show. Hides all others.
disallow_payments	string	-	No	Comma-separated list of payment method codes to hide.
time_limit	string	19	No	Payment deadline in format "yyyy-mm-dd HH:MM:SS" (timezone: Europe/Vilnius). Min: 12 minutes, Max: 3 days. Note: Applies to payment initiation only.
personcode	string	255	No	Customer's national identification number. Enables identity verification. Must enable in project settings.
developerid	integer	11	No	Your unique developer ID if you're registered as a developer in Paysera system.
buyer_consent	integer	1	No	Set to 1 to skip PIS consent step. Requires displaying consent text on your page (see below).

Periodic Payments (PIS)

Available only for SEB and Swedbank PIS payments.

Parameter	Type	Max Length	Required	Description
periodic_payments_frequency	string	255	No	Payment frequency: weekly, monthly, quarterly, semiannual, annual. Some banks also support: daily, every_working_day, last_day_of_month, last_working_day_of_month.
periodic_payments_start_date	string	10	No	Start date in format "yyyy-mm-dd".
periodic_payments_end_date	string	10	No	End date in format "yyyy-mm-dd".

PIS Payment - Beneficiary Information

Use when receiving payment to a specific IBAN account via PIS methods.

Parameter	Type	Max Length	Required	Description
beneficiary_country	string	255	No**	Beneficiary country code (LT, EE, LV, etc.). Required for some PIS methods.
beneficiary_town	string	255	No**	Beneficiary town/city (e.g., "Vilnius"). Required for some PIS methods.
beneficiary_street	string	255	No**	Beneficiary street address. Required for some PIS methods.
beneficiary_building	string	255	No**	Beneficiary building number. Required for some PIS methods.
beneficiary_postcode	string	255	No**	Beneficiary postal code. Required for some PIS methods.
beneficiary_country_subdivision	string	255	No**	Beneficiary country subdivision. Required for some PIS methods.
beneficiary_bank_name	string	255	No**	Beneficiary bank name. Required for some PIS methods.
beneficiary_name	string	255	No**	Beneficiary name. Required for some PIS methods.
beneficiary_iban	string	255	No**	Beneficiary IBAN account number. Required for some PIS methods.
beneficiary_bic	string	255	No**	Beneficiary BIC/SWIFT code. Required for some PIS methods.

Buyer Consent Text

If using buyer_consent=1, you must display this text on your payment 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.

Notes

• Paytext length: Final length may vary depending on payment method specification
• Required fields: Some payment methods require specific customer information fields
• Testing: Always test with test=1 parameter before going live
• Callback: Your callback script must return "OK" for successful payment confirmation

Related Documentation

• Custom Integration - Implementation guide
• Processing Callback - Handling payment notifications
• FAQ - Frequently asked questions