cloudtips-adp

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

Старт

Установка

pip install cloudtipsadp

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

pip uninstall cloudtipsadp

Зависимости разрешить ¹

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

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

Подключение

import cloudtipsadp as cta

Получатель

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

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)

Для проведения 3-D Secure аутентификации

response = cta.cards_3ds(user_id, md, paReq)

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

response = cta.cards_default(user_id, card_token)

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

response = cta.cards_delete(user_id, card_token)

Подтвердить привязку карты на стороне системы

response = cta.cards_add(user_id, transact_id)

Накопления

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

response = cta.accums_summary(user_id)

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

response = cta.accums_payout_receiver(user_id)

Транзакции

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

response = cta.payouts()

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

---

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

Footnotes

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