Integravimas su specifikacija

projectid

11

Taip

Unikalus projekto numeris. Tik patvirtinti projektai, gali priimti įmokas.

orderid

40

Taip

Užsakymo numeris iš jūsų sistemos.

accepturl

255

Taip

Pilnas interneto adresas (URL), į kurį klientas nukreipiamas sėkmingai atlikus mokėjimą.
Norėdamas patvirtinti užsakymą, pardavėjas neturėtų pasikliauti „accepturl“. Vietoj to, pardavėjas užsakymą turėtų patvirtinti per „callbackurl“.

cancelurl

255

Taip

Pilnas interneto adresas (URL), į kurį klientas nukreipiamas nuspaudus grįžimo į parduotuvę nuorodą.

callbackurl

255

Taip

Pilnas adresas (URL), kuriuo pardavėjui pateikiama informacija apie atliktą mokėjimą.

Skriptas turi grąžinti tekstą "OK". Tik tuomet mūsų sistema užfiksuos, kad apie apmokėjimą sėkmingai informavome.

Jeigu atsakymo "OK" nėra, tai pranešimą siunčiame 4 kartus (kai tik gauname, po valandos, po trijų ir po paros).

version

9

Taip

Paysera mokėjimų sistemos specifikacijos (API) versijos numeris.

lang

3

Ne

Galima nurodyti naudotojo kalbą (ISO 639-2/B: LIT, RUS, ENG ir pan.). Jeigu tokios kalbos Paysera nepalaiko bus parinkta kalba pagal lankytojo IP adresą arba anglų kalba pagal nutylėjimą.

amount

11

Ne

Suma centais, kurią klientas turi apmokėti.

currency

3

Ne

Mokėjimo valiuta (pvz. USD, EUR ir pan.), kuria pageidaujate, kad klientas mokėtų. Jeigu nurodyta valiuta per pasirinktą mokėjimo būdą negali būti priimta, sistema automatiškai pagal dienos kursą konvertuos į palaikomą valiutą. Atsakyme į Jūsų svetainę bus paduoti payamount ir paycurrency.

payment

20

Ne

Mokėjimo būdas. Jei nurodytas, mokėjimas bus atliekamas konkrečiai per tą mokėjimo būdą. Jei nenurodytas, vartotojui bus pateikiama galimų mokėjimo būdų lentelė. Mokėjimo būdus galite gauti ir realiu laiku, naudojantis WebToPay biblioteka.

country

2

Ne

Mokėtojo šalis (LT, EE, LV, GB, PL, DE). Nurodžius šalį mokėtojui iš karto pateikiami mokėjimo būdai, kurie galimi toje šalyje. Jeigu šalis nenurodoma, sistema pagal mokėtojo IP adresą nustato jo šalį. Mokėtojui paliekama galimybė pasikeisti šalį.

paytext

255*

Ne

Mokėjimo paskirtis, kuri matosi darant pavedimą. Nenurodžius naudojamas tekstas pagal nutylėjimą:

Apmokėjimas už prekes ir paslaugas (už nr. [order_nr]) ([site_name]).

Jeigu nurodote mokėjimo paskirtį, būtina įtraukti šiuos kintamuosius, kurie galutiniame paskirties tekste bus pakeisti į atitinkamas reikšmes:

[order_nr] - užsakymo numeris.
[site_name] arba [owner_name] - svetainės adresas arba įmonės pavadinimas.

p_firstname

255

Ne

Pirkėjo vardas. Pageidautina daugumoje mokėjimo būdų. Privaloma mokėjimą atliekant tam tikrais mokėjimo būdais.

p_lastname

255

Ne

Pirkėjo pavardė. Pageidautina daugumoje mokėjimo būdų. Privaloma mokėjimą atliekant tam tikrais mokėjimo būdais.

p_email

255

Ne

Pirkėjo el. paštas privalomas. Jeigu adresas nebus gautas, kliento bus prašoma jį įvesti. Šiuo adresu Paysera sistema informuos mokėtoją apie apmokėjimo būklę.

p_street

255

Ne

Pirkėjo adresas, kuriuo bus siunčiamos prekės (pvz: Pilaitės pr. 16). Pageidautina. Privaloma mokėjimą atliekant tam tikrais mokėjimo būdais.

p_city

255

Ne

Pirkėjo miestas, į kurį bus siunčiamos prekės. (pvz: Vilnius). Pageidautina. Privaloma mokėjimą atliekant tam tikrais mokėjimo būdais.

p_state

255

Ne

Pirkėjo valstijos kodas (privalomas tik perkant JAV valstijoje). Pageidautina. Privaloma mokėjimą atliekant tam tikrais mokėjimo būdais.

p_zip

20

Ne

Pirkėjo pašto kodas. Lietuvos pašto kodus galite rasti čia . Privaloma mokėjimą atliekant tam tikrais mokėjimo būdais.

p_countrycode

20

Ne

Pirkėjo šalies kodas. Šalies sutrumpintus kodus galite rasti čia . Privaloma mokėjimą atliekant tam tikrais mokėjimo būdais.

test

1

Ne

Parametras, kuriam esant galima testuoti sujungimą, tokiu būdu apmokėjimas nevykdomas ir rezultatas grąžinamas iš karto, tartum būtų sumokėta. Norint testuoti, būtina aktyvuoti testavimo režimą prie konkretaus projekto, kai prisijungiate: "Projektai ir veiklos" -> "Mano projektai" -> "Projekto nustatymai" -> "Įmokų surinkimo paslaugos nustatymai" (prie konkretaus projekto) -> "Leisti testinius mokėjimus" (pažymėkite).

sign

255

Taip

Parametras, kuriuo siunčiamas duomenų parašas. Tai reikalinga tam, kad patikrinti ar tikrai duomenys siunčiami iš Jūsų svetainės. Jei naudojate ne PHP programavimo kalbą, generuojant 'sign' parametrą atkreipkite dėmesį į tai, kad pavyzdyje naudojamos PHP funkcijos strlen() ir strtolower() nesupranta UTF-8, todėl operacijos atliekamos su baitais, o ne UTF-8 simboliais: strlen('ąbčd') == 6 ir strtolower('ĄBČD') == 'ĄbČd'.