cloudtipsadp 0.13.0

CloudTips Adapter - integration module with API CloudPayments.

cloudtips-adp

CloudTips Adapter позволяет интегрировать прием донатов в Django приложение.

Старт

Установка

pip install cloudtipsadp

Удаление пакета

pip uninstall cloudtipsadp

Зависимости разрешить [^1]

pip install python-dotenv requests python-magic dependency-injector

Настройка переменных окружения

В корне проекта создать файл .env

Файл .env используется для тестов. В production установить переменные окружения уровня сеанса пользователя или системы.

sudo touch .env

Для авторизации на CloudTips добавить настройки в файл .env

placeId - идентификатор вашего заведения (в админке CloudTips)

CTA_GRANT_TYPE=password
CTA_CLIENT_ID=Partner
CTA_USER_NAME=<your_email>
CTA_PASSWORD=<your_password>
CTA_PLACE_ID=<your_placeId>

# Production. Раскомментировать
#CTA_BASE_URL = 'https://identity.cloudtips.ru'
#CTA_BASE_URL_API = 'https://api.cloudtips.ru/api'

# Production. Закомментировать
CTA_BASE_URL = 'https://identity-sandbox.cloudtips.ru'
CTA_BASE_URL_API = 'https://api-sandbox.cloudtips.ru'

Работа с пакетом

Подключение

from cloudtipsadp import Cloudtipsadp

cta = Cloudtipsadp()

Получатель

Создать получателя донатов

response = cta.receivers_create(name, phone_number)

Удалить получателя из скоупа

response = cta.receivers_detach_agent(user_id)

Все получатели донатов

response = cta.receivers_pages()

Загрузка фотографии получателя

response = cta.receivers_photo(user_id, photo_path)

Вариант просмотра результата ответа сервера

if type(response) == dict and response.get('succeed'):
    print(response.get('data'))
else:
    print(response)

Заведения

Информация по всем заведениям ТСП

response = cta.places_get()

Привязка получателя к заведению. Отправить сотруднику на его номер телефона код в смс сообщении.

response = cta.places_send_sms(user_id)

Подтверждение привязки телефона (пользователя) к предприятию. Передать код из смс.

response = cta.places_confirm(user_id, code)

Карты

Список карт получателя

response = cta.cards_get(user_id)

Отправить криптограмму

response = cta.cards_auth(user_id, checkout)

Изменить карту, которая по умолчанию

response = cta.cards_default(user_id, card_token)

Удаление карты получателя. Карту по умолчанию удалить нельзя

response = cta.cards_delete(user_id, card_token)

Накопления

Накопления по получателю

response = cta.accums_summary(user_id)

Выплата накопления получателю

response = cta.accums_payout_receiver(user_id)

Транзакции

Получение всех транзакций выплат получателям менеджера

response = cta.payouts()

Возможные проблемы

---

[^1]: Если возникли проблемы с установкой пакета python-magic на macos установите:

brew install libmagic 
pip uninstall python-magic
pip install python-magic-bin