Metadata-Version: 1.0
Name: django-oscar-asiapay
Version: 0.2
Summary: Payment integration of AsiaPay (PayDollar) to use on django-oscar

Home-page: https://github.com/bitmazk/django-oscar-asiapay
Author: Tobias Lorenz
Author-email: tobias.lorenz@bitmazk.com
License: The MIT License
Description: AsiaPay package for django-oscar
        ================================
        
        Payment integration of AsiaPay's PayDollar.
        
        
        Installation
        ------------
        
        Prerequisites:
        
        * Django
        * django-oscar
        
        If you want to install the latest stable release from PyPi::
        
            $ pip install django-oscar-asiapay
        
        If you feel adventurous and want to install the latest commit from GitHub::
        
            $ pip install -e git://github.com/bitmazk/django-oscar-asiapay.git#egg=asiapay
        
        Add ``django-oscar-asiapay`` to your ``INSTALLED_APPS``::
        
            INSTALLED_APPS = (
                ...,
                'oscar',
                'asiapay',
            )
        
        Hook this app into your ``urls.py``::
        
            urlpatterns = patterns('',
                ...
                url(r'^asiapay/', include('asiapay.urls')),
            )
        
        Run the South migrations::
        
            ./manage.py migrate asiapay
        
        
        Usage
        -----
        
        Please make sure you have installed ``django-oscar`` (up and running).
        You can easily customize oscar by overwriting its apps. Please check oscar's
        docs if you don't know what I'm talking about.
        
        To use AsiaPay please check the directory ``oscar_integration_example``.
        
        Basically the ``OscarPaymentDetailsView`` has been overwritten, so the user
        will be re-directed to AsiaPay after confirming the checkout. We've customized
        the ``preview.html`` template::
        
        	<form method="post" action="{{ asiapay_url }}">
        		{% csrf_token %}
        		<input type="hidden" name="merchantId" value="{{ merchant_id }}">
        		<input type="hidden" name="currCode" value="{{ currency_code }}">
        		<input type="hidden" name="orderRef" value="{{ order_number }}">
        		<input type="hidden" name="amount" value="{{ order_total.incl_tax }}">
        		<input type="hidden" name="successUrl" value="{{ success_url }}">
        		<input type="hidden" name="failUrl" value="{{ fail_url }}">
        		<input type="hidden" name="errorUrl" value="{{ error_url }}">
        		<input type="hidden" name="lang" value="{{ asiapay_lang }}">
        		<input type="hidden" name="payType" value="{{ asiapay_paytype }}">
        		<img src="https://raw.githubusercontent.com/bitmazk/django-oscar-asiapay/master/payv_logo.gif" alt="{% trans "AsiaPay" %}" />
        		<button id='place-order' type="submit" class="btn btn-primary btn-block js-disable-on-click" data-loading-text="{% trans "Sending..." %}">{% trans "Submit" %}</button>
        	</form>
        
        Settings
        --------
        
        ASIAPAY_PAYDOLLAR_URL
        +++++++++++++++++++++
        
        URL to connect to AsiaPay. Testing url::
        
            https://test.paydollar.com/b2cDemo/eng/payment/payForm.jsp
        
        Production url::
        
            https://www.paydollar.com/b2c2/eng/payment/payForm.jsp
        
        
        ASIAPAY_CURRENCY_CODE
        +++++++++++++++++++++
        
        Default: '702'
        
        Currency you want to use. Please check the PayDollar Integration Guide.
        
        ASIAPAY_LANGUAGE
        ++++++++++++++++
        
        Default: 'E'
        
        Language of the payment page.
        
        - 'C': Traditional Chinese
        - 'E': English
        - 'F': French
        - 'G': German
        - 'J': Japanese
        - 'R': Russian
        - 'S': Spanish
        - 'T': Thai
        - 'V': Vietnamese
        - 'X': Simplified Chinese
        
        ASIAPAY_LOCALTEST_URL
        +++++++++++++++++++++
        
        Use this setting to test a response from AsiaPay locally. We can recommend
        ``ngrok`` to mask localhost.
        
        ASIAPAY_CALLBACK_HTTPS
        ++++++++++++++++++++++
        
        Default: True
        
        Use ``https`` (True) or ``http`` (False) to construct reponse urls.
        
        ASIAPAY_PAYTYPE
        +++++++++++++++
        
        Default: 'N'
        
        Paytype you want to use. Please check the PayDollar Integration Guide.
        
        
        Roadmap
        -------
        
        Check the issue tracker on github for milestones and features to come.
        
Keywords: django,oscar,payment,paydollar,asiapay
Platform: OS Independent
