cartridge-payments 0.97.0

cartridge-payments
==================

**NOTE:** *Requires cartridge 0.8.2 or higher*
*The shop/checkout.html template has 3 blocks that are required. nav-buttons, before-form, and after-form.*

Cartridge multiple payment options module.

Features
-------------------------

This package lets you specify an optional Primary Payment Processor (in the normal cartridge way) and any number of extra processors. (ones that link out like Paypal Standard or Google Wallet ).

On the payment page the regular form shows up, if enabled, as well as buttons to submit form data out to the secondary payment providers.

Installation
-------------------------

Install the package by running the following command in your virtual environment:

pip install cartridge-payments

Add the following minimum settings to your settings file:

INSTALLED_APPS = (
# ...
"payments.multipayments",
# ...
)

TEMPLATE_CONTEXT_PROCESSORS = (
# ...
"payments.multipayments.context_processors.settings",
# ...
)

# USE or EXTEND the custom callback-uuid form
SHOP_CHECKOUT_FORM_CLASS = 'payments.multipayments.forms.base.CallbackUUIDOrderForm'

# Add the callback_uuid field to orders. This field is helpful for identifying
# orders being checked out.
EXTRA_MODEL_FIELDS = (
# ...
(
"cartridge.shop.models.Order.callback_uuid",
"django.db.models.CharField",
(),
{"blank" : False, "max_length" : 36},
),
# ...
)


# WHEN TRUE, Users will be able to submit payment using the regular paradigm
# as well as the secondary payment processors. WHEN FALSE the regular paradigm
# will be hidden / disabled.
PRIMARY_PAYMENT_PROCESSOR_IN_USE = True

# These processors are forms to submit to remote URLs for processing.
SECONDARY_PAYMENT_PROCESSORS = (
('payment-key1', {
'name' : 'Button Name 1',
'form' : 'dot.separarted.form.Class1'
}),
('payment-key2', {
'name' : 'Button Name 2',
'form' : 'dot.separarted.form.Class2'
})
)

PayPal Configuration
-------------------------

One built-in processor is for PayPal.
PayPal IPN is not implemented by default, but is supported by specifying the `PAYPAL_IPN_URL` setting.

Add PayPal as a secondary payment processor.

SECONDARY_PAYMENT_PROCESSORS = (
# ...
('paypal', {
'name' : 'Pay With Pay-Pal',
'form' : 'payments.multipayments.forms.paypal.PaypalSubmissionForm'
}),
# ...
)

Configure PayPal

# Currency type.
PAYPAL_CURRENCY = "USD"

# Business account email. Sandbox emails look like this.
PAYPAL_BUSINESS = 'seller_XXXXXXXX_biz@example.com'

# Use this to enable https on return URLs. This is strongly recommended! (Except for sandbox)
PAYPAL_RETURN_WITH_HTTPS = True

# Function that returns args for `reverse`.
# URL is sent to PayPal as the for returning to a 'complete' landing page.
PAYPAL_RETURN_URL = lambda cart, uuid, order_form: ('shop_complete', None, None)

# Function that returns args for `reverse`.
# URL is sent to PayPal as the URL to callback to for PayPal IPN.
# Set to None if you do not wish to use IPN.
PAYPAL_IPN_URL = lambda cart, uuid, order_form: ('my_paypal_ipn', None, {'uuid' : uuid})

# URL the secondary-payment-form is submitted to
# Dev example
PAYPAL_SUBMIT_URL = 'https://www.sandbox.paypal.com/cgi-bin/webscr'
# Prod example
PAYPAL_SUBMIT_URL = 'https://www.paypal.com/cgi-bin/webscr'

Google Wallet Configuration
-------------------------

Another built-in processor is for Google Wallet.
Google wallets callbacks are not implemented but are supported because `callback_uuid`'s are
sent to Google Wallet as `merchant-private-data`.

Add Google Wallet as a secondary payment processor.

SECONDARY_PAYMENT_PROCESSORS = (
# ...
('google', {
'name' : 'Pay With Google Wallet',
'form' : 'payments.multipayments.forms.google.GoogleSubmissionForm'
}),
# ...
)

Configure Google Wallet

# URL the secondary-payment-form is submitted to
# Dev example
GOOGLE_CHECKOUT_SUBMIT_URL = \
'https://sandbox.google.com/checkout/api/checkout/v2/checkoutForm/Merchant/<my-merchant-id>'
# Prod example
GOOGLE_CHECKOUT_SUBMIT_URL = \
'https://checkout.google.com/api/checkout/v2/checkout/Merchant/<my-merchant-id>'