Metadata-Version: 1.0
Name: mercadopago
Version: 0.0.2
Summary: Mercadopago SDK module for Payments integration
Home-page: https://github.com/mercadopago/sdk-python.git
Author: Horacio Casatti <horacio.casatti@mercadolibre.com>
Author-email: horacio.casatti@mercadolibre.com
License: UNKNOWN
Description: ===============================================
        MercadoPago SDK module for Payments integration
        ===============================================
        
        Usage:
        ======
        
        - Get your **CLIENT_ID** and **CLIENT_SECRET** in the following address:
            - Argentina: `<https://www.mercadopago.com/mla/herramientas/aplicaciones>`_
            - Brazil: `<https://www.mercadopago.com/mlb/ferramentas/aplicacoes>`_
        
        ::
        
            import mercadopago
            import json
        
            mp = mercadopago.MP("CLIENT_ID", "CLIENT_SECRET")
        
        
        Using MercadoPago Checkout
        ==========================
        
        Create a Checkout preference:
        -----------------------------
        
        ::
        
            def index(req, **kwargs):
                preference = {
                    "items": [
                        {
                            "title": "Test",
                            "quantity": 1,
                            "currency_id": "USD",
                            "unit_price": 10.4
                        }
                    ]
                }
        
                preferenceResult = mp.create_preference(preference)
        
                return json.dumps(preferenceResult, indent=4)
        
        
        Get an existent Checkout preference:
        ------------------------------------
        
        ::
        
            def index(req, **kwargs):
                preferenceResult = mp.get_preference("PREFERENCE_ID")
                
                return json.dumps(preferenceResult, indent=4)
        
        
        Update an existent Checkout preference:
        ---------------------------------------
        
        ::
        
            def index(req, **kwargs):
                preference = {
                        "items": [
                            {
                                "title": "Test Modified",
                                "quantity": 1,
                                "currency_id": "USD",
                                "unit_price": 20.4
                            }
                        ]
                    }
                
                preferenceResult = mp.update_preference(id, preference)
                
                return json.dumps(preferenceResult, indent=4)
        
        
        Using MercadoPago Payment
        =========================
        
        Searching:
        ----------
        
        ::
        
            def index(req, **kwargs):
                filters = {
                    "id": None,
                    "site_id": None,
                    "external_reference": None
                }
        
                searchResult = mp.search_payment(filters)
                
                return json.dumps(searchResult, indent=4)
        
        
        Receiving IPN notification:
        ---------------------------
        
        - Go to **Mercadopago IPN configuration**:
            - Argentina: `<https://www.mercadopago.com/mla/herramientas/notificaciones>`_
            - Brazil: `<https://www.mercadopago.com/mlb/ferramentas/notificacoes>`_
        
        ::
        
            import mercadopago
            import json
        
            def index(req, **kwargs):
                mp = mercadopago.MP("CLIENT_ID", "CLIENT_SECRET")
                paymentInfo = mp.get_payment_info (kwargs["id"])
                
                if paymentInfo["status"] == 200:
                    return json.dumps(paymentInfo, indent=4)
                else:
                    return None
        
        
        Cancel (only for pending payments):
        -----------------------------------
        
        ::
        
            def index(req, **kwargs):
                result = mp.cancel_payment("ID")
                
                // Show result
                return json.dumps(result, indent=4)
        
        
        Refund (only for accredited payments):
        --------------------------------------
        
        ::
        
            def index(req, **kwargs):
                result = mp.refund_payment("ID")
                
                // Show result
                return json.dumps(result, indent=4)
        
        
Keywords: api mercadopago checkout payment ipn sdk integration
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: License :: Freely Distributable
