Need help with mamona?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

123 Stars 17 Forks 65 Commits 3 Opened issues


Fully portable Django payments application that can use any Order/Cart model.

Services available


Need anything else?

Contributors list

# 92,172
53 commits
# 276,019
5 commits
# 11,487
2 commits



Fully portable Django payments application

Mamona is a Django application for handling online payments. It can work with any existing setup without a need of changing other applications' models.

Features: * accepts any model as order and creates ForeignKey relation to it, * requires no interface on order model, * can handle different payment gateways, just by enabling backends (at the moment, only PayPal and testing "dummy" backends are present), * can pass items list and customer data to the payment gateway, * offers signals to watch payment progress.

Any model as order, really?

Yes, thanks to great

__ we can attach Payment model to any other model, which represents an order, single item, subscription plan, donation... whatever. We're not using generic relations here, but good old ForeignKey which makes your data consistent on DB level.

There are no interface requirements regarding the order model (it doesn't need to be called order, either). The only thing you have to do, is to implement basic set of signal listeners which extract essential data from your order.

These signals can reside in a standalone application, so there is no need to touch the code of the app containing order model.

OK, tell me how to use it!

First of all, you have to install Mamona and add it to your

Second, you should enable the backends in
and configure essential parameters for gateways. The following example is for testing purposes, using PayPal sandbox server and a test module called dummy.


    'paypal': {
        'url': '',
        'email': '[email protected]',

Third, knowing how your order model and it's environment is organized, you need to implement listeners for two signals:

* ``return_urls_query``, where you provide return URLs for successful and failed
* ``order_items_query``, where you fill a list of order items (or just return single
  item for simple orders).

Finally, build a Payment model connected together with your order model:


from mamona.models import build_payment_model

Payment = build_payment_model(MyOrderModel, unique=True, related_name='payments')

To check an example implementation, see

. And also refer to the source code of Mamona itself.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.