Методы оплаты
Вы можете получить список доступных способов оплаты для вашего проекта в режиме реального времени, перед перенаправлением пользователя на систему Paysera. Это может быть полезным, если вы отображаете список методов оплаты на вашем сайте - в этом случае, Вам не придется обновлять конфигурацию каждый раз, когда что-то измениться.
Кроме того, для каждого доступного способа оплаты указываются минимальные и максимальные суммы. Это позволяет показывать только те способы оплаты, которые актуальны для конкретного покупателя.
Извлечение способов оплаты осуществляется в библиотеке WebToPay. Убедитесь, что у Вас есть последняя версия библиотеки - это функциональность еще не была реализована в 1.5 версии.
Способы оплаты
Логотип оплаты для колонтитула
Введите страну для отображения:
Страна
Австралия
Австрия
Азербайджан
Аландские острова
Албания
Алжир
Самоа(США)
Ангилья
Ангола
Андорра
Антарктика
Антигуа и Барбуда
Аргентина
Армения
Аруба
Афганистан
Багамы
Бангладеш
Барбадос
Бахрейн
Беларусь
Белиз
Бельгия
Бенин
Бермуды
Болгария
Боливия
Бонэйр, Синт-Эстатиус и Саба
Босния и Герцеговина
Ботсвана
Бразилия
Старые Британские Индийские Территории
Бруней
Буркина-Фасо
Бурунди
Бутан
Вануату
Ватикан
Великобритания
Венгрия
Венесуэла
Вирджинские острова (Брит.)
Вирджинские острова (США)
Внешние малые острова (США)
Восточный Тимор
Вьетнам
Габон
Гаити
Гайана
Гамбия
Гана
Гваделупа
Гватемала
Гвинея
Гвинея-Бисау
Германия
Гернси
Гибралтар
Гондурас
Гонг Конг
Гренада
Гренландия
Греция
Грузия
Гуам
Дания
Джерси
Джибути
Доминика
Доминиканская Республика
Египет
Замбия
Западная Сахара
Зимбабве
Израйль
Индия
Индонезия
Иордания
Ирак
Иран
Ирландия
Исландия
Испания
Италия
Йемен
Северная Корея
Кабо-Верде
Казахстан
Каймановы острова
Камбоджа
Камерун
Канада
Катар
Кения
Кипр
Кыргызстан
Кирибати
Китай
Кокосовые острова
Колумбия
Коморос
Конго
Демократическая Республика Конго
Косово
Коста Рикa
Берег Слоновой Кости
Куба
Кувейт
Кюрасао
Лаос
Латвия
Лесото
Либерия
Ливан
Ливия
Литва
Лихтейнштейн
Люксембург
Мавритий
Мавритания
Мадагаскар
Мейот
Макау
Македония
Малави
Малайзия
Мали
Мальдивские острова
Мальта
Марокко
Мартиника
Маршалловы острова
Мексика
Мозамбик
Молдова
Монако
Монголия
Монсеррат
Мьянма
Намибия
Науру
Непал
Нигер
Нигерия
Нидерланды
Никарагуа
Ниуэ
Новая Зеландия
Новая Каледония
Норвегия
Боуветские острова
Мэн
Норфолк, остров
Рождественские острова
Остров Св.Елены
Острова Кука
Теркс и Кайкос
Острова Хэрда и МакДональда
Объединённые Арабские Эмираты
Оман
Пакистан
Палау
Палестина
Панама
Папуа Новая Гвинея
Парагвай
Перу
Питкерн
Польша
Португалия
Пуэрто-Рико
Южная Корея
Реюньон
Российская Федерация
Руанда
Румыния
Сальвадор
Samoa
Сан-Марино
Сан-Томе и Принсипи
Саудовская Аравия
Свазиленд
Северные Марианские острова
Сейшеллы
Сент-Бартельми
Сент-Мартин
Сен-Пьер и Микелон
Сенегал
Сент-Висент и Гренадины
Сент-Киттс Нэвис Ангуилла
Санта Лючия
Сербия
Сингапур
Синт-Мартен
Сирия
Словакия
Словения
США
Соломоновы острова
Сомали
Судан
Суринам
Сьерра-Леоне
Таджикистан
Таиланд
Тайвань
Танзания
Того
Токелау
Тонга
Тринидад и Тобаго
Тувалу
Тунис
Туркменистан
Турция
Уганда
Узбекистан
Украина
Уоллис и Футуна
Уругвай
Фарерские острова
Микронезия
Фиджи
Филиппины
Финляндия
Фолклендские острова
Франция
Гайана
Полинезия
Французские южные территории
Хорватия
Центрально-Африканская Республика
Чад
Чepнoгopия
Чешская Республика
Чили
Швейцария
Швеция
Сволборд и Ян Майен
Шри Ланка
Эквадор
Экваториальная Гвинея
Эритрея
Эстония
Эфиопия
Южная Африка
Южная Джорджия и Южные Сэндвичевы острова
Южный Судан
Ямайка
Япония
Получение доступных способов оплаты с помощью библиотеки WebToPay
Информация о способах оплаты хранится в специальной категории. Это позволяет управлять данными с большей легкостью и получать необходимую информацию быстрее. Поскольку минимальные и максимальные суммы платежа предоставлены, получая способы оплаты Вам необходимо указать не только ID проекта, но и валюту.
<?php $paymentMethodsInfo = WebToPay::getPaymentMethodList($projectid, $currency);
Информация о способах оплаты разделена на 4 уровня:
-
WebToPay_PaymentMethodList- содержит всю доступную информацию. МетодWebToPay::getPaymentMethodListвозвращает объекты этой категории.
Методы категории:-
filterForAmount($amount, $currency)возвращает новый случай категорииWebToPay_PaymentMethodListтолько с теми типами платежей, которые доступны по указанной цене. -
getCountries()возвращает массив объектовWebToPay_PaymentMethodCountry -
getCountry($countryCode)возвращает один объектWebToPay_PaymentMethodCountry -
setDefaultLanguage($language)устанавливает язык по умолчанию для целого дерева объектов. Язык по умолчанию используется для названий и адресов логотипов. Язык может быть передан и для конкретных методов, возвращающих названия.
-
-
WebToPay_PaymentMethodCountry— информация о типах платежей в стране.
Методы категории:-
getTitle()возвращает название страны. -
getGroups()возвращает массив объектовWebToPay_PaymentMethodGroup. -
getPaymentMethods()возвращает массив объектовWebToPay_PaymentMethod. Берутся все методы платежей с каждой группы в стране. Используйте этот метод если не хотите делить способы оплаты на группы.
-
-
WebToPay_PaymentMethodGroup— информация о типах платежей для группы.
Методы категории:-
getTitle()возвращает название группы. -
getPaymentMethods()возвращает массив объектовWebToPay_PaymentMethod.
-
-
WebToPay_PaymentMethod— информация о типе платежа.
Методы категории:-
getKey()возвращает идентификатор этого типа платежа. Он должен быть передан во время запроса на систему Paysera. -
getTitle()возвращает название этого типа платежа; -
getLogoUrl()возвращает адрес логотипа для этого типа платежа. Возвращает нуль если логотип недоступен. -
isAvailableForAmount($amount, $currency)устонавливает доступен ли этот тип платежа для указанной суммы. Если типы платежей фильтруются с помощью методаWebToPay_PaymentMethodList::filterForAmount, повторно проверять нет смысла.
-
Пример как можно предоставить доступные типы платежей для конкретной суммы в Литве, без группировки:
<?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 />';
}
Пример как можно предоставить все возможные способы оплаты в каждой стране по их группам, лишая возможности выбрать недоступные способы оплаты:
<?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 />';
}
}
}
Получение доступных способов оплаты не используя библиотеки WebToPay
Если Ваш проект написан не на языке PHP, вы можете получить способы оплаты через тот же интерфейс, который использует библиотека WebToPay.
Типы платежей предоставлены в формате XML, по следующему адресу:
https://www.paysera.com/new/api/paymentMethods/yourProjectId/currency:desiredCurrency/amount:desiredAmount/language:desiredLanguage
Все параметры за исключением yourProjectId не обязательны. Вы также можете предоставить только один или несколько из них в любом порядке.
-
desiredCurrency— валюта, в которой будут указаны минимальные и максимальные возможные суммы. Если не установлена, суммы предоставляются в евро. -
desiredAmount— предоставляются только те типы платежей, которые доступны для указанной суммы. Сумма должна быть в центах. -
desiredLanguage— названия предоставляются только на этом языйе. Если не установлен, названия предоставляются на всех доступных языках.
На пример, если Вы хотите получить те способы оплаты, которые доступны для платежа на 10000 EUR, используйте следующий адрес (допустим ID проекта 6028):
https://www.paysera.com/new/api/paymentMethods/6028/currency:EUR/amount:1000000