Mokėjimo būdai
Galimų jūsų projektui mokėjimo būdų sąrašą galima gauti realiu laiku, prieš nusiunčiant vartotoją į Paysera sistemą. Tai gali būti naudinga, jei norite atvaizduoti mokėjimo būdo pasirinkimą savo svetainėje - tokiu būdu nereikia būdų pasirinkimo keisti ranka, pavyzdžiui, kai atsiranda nauji mokėjimo būdai.
Taip pat prie kiekvieno mokėjimo būdo gaunate ir minimalią bei maksimalią mokėjimo sumą, dėl to bus rodomi tik aktualūs mokėjimo būdai konkrečiam pirkėjui.
Mokėjimo būdų pasiėmimas yra realizuotas WebToPay bibliotekoje. Įsitikinkite, kad turite naujausią bibliotekos versiją - šis funkcionalumas dar nebuvo realizuotas senesnėse nei 1.5 specifikacijos bibliotekos versijose.
Mokėjimo metodai
Mokėjimų logotipai poraštei
Įveskite šalį, kurią norite atvaizduoti:
Šalis
Albanija
Austrija
Belgija
Bulgarija
Kanada
Čekijos respublika
Vokietija
Danija
Estija
Ispanija
Suomija
Prancūzija
Didžioji Britanija
Gruzija
Graikija
Kroatija
Vengrija
Airija
Italija
Lietuva
Liuksemburgas
Latvija
Malta
Olandija
Norvegija
Kitos šalys
Lenkija
Portugalija
Rumunija
Švedija
Slovėnija
Slovakija
Turkija
Jungtinės Amerikos Valstijos
Kosovas
Mokėjimo būdų pasiėmimas, naudojant WebToPay biblioteką
Informacija apie mokėjimo būdus yra laikoma specialioje klasėje - tai leidžia paprasčiau manipuliuoti duomenimis ir gauti reikiamą informaciją greičiau. Kadangi prie mokėjimų būdų nurodoma minimali ir maksimali mokėjimo suma, gaunant mokėjimo būdus reikia nurodyti ne tik jūsų projekto ID, bet ir valiutą šioms sumoms.
<?php $paymentMethodsInfo = WebToPay::getPaymentMethodList($projectid, $currency);
Informacija apie mokėjimo būdus yra išskaidyta į 4 lygmenis:
-
WebToPay_PaymentMethodList- visa informacija. Šios klasės objektą grąžinaWebToPay::getPaymentMethodListmetodas.
Klasės metodai:-
filterForAmount($amount, $currency)grąžina kitąWebToPay_PaymentMethodListobjektą tik su tais mokėjimo būdais, kurie yra aktualūs nurodytai sumai. -
getCountries()grąžinaWebToPay_PaymentMethodCountryobjektų masyvą. -
getCountry($countryCode)grąžina vienąWebToPay_PaymentMethodCountryobjektą. -
setDefaultLanguage($language)nustato numatytąją kalbą visam objektų medžiui. Ji naudojama pavadinimams bei logotipų adresams. Kalbą galima paduoti ir konkretiems metodams, grąžinantiems pavadinimus.
-
-
WebToPay_PaymentMethodCountry- informacija apie mokėjimo būdus konkrečioje šalyje.
Klasės metodai:-
getTitle()grąžina šalies pavadinimą. -
getGroups()grąžinaWebToPay_PaymentMethodGroupobjektų masyvą. -
getPaymentMethods()grąžinaWebToPay_PaymentMethodobjektų masyvą. Paimami visi mokėjimo būdai iš visų šalyje esančių grupių. Naudokite šį metodą, jei nenorite skaidyti mokėjimo būdų į grupes.
-
-
WebToPay_PaymentMethodGroup- informacija apie mokėjimo būdus konkrečiai grupei konkrečioje šalyje.
Klasės metodai:-
getTitle()grąžina grupės pavadinimą. -
getPaymentMethods()grąžinaWebToPay_PaymentMethodobjektų masyvą.
-
-
WebToPay_PaymentMethod- informacija apie konkretų mokėjimo būdą.
Klasės metodai:-
getKey()grąžina mokėjimo būdo identifikatorių. Jį reikia paduoti formuojant užklausą į Paysera sistemą. -
getTitle()grąžina mokėjimo būdo pavadinimą. -
getLogoUrl()grąžina mokėjimo būdo logotipo adresą. Grąžina null, jei logotipas negalimas. -
isAvailableForAmount($amount, $currency)nustato, ar šis mokėjimo būdas galimas konkrečiai sumai. Jei mokėjimo būdai atfiltruojami naudojantisWebToPay_PaymentMethodList::filterForAmountmetodu, pakartotinai tikrinti nėra prasmės.
-
Pavyzdys, kaip pateikti tinkamus konkrečiai sumai mokėjimo būdus Lietuvoje, jų negrupuojant:
<?php
$paymentMethodsInfo = WebToPay::getPaymentMethodList($projectid, $currency)
->filterForAmount($amount, $currency) // leave only methods, available for this amount
->setDefaultLanguage('lt') // display titles in Lithuanian
;
foreach ($paymentMethodsInfo->getCountry('lt')->getPaymentMethods() as $paymentMethod) {
echo '<input type="radio" name="payment" value="' . $paymentMethod->getKey() . '" />';
if ($paymentMethod->getLogoUrl()) { // display logo only if available
echo '<img src="' . $paymentMethod->getLogoUrl() . '" />';
}
echo $paymentMethod->getTitle() . '<br />';
}
Pavyzdys, kaip pateikti visus mokėjimo būdus visose šalyse pagal jų grupes, neleidžiant pasirinkti negalimų mokėjimo būdų:
<?php
$paymentMethodsInfo = WebToPay::getPaymentMethodList($projectid, $currency)
->setDefaultLanguage('en') // display titles in English
;
foreach ($paymentMethodsInfo->getCountries() as $country) {
echo '<h2>' . $country->getTitle() . '</h2>';
foreach ($country->getGroups() as $group) {
echo '<h3>' . $group->getTitle() . '</h3>';
foreach ($group->getPaymentMethods() as $paymentMethod) {
// display radio only if available
if ($paymentMethod->isAvailableForAmount($amount, $currency)) {
echo '<input type="radio" name="payment" value="' . $paymentMethod->getKey() . '" />';
}
// display logo only if available
if ($paymentMethod->getLogoUrl()) {
echo '<img src="' . $paymentMethod->getLogoUrl() . '" />';
}
echo $paymentMethod->getTitle() . '<br />';
}
}
}
Mokėjimo būdų pasiėmimas, nenaudojant WebToPay bibliotekos
Jei programuojate ne PHP kalba, mokėjimo būdus galite pasiimti per tą patį interfeisą, kaip ir WebToPay biblioteka.
Mokėjimo būdai pateikiami XML formatu, nuėjus šiuo adresu:
https://www.paysera.com/new/api/paymentMethods/yourProjectId/currency:desiredCurrency/amount:desiredAmount/language:desiredLanguage
Visi parametrai, išskyrus yourProjectId yra neprivalomi. Taip pat galite nurodyti tik vieną ar kelis, o ne visus parametrus.
-
desiredCurrency- nurodo, kokia valiuta pateikti minimalią ir maksimalią mokėjimo sumą. Jei nenurodyta, sumos pateikiamos eurais. -
desiredAmount- pateikiami tik tie mokėjimo būdai, kuriems tinka nurodyta suma. Suma pateikiama centais. -
desiredLanguage- pavadinimai pateikiami tik ta kalba. Jei nenurodyta, pavadinimai pateikiami visomis galimomis kalbomis.
Pavyzdžiui, norint gauti mokėjimo būdus, tinkamus 10000 EUR mokėjimui, formuojame tokį adresą (projekto ID paimtas 6028):
https://www.paysera.com/new/api/paymentMethods/6028/currency:EUR/amount:1000000