Как пользоваться API QIWI Мастера

Как пользоваться API QIWI Мастера

Для автоматического управления картами в рамках пакета QIWI Master используйте API. С помощью API вы сможете:

  • Подключите мастер-пакет QIWI
  • Выпускать и блокировать виртуальную карту немедленно
  • Получить выписки и подробную информацию
  • Переименовать карты

Для настройки и работы с API вам потребуются базовые знания программирования на PHP или Python. Далее мы расскажем вам шаг за шагом, как отправлять запросы и обрабатывать ответы от службы QIWI. В примерах мы будем использовать язык программирования PHP. Для удобства скопируйте код в свой рабочий файл.

Установка и настройка сервера

Пропустите этот шаг, если вы знаете, как запустить сервер на локальном компьютере или в службе хостинга.

Вам необходимо настроить сервер для отправки запросов к API и обработки ответов. Давайте узнаем, как установить сервер Apache и подготовить его к работе с API на вашем локальном компьютере или арендовать сервер в Интернете.

Сервер на персональном компьютере

    Установите программное обеспечение XAMPP для Windows или Mac.

После установки откройте панель управления XAMPP (ярлык появится на рабочем столе) и запустите сервер Apache.

alt_text

Затем в папке C:ymampp создайте папку для своего проекта, например master-api. В эту папку поместите исполняемые файлы вашей программы.

alt_text

В корне папки создайте файл index.php со следующим содержанием:

Бот для работы с QIWI токеном | Как использовать киви токен

и сохранить его.

alt_text

  • В любом браузере откройте http://localhost/master-api.
  • В вашем браузере появится следующий текст: Это сработало.

    alt_text

    Аренда сервера у хостинг-компании

    Этот метод быстрее, но вам понадобится свободный домен, с которого будут отправляться запросы. Некоторые хостинговые компании предлагают домен бесплатно при покупке хостинга. Рекомендуется использовать SSL-сертификат и отправлять запросы по протоколу https. SSL-сертификат необходим для того, чтобы ваш трафик не был расшифрован, а ваши данные не были скомпрометированы во время передачи.

    Для работы с API вам потребуется оплатить любой виртуальный хостинг с поддержкой PHP-сценариев и интерфейсом cPanel (например, тариф Host-A от Reg.ru). Виртуальные серверы VDS также будут работать, но на их настройку потребуется больше времени.

    После приобретения хостинга откройте панель администратора cPanel (доступ будет выслан вам по электронной почте).

    Если вы приобрели хостинг с доменом — ничего настраивать не нужно. Перейдите в файловый менеджер.

    alt_text

    В корневом каталоге вашего домена создайте файл index.php со следующим содержанием:

    РАБОТА С QIWI на PYTHON | QIWI API | SIMPLE QIWI

    В браузере откройте https://вашдомен.ru/ . Если все пройдет успешно, вы увидите текст:

    Подготовка к работе с API

    Перед отправкой запросов к API необходимо получить специальный токен — это ключ доступа к вашему кошельку. Токен можно получить на сайте https://qiwi.com/api . При создании маркера проверьте следующие разрешения:

    • Управление виртуальными картами,
    • Запросите информацию о профиле кошелька,
    • Просмотр истории платежей,
    • Осуществляйте платежи без SMS.

    alt_text

    Отправка запросов и обработка ответа

    Каждый запрос содержит заголовки и тело запроса. Тип запроса и маркер авторизации передаются в заголовках, а тело содержит данные, которые должны быть отправлены на сервер.

    alt_text

    Покупка пакета QIWI мастер

    Код заказа для приобретения пакета QIWI Master:

    В теле запроса передайте объект Payment и дополнительные обязательные поля:

    • fields.account — номер вашего кошелька
    • fields.vas_alias — «qvc-master»

    Справа показан пример PHP-запроса, который выводит статус покупки пакета. Скопируйте этот код в файл index.php и перейдите на страницу в браузере:

    • http://localhost/master-api/index.php — если вы работаете на локальном сервере, или
    • http://вашсайт.ru/index.php — если у вас виртуальный хостинг.

    После выполнения скрипта статус транзакции появится в вашем браузере.

    Покупка карты

    Шаг 1. Создание заказа

    Код запроса для создания карточного заказа в рамках пакета QIWI Master

    Отправьте POST-запрос на:

    В ссылке запроса введите номер кошелька с приобретенным пакетом QIWI Master. В теле запроса отправьте параметр cardAlias с возможными значениями:

    • «qvc-cpa» — виртуальную карту за 99 рублей.
    • «qvc-cpa-debit» — виртуальная карта за 199 рублей.

    В ответ будет выслан номер заказа, который понадобится вам для второго шага.

    Шаг 2. Подтверждение заказа карты

    Код подтверждения для заказа по карте QIWI Master Card

    Отправьте PUT-запрос на:

    https://edge.qiwi.com/cards/v2/persons/ /приказы/ /отправка

    В ссылке запроса укажите номер кошелька с купленным QIWI Master и номер заказа из ответа на предыдущем шаге (поле id ). Не указывайте ничего в теле запроса.

    Успешный ответ на запрос будет содержать информацию о статусе заказа.

    Шаг 3. Покупка карты

    Отправка POST-запроса на адрес:

    Тело запроса содержит JSON-объект Payment , в который необходимо передать обязательные значения:

    • id — уникальный номер операции, задаваемый пользователем;
    • sum->amount — сумма платежа;
    • sum->currency — код валюты (643 означает рубли);
    • paymentMethod->type — откуда придет платеж (Account означает платеж со счета кошелька);
    • paymentMethod->accountId — код валюты счета (643 означает, что это рублевый счет);
    • fields->account — номер кошелька;
    • fields->order_id — номер подтвержденного заказа из шага 2.

    Список карт с реквизитами

    Код для вывода номера карты, CVV и даты истечения срока действия

    Чтобы получить список карт, отправьте GET-запрос без параметров по адресу

    Чтобы получить данные карты (PAN и CVV), отправьте отдельный PUT-запрос по адресу

    • cardID — идентификатор карты в списке карт;
    • operationId — любой уникальный идентификатор операции, например, время.
    Рейтинг
    ( Пока оценок нет )
    Понравилась статья? Поделиться с друзьями: