Metadata-Version: 2.1
Name: django-vr-payment
Version: 0.2.8
Summary: A Django app to handle payment request through vr payment.
Home-page: https://github.com/ParticulateSolutions/django-vr-payment
Author: Particulate Solutions GmbH
Author-email: tech@particulate.me
License: MIT
Platform: UNKNOWN
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Description-Content-Type: text/markdown
License-File: LICENSE

Django VR Payment Copy + Pay
============================

Implementation of [VR Payment Copy + Pay](https://vr-pay-ecommerce.docs.oppwa.com/tutorials/integration-guide).
The following doc explain how to set up the VR Payment Copy + Pay base tutorial.

Quick start
-----------

1. Add "django_vr_payment" to your INSTALLED_APPS setting like this::

    INSTALLED_APPS = [
        ...
        'django_vr_payment',
    ]

2. (optional) Include the vr-payment URLconf in your project urls.py like this::

    path('vr-payment/', include('django_vr_payment.urls')),

3. Run ``python manage.py migrate`` to create the vr-payment models.

4. Prepare a checkout:

    ```python
    from django_vr_payment.wrapper import VRPaymentWrapper

    vr_payment_wrapper = VRPaymentWrapper()
    basic_payment = vr_payment_wrapper.create_checkout(amount=<Decimal>, payment_type=<VRPaymentBasicPayment.PAYMENT_TYPE>, merchant_transaction_id=<UNIQUE_ID>)

    # the checkout_id for the VR Payment Copy&Pay form can be obtained through `checkout_id`
    checkout_id_for_forms = basic_payment.checkout_id
    ```

5. Pay via a payment form of your choice. A working example can be seen in `VRPaymentBasicCheckoutView`

6. Get the payment status:

    On return to `VR_PAYMENT_SHOPPER_RESULT_URL_NAME`, the app tries to get the status of a checkout object. You can also query VR Payment yourself:

    ```python
    from django_vr_payment.models import VRPaymentBasicPayment
    from django_vr_payment.wrapper import VRPaymentWrapper

    vr_payment_wrapper = VRPaymentWrapper()
    basic_payment = VRPaymentBasicPayment.objects.get(checkout_id=<CheckoutID>)

    # get 'initial' status querying the checkout api
    payment_status = vr_payment_wrapper.get_checkout_status(basic_payment)

    # or query transaction api either by vr_payment_checkout.payment_id or vr_payment_checkout.merchant_transaction_id
    payment_status = vr_payment_wrapper.get_transaction_by_merchant_transaction_id(basic_payment)
    ```

Copyright and license

Copyright 2020 Particulate Solutions GmbH, under MIT license.


