Skip to main content

Generic Yandex.Kassa application for Django

Project description

https://travis-ci.org/bzzzzzz/django-yandex-cash-register.svg?branch=master Code Climate Test Coverage

Простое приложение для подключения в Django оплаты через Яндекс.Кассу. Поддерживает Python 2.7, 3.4 и 3.5. Совместимо со всеми версиями Django>=1.8.

В приложении реализован протокол интеграции, описанный в официальной документации

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

Перед тем приступить к настройке приложения, убедитесь, что у вас уже есть аккаунт в kassa.yandex.ru и вы знаете SCID, ShopID и платежный пароль.

  1. Устанавливаем пакет:

    pip install django-yandex-cash-register
  2. Добавляем приложение yandex_cash_register в settings.INSTALLED_APPS:

    INSTALLED_APPS = (
        ...
        'yandex_cash_register',
        ...
    )
  3. Указываем в settings.py следующие настройки:

    # True - Использование тестого платежного сервиса, False - основного
    YANDEX_CR_DEBUG = False
    # Идентификатор магазина, полученный в Яндекс.Кассе
    YANDEX_CR_SCID = 12345
    # Идентификатор витрины магазина, полученный в Яндекс.Кассе
    YANDEX_CR_SHOP_ID = 123456
    # Платежный пароль магазина
    YANDEX_CR_SHOP_PASSWORD = 'password'
    # Идентификаторы используемых видов оплаты (https://tech.yandex.ru/money/doc/payment-solution/reference/payment-type-codes-docpage/)
    YANDEX_CR_PAYMENT_TYPE = ['pc', 'ac', 'wm']
    # Название модели заказа. Модель должна соответствовать
    # интерфейсу yandex_cash_register.interfaces.IPayableOrder
    YANDEX_CR_ORDER_MODEL = 'your_app.Order'
    # Публичный домен магазина
    YANDEX_CR_SHOP_DOMAIN = 'https://example.com'
  4. Создаем таблицы в базе данных:

    python manage.py migrate
  5. Добавляем приложение в urls.py, обязательно указывая namespace и app_name:

    url(r'^money/', include('yandex_cash_register.urls',
                            namespace='yandex_cash_register',
                            app_name='yandex_cash_register')),
  6. Если ваш домен example.com и вы указали money как урл приложения, то ваш checkURL в настройках должен быть https://example.com/money/order-check/, а paymentAvisoURL - https://example.com/money/payment-aviso/. URL успеха и провала платежа указывать не нужно.

Использование

  1. Первым делом нужно имплементировать интерфейс yandex_cash_register.interfaces.IPayableOrder в модели заказа своего приложения для того, чтобы по завершении платежа вернуть клиента на соответствующую страницу.

  2. Для создания платежа достаточно знать уникальный идентификатор заказа, почтовый адрес и телефон клиента (требование Яндекс.Кассы), а также сумму заказа и (опционально) выбранный клиентом способ оплаты:

    from yandex_cash_register.models import Payment
    
    payment = Payment(
        order_sum=Decimal('100.50'),  # Сумма к оплате
        order_id='unique_id',  # Идентификатор заказа
        cps_email='customer@example.com',  # Почтовый адрес клиента
        cps_phone='70000000000',  # Телефон клиента, 11 цифр без символов
        payment_type='wm',  # Способ оплаты (опционален), если его не задать,
                            # клиент будет выбирать его на стороне Яндекс.Кассы
    )
    payment.save()
    
    # После создания заказа можно получить платежную форму, которую нужно отобразить клиенту
    # c method="post" и target="yandex_cash_register.conf.TARGET"
    # После ее сабмита (можно это сделать автоматически) клиент попадет в
    # интерфейс Яндекс.Кассы, где сможет завершить платеж
    form = payment.form()
  3. Для получения информации о результатах оплаты, нужно начать слушать сигналы из модуля yandex_cash_register.signals. В наличии три сигнала:

    • payment_process - отсылается при получении Яндекс.Кассой информации о платеже

    • payment_success - отсылается при успешном платеже

    • payment_fail - отсылается при ошибочном платеже

    В качестве sender сигнала выступает объект yandex_cash_register.Payment, для которого этот сигнал актуален.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-yandex-cash-register-0.1.5.tar.gz (20.6 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page