Release/2.3.0

.github/workflows/ci.yml

@@ -14,7 +14,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        python-version: ['3.7', '3.8', '3.9', '3.10', '3.11', '3.12']
+        python-version: ['3.9', '3.10', '3.11', '3.12']
 
     steps:
     - uses: actions/checkout@v2

.pre-commit-config.yaml

@@ -0,0 +1,16 @@
+repos:
+  - repo: https://github.com/melisource/fury_websec-git-hooks
+    rev: v2.0.0
+    hooks:
+      - id: pre_commit_hook
+        stages: [commit]
+      - id: post_commit_hook
+        stages: [post-commit]
+
+  - repo: https://github.com/melisource/fury_datasec-git-hooks
+    rev:  1.2.2
+    hooks:
+      - id: pre_commit_hook
+        stages: [commit]
+      - id: post_commit_hook
+        stages: [post-commit]

mercadopago/config/config.py

@@ -10,7 +10,7 @@ class Config:
     """
 
     def __init__(self):
-        self.__version = "2.2.3"
+        self.__version = "2.3.0"
         self.__user_agent = "MercadoPago Python SDK v" + self.__version
         self.__product_id = "bc32bpftrpp001u8nhlg"
         self.__tracking_id = "platform:" + platform.python_version()

mercadopago/config/request_options.py

@@ -21,7 +21,8 @@ class RequestOptions:  # pylint: disable=too-many-instance-attributes
     __integrator_id = None
     __platform_id = None
 
-    def __init__(  # pylint: disable=too-many-arguments
+    def __init__(  # pylint: disable=too-many-positional-arguments
+    # pylint: disable=too-many-arguments
         self,
         access_token=None,
         connection_timeout=60.0,

mercadopago/examples/order/cancel_order.py

@@ -0,0 +1,67 @@
+import os
+import time
+
+from mercadopago import SDK
+
+def main():
+    # Define the authentication token
+    access_token = "<YOUR_ACCESS_TOKEN>"
+
+    # Define the authentication token
+    sdk = SDK(access_token)
+
+    # Create a test card token
+    def create_test_card():
+        card_token_object = {
+            "card_number": "5031433215406351",
+            "security_code": "123",
+            "expiration_year": "2030",
+            "expiration_month": "11",
+            "cardholder": {"name": "APRO"}
+        }
+        card_token_created = sdk.card_token().create(card_token_object)
+        return card_token_created["response"]["id"]
+
+    # Create an order object
+    card_token_id = create_test_card()
+    order_object = {
+        "type": "online",
+        "capture_mode": "manual",
+        "processing_mode": "automatic",
+        "total_amount": "880.00",
+        "external_reference": "ext_ref_1234",
+        "transactions": {
+            "payments": [
+                {
+                    "amount": "880.00",
+                    "payment_method": {
+                        "id": "master",
+                        "type": "credit_card",
+                        "token": card_token_id,
+                        "installments": 2
+                    }
+                }
+            ]
+        },
+        "payer": {
+            "email": "<PAYER_EMAIL>"
+        }
+    }
+
+    try:
+        # Call the method to create the order
+        response = sdk.order().create(order_object)
+        print("Order created successfully")
+
+        # Get the order ID from the response
+        order_id = response["response"]["id"]
+
+        time.sleep(5)
+        # Call the method to CANCEL
+        order_details = sdk.order().cancel(order_id)
+        print("Order details:", order_details["response"])
+    except Exception as e:
+        print("Error:", e)
+
+if __name__ == "__main__":
+    main()

mercadopago/examples/order/capture_order.py

@@ -0,0 +1,64 @@
+import os
+from mercadopago import SDK
+
+def main():
+    # Define the authentication token
+    access_token = "<YOUR_ACCESS_TOKEN>"
+
+    # Define the authentication token
+    sdk = SDK(access_token)
+
+    # Create a test card token
+    def create_test_card():
+        card_token_object = {
+            "card_number": "5031433215406351",
+            "security_code": "123",
+            "expiration_year": "2030",
+            "expiration_month": "11",
+            "cardholder": {"name": "APRO"}
+        }
+        card_token_created = sdk.card_token().create(card_token_object)
+        return card_token_created["response"]["id"]
+
+    # Create an order object
+    card_token_id = create_test_card()
+    order_object = {
+        "type": "online",
+        "capture_mode": "manual", # Mode need to be Manual to use Capture Method.
+        "processing_mode": "automatic",
+        "total_amount": "880.00",
+        "external_reference": "ext_ref_1234",
+        "transactions": {
+            "payments": [
+                {
+                    "amount": "880.00",
+                    "payment_method": {
+                        "id": "master",
+                        "type": "credit_card",
+                        "token": card_token_id,
+                        "installments": 2
+                    }
+                }
+            ]
+        },
+        "payer": {
+            "email": "<PAYER_EMAIL>"
+        }
+    }
+
+    try:
+        # Call the method to create the order
+        response = sdk.order().create(order_object)
+        print("Order created successfully")
+
+        # Get the order ID from the response
+        order_id = response["response"]["id"]
+
+        # Call the method to CAPTURE the order
+        order_details = sdk.order().capture(order_id)
+        print("Order details:", order_details["response"])
+    except Exception as e:
+        print("Error:", e)
+
+if __name__ == "__main__":
+    main()

mercadopago/examples/order/create_order.py

@@ -0,0 +1,56 @@
+from mercadopago import SDK
+
+
+def main():
+   # Define the authentication token
+    access_token = "<YOUR_ACCESS_TOKEN>"
+
+   # Define the authentication token
+    sdk = SDK(access_token)
+
+   # Create a test card token
+    def create_test_card():
+        card_token_object = {
+            "card_number": "5031433215406351",
+            "security_code": "123",
+            "expiration_year": "2030",
+            "expiration_month": "11",
+            "cardholder": {"name": "APRO"}
+        }
+        card_token_created = sdk.card_token().create(card_token_object)
+        return card_token_created["response"]["id"]
+
+   # Create an order object
+    card_token_id = create_test_card()
+    order_object = {
+        "type": "online",
+        "total_amount": "880.00",
+        "external_reference": "ext_ref_1234",
+        "transactions": {
+            "payments": [
+                {
+                    "amount": "880.00",
+                    "payment_method": {
+                        "id": "master",
+                        "type": "credit_card",
+                        "token": card_token_id,
+                        "installments": 2
+                    }
+                }
+            ]
+        },
+        "payer": {
+            "email": "<PAYER_EMAIL>"
+        }
+    }
+
+    try:
+       # Call the method to create the order
+        response = sdk.order().create(order_object)
+        print("Order created successfully:", response["response"])
+    except Exception as e:
+        print("Error:", e)
+
+
+if __name__ == "__main__":
+    main()

mercadopago/examples/order/create_transaction.py

@@ -0,0 +1,65 @@
+import os
+import time
+
+from mercadopago import SDK
+
+def main():
+    # Define the authentication token
+    access_token = "<YOUR_ACCESS_TOKEN>"
+
+    # Define the authentication token
+    sdk = SDK(access_token)
+
+    # Create a test card token
+    def create_test_card():
+        card_token_object = {
+            "card_number": "5031433215406351",
+            "security_code": "123",
+            "expiration_year": "2030",
+            "expiration_month": "11",
+            "cardholder": {"name": "APRO"}
+        }
+        card_token_created = sdk.card_token().create(card_token_object)
+        return card_token_created["response"]["id"]
+
+    # Create an order object
+    card_token_id = create_test_card()
+    order_object = {
+        "type": "online",
+        "processing_mode": "manual",
+        "total_amount": "200.00",
+        "external_reference": "ext_ref_1234",
+        "payer": {
+            "email": "<PAYER_EMAIL>"
+        }
+    }
+
+    try:
+        # Call the method to create the order
+        response = sdk.order().create(order_object)
+        print("Order created successfully")
+
+        # Get the order ID from the response
+        order_id = response["response"]["id"]
+
+        transaction_object = {
+            "payments": [
+                {
+                    "amount": "200.00",
+                    "payment_method": {
+                        "id": "master",
+                        "type": "credit_card",
+                        "token": card_token_id,
+                        "installments": 12
+                    }
+                }
+            ]
+        }
+        # Call the method to CREATE A TRANSACTION in the order
+        transaction_created = sdk.order().create_transaction(order_id, transaction_object)
+        print("Transaction created:", transaction_created["response"])
+    except Exception as e:
+        print("Error:", e)
+
+if __name__ == "__main__":
+    main()

mercadopago/examples/order/delete_transaction.py

@@ -0,0 +1,66 @@
+import os
+import time
+
+from mercadopago import SDK
+
+def main():
+    # Define the authentication token
+    access_token = "<YOUR_ACCESS_TOKEN>"
+
+    # Define the authentication token
+    sdk = SDK(access_token)
+
+    # Create a test card token
+    def create_test_card():
+        card_token_object = {
+            "card_number": "5031433215406351",
+            "security_code": "123",
+            "expiration_year": "2030",
+            "expiration_month": "11",
+            "cardholder": {"name": "APRO"}
+        }
+        card_token_created = sdk.card_token().create(card_token_object)
+        return card_token_created["response"]["id"]
+
+    # Create an order object
+    card_token_id = create_test_card()
+    order_object = {
+        "type": "online",
+        "processing_mode": "manual",
+        "total_amount": "200.00",
+        "external_reference": "ext_ref_1234",
+        "transactions": {
+            "payments": [
+                {
+                    "amount": "200.00",
+                    "payment_method": {
+                        "id": "master",
+                        "type": "credit_card",
+                        "token": card_token_id,
+                        "installments": 12
+                    }
+                }
+            ]
+        },
+        "payer": {
+            "email": "<PAYER_EMAIL>"
+        }
+    }
+
+    try:
+        # Call the method to create the order
+        response = sdk.order().create(order_object)
+        print("Order created successfully")
+
+        # Get the order ID from the response
+        order_id = response["response"]["id"]
+        transaction_id = response["response"]["transactions"]["payments"][0]["id"]
+
+        # Call the method to DELETE the transaction in the order
+        transaction_deleted = sdk.order().delete_transaction(order_id, transaction_id)
+        print("Transaction Successful Deleted.", transaction_deleted["response"])
+    except Exception as e:
+        print("Error:", e)
+
+if __name__ == "__main__":
+    main()