Created by Ирина Лемешева, last modified on февр. 25, 2020

ID функции

w_paymentwall_init

Кто может вызывать

Авторизованный пользователь.
Авторизованное приложение.

Принимаемые параметры

sum* – сумма в рублях (не менее 10), на которую необходимо пополнить счет и которая будет размещена на счету пользователя на ЛитРес;
currency – валюта, в которой необходимо инициировать формирование ордера. Если параметр не передан, по умолчанию используются рубли. Допустимые значения:

  • RUB – российские рубли (по умолчанию);
  • USD – доллары США;
  • EUR – евро;
  • PLN – польские злотые;

operation* – тип операции:

  • auth – ручной ввод номера карты и других реквизитов, подразумевается по умолчанию;

ps – параметр, определяющий код платежной системы. Если параметр не передавать, передать только descr, то вернутся все доступные способы оплаты, с зависимостью от ip-адреса. Перечень принимаемых параметров можно посмотреть на сайте Paymentwall. Мы используем:

  • fasterpay – карточная оплата;
  • mobiamo – оплата мобильной коммерцией;
  • przelewy24 – основной способ оплаты для Польши (сработает только для польского ip-адреса);

  • dotpay – хитрые переводы (сработает только для польского ip-адреса);

cardnum – необязательный параметр. Если не передан, будет использована последняя в порядке использования карта;
descr – необязательный параметр. Номер платежной системы, используемый для процессинга карты:

  • 68 - PaymentWall.

Возвращаемые значения

url – https адрес сервера, на который следует отправлять запрос. Приложение обязано должно проверить, что URL указывает именно на HTTPS ресурс. Для каждого обращения к оплате следует заново совершать этот запрос и заново получать URL;
method – метод запроса. Может принимать значения:

  • Redirect - необходимо перенаправить пользователя на url для проведения оплаты;

name – имя кредитного процессинга. Можно продемонстрировать пользователю вместе с доменом из URL;
order_id – номер заказа, к которому будет привязана данная транзакция.

Возможные ошибки

error_code

error_message

Описание

101005method not allowed to userМетод доступен только авторизованным пользователям и приложениям
101019Invalid descrНомер платёжного сервиса descr не передан или не является числом

101123

Указана недопустимая сумма

Введена сумма, не удовлетворяющая условиям запроса

101126

Неверное значение operation

Указано недопустимое значение параметра operation

Пример запроса на сервер

{
  "mobile_app": "4",
  "sid": "5l7fcf3acfct1ucu8tfp9y8ncze66r5c",
  "uilang": "pol",
  "time": "2019-04-25T14:41:57+03:00",
  "sha": "f2d72e6fe865f50f85aad43212607143558309814afd5f30d965500b1dc34121",
  "requests": [
    {
      "id": "paymentwall_init",
      "func": "w_paymentwall_init",
      "param": {
      	"operation": "auth",
      	"sum": "2",
      	"descr": "68",
      	"currency": "PLN"
      }
    }
  ]
}

Пример ответа сервера

{
    "success": true,
    "request_3": {
    	"url": "https://api.paymentwall.com/api/subscription?sign_version=3&CurrencyCode=PLN&widget=p1_1&ag_external_id=1&ag_name=%D0%9F%D0%BE%D0%BF%D0%BE%D0%BB%D0%BD%D0%B5%D0%BD%D0%B8%D0%B5%D0%BD%D0%B0+%D0%9B%D0%B8%D1%82%D0%A0%D0%B5%D1%81&lang=pl&amount=2.00&uid=1055292703&success_url=https%3A%2F%2Fandroid-ebook-cat2.litres.ru%2Fstatic%2Ferror_pages%2Fpayment_ok.html%3Forder%3D1055292703%26uilang%3Dru&pingback_url=https%3A%2F%2Flitres.pl%2Fprocess_paymentwall_pl%2F&key=&ag_type=fixed&sign=",
    	"order_id": "1055292703",
    	"name": "PaymentWall",
    	"method": "Redirect",
    	"success": true
  		 },
   		"time": "2019-04-25T14:41:58+03:00"
}