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
Afganistanas
Airija
Aland salos
Albanija
Alžyras
Amerikos Samoa
Andora
Anguilla
Angola
Antarktika
Atikva ir Barbuda
Argentina
Armėnija
Aruba
Australija
Austrija
Azerbaidžianas
Bahamai
Bahreinas
Baltarusija
Bangladešas
Barbados
Belgija
Belizas
Beninas
Bermudai
Gvinėja-Bissau
Bolivija
Bosnia ir Herzogovina
Botsvana
Brazilija
Brunėjus
Bulgarija
Burkina faso
Burubdis
Butanas
Bouvet salos
Centrinė Afrikos Resupublika
Danija
Didžioji Britanija
Virdžinijos salos (british)
Dominika
Dominikos respublika
Kotdivaris
Jersey
Džibutis
Egiptas
Ekvadoras
Eritrėja
Estija
Etiopija
Farerų salos
Fidžis
Filipinai
Folklendų salos (Malvinų)
Gabonas
Gviana
Gambija
Gana
Guernsey
Gibraltaras
Graikija
Grenada
Grenlandja
Gruzija
Guamas
Gvadelupa
Gvatemala
Gvinėja
Haitis
Heard and mcdonald salos
Honduras
Indija
Britų Indijos okeano teritorijos
Indonesija
Irakas
Iranas
Islandija
Ispanija
Italija
Izraelis
Jamaika
Japonija
Jemenas
Jordanija
Jungtiniai Arabų Emyratai
Us minor outlying islands
Virdžinijos salos (u.s.)
Jungtinės Amerikos Valstijos
Juodkalnija
Kaimanų salos
Kalėdų salos
Kombodža
Kamerūnas
Kanada
Bonaire, Sint Eustatius and Saba
Kataras
Kazachstanas
Kenija
Kinija
Kipras
Kirgiztanas
Karibai
Curacao
Kokosų salos
Kolumbija
Komorai
Kongas
Kongo Demokratinė Resupublika
Kosovas
Kosta Rika
Kroatija
Kuba
Kuko salos
Kuveitas
Laosas
Latvija
Lenkija
Lesotas
Libanas
Liberija
Libija
Lichtenšteinas
Lietuva
Liuksemburgas
Madagaskaras
Mayotte
Makedonija
Malaizija
Malavis
Maldivai
Malis
Malta
Šiaurės marianos salos
Marokas
Martinika
Maršalų salos
Mauricijus
Mauritanija
Meksika
Isle of Man
Birma
Mikronezija
Moldavija
Monakas
Mongolija
Montseratas
Mozambikas
Namibija
Naujoji Kaledonija
Naujoji Zelandija
Nauru
Nepalas
Nigerija
Nigerija
Nikaragva
Niue
Norfolk island
Norvegija
Olandija
Niderlandai
Omanas
Pakistanas
Palau
Palestinian territory, occupied
Panama
Papua naujoji Gvinėja
Paragvajus
Peru
Pietų Afrika
South Georgia and the South Sandwich Salos
Pietų Korėja
Pietų Sudanas
Pitcairn
Portugalija
Prancūzija
Prancuzų Gvinėja
French southern territories
Prancuzų Polinezija
Puerto Riko
Ekvatorinė Gvinėja
Renjunjonas
Ruanda
Rumunija
Rusija
Timor-leste
Solomomų salos
Salvadoras
Samoa
San Marinas
San Tomė ir Principai
Saudo Arabija
Seišeliai
Saint Barthelemy
Saint Martin
Saint Pierre and Miquelon
Senegalas
Saint kitts and nevis
Serbija
Siera Leonė
Singapuras
Sint Maarten
Sirija
Slovakija
Slovėnija
Somalis
Sudanas
Suomija
Surinamas
Svalbard and jan mayen islands
Svazilendas
Tadžikistanas
Tailandas
Taivanis
Tanzanija
Turks and caicos islands
Togas
Tokelau
Tongas
Trinidadas ir Tobagas
Tunisas
Turkija
Turkmėnistanas
Tuvalu
Uganda
Ukraina
Urugvajus
Uzbekistanas
Vakarų Sachara
Vanuatu
Vatikanas (holy see)
Venesuela
Vengrija
Vietnamas
Vokietija
wallis and futuna islands
Hong kongas
Makao
Zambija
Zimbabvė
Čadas
Čekijos respublika
Čilė
Šiaurės Korėja
Šri lanka
St. helena
Švedija
Šveicarija
Sant Vincentas ir Grenadinai
Sent Lusija
Cape Verde
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