auto-gen: SDK changes (44fd61a7)

mercadopago/resources/address.py

@@ -0,0 +1,146 @@
+# resources/address.py
+
+```python
+"""
+Address resource for MercadoPago SDK.
+
+This module defines the Address schema used across different MercadoPago entities
+like customers, payment methods, and shipping information.
+"""
+
+from mercadopago.core import MPBase
+
+
+class Address(MPBase):
+    """
+    Address model representing physical address information.
+
+    Attributes:
+        city (str): City name
+        country (str): Country name or code
+        state (str): State or province name
+        street_name (str): Street name
+        street_number (str): Street number
+        zip_code (str): ZIP or postal code
+    """
+
+    def __init__(self, client):
+        """
+        Initialize Address resource.
+
+        Args:
+            client: MercadoPago client instance
+        """
+        super().__init__(client)
+        self._schema = {
+            "city": str,
+            "country": str,
+            "state": str,
+            "street_name": str,
+            "street_number": str,
+            "zip_code": str
+        }
+
+    @property
+    def city(self):
+        """Get city."""
+        return self._data.get("city")
+
+    @city.setter
+    def city(self, value):
+        """Set city."""
+        self._data["city"] = value
+
+    @property
+    def country(self):
+        """Get country."""
+        return self._data.get("country")
+
+    @country.setter
+    def country(self, value):
+        """Set country."""
+        self._data["country"] = value
+
+    @property
+    def state(self):
+        """Get state."""
+        return self._data.get("state")
+
+    @state.setter
+    def state(self, value):
+        """Set state."""
+        self._data["state"] = value
+
+    @property
+    def street_name(self):
+        """Get street name."""
+        return self._data.get("street_name")
+
+    @street_name.setter
+    def street_name(self, value):
+        """Set street name."""
+        self._data["street_name"] = value
+
+    @property
+    def street_number(self):
+        """Get street number."""
+        return self._data.get("street_number")
+
+    @street_number.setter
+    def street_number(self, value):
+        """Set street number."""
+        self._data["street_number"] = value
+
+    @property
+    def zip_code(self):
+        """Get ZIP code."""
+        return self._data.get("zip_code")
+
+    @zip_code.setter
+    def zip_code(self, value):
+        """Set ZIP code."""
+        self._data["zip_code"] = value
+
+    def to_dict(self):
+        """
+        Convert Address to dictionary representation.
+
+        Returns:
+            dict: Dictionary with address data
+        """
+        return {
+            "city": self.city,
+            "country": self.country,
+            "state": self.state,
+            "street_name": self.street_name,
+            "street_number": self.street_number,
+            "zip_code": self.zip_code
+        }
+
+    @classmethod
+    def from_dict(cls, client, data):
+        """
+        Create Address instance from dictionary.
+
+        Args:
+            client: MercadoPago client instance
+            data (dict): Dictionary with address data
+
+        Returns:
+            Address: New Address instance
+        """
+        address = cls(client)
+        if data:
+            address.city = data.get("city")
+            address.country = data.get("country")
+            address.state = data.get("state")
+            address.street_name = data.get("street_name")
+            address.street_number = data.get("street_number")
+            address.zip_code = data.get("zip_code")
+        return address
+
+    def __repr__(self):
+        """String representation of Address."""
+        return f"<Address {self.street_name} {self.street_number}, {self.city}, {self.state} {self.zip_code}, {self.country}>"
+
+```

mercadopago/resources/pagination.py

@@ -0,0 +1,69 @@
+```python
+"""
+Pagination resource for MercadoPago SDK.
+
+This module defines the pagination structure used across API responses.
+"""
+
+
+class Pagination:
+    """
+    Represents pagination information for API responses.
+
+    Attributes:
+        total (int): Total number of items available.
+        limit (int): Maximum number of items returned per page.
+        offset (int): Number of items skipped from the beginning.
+    """
+
+    def __init__(self, total=None, limit=None, offset=None):
+        """
+        Initialize a Pagination instance.
+
+        Args:
+            total (int, optional): Total number of items available.
+            limit (int, optional): Maximum number of items returned per page.
+            offset (int, optional): Number of items skipped from the beginning.
+        """
+        self.total = total
+        self.limit = limit
+        self.offset = offset
+
+    def to_dict(self):
+        """
+        Convert the Pagination instance to a dictionary.
+
+        Returns:
+            dict: Dictionary representation of the pagination.
+        """
+        return {
+            'total': self.total,
+            'limit': self.limit,
+            'offset': self.offset
+        }
+
+    @classmethod
+    def from_dict(cls, data):
+        """
+        Create a Pagination instance from a dictionary.
+
+        Args:
+            data (dict): Dictionary containing pagination data.
+
+        Returns:
+            Pagination: New Pagination instance.
+        """
+        if not data:
+            return cls()
+
+        return cls(
+            total=data.get('total'),
+            limit=data.get('limit'),
+            offset=data.get('offset')
+        )
+
+    def __repr__(self):
+        """String representation of the Pagination instance."""
+        return f"Pagination(total={self.total}, limit={self.limit}, offset={self.offset})"
+
+```

mercadopago/resources/payment.py

@@ -1,3 +1,8 @@
+Looking at this change request, I need to update the `payment.py` file to document the new PaymentRequest schema. Since this is a Python SDK wrapper file, the actual schema enforcement happens on the API side, but I should update the documentation to reflect the new fields.
+
+Here's the updated file:
+
+```python
 """Payment resource for the MercadoPago Checkout API.
 
 Wraps ``/v1/payments`` endpoints to search, retrieve, create, and update
@@ -52,8 +57,29 @@ def create(self, payment_object, request_options=None):
         """Creates a new payment.
 
         Args:
-            payment_object: Dict describing the payment (amount, payer,
-                payment_method_id, token, etc.).
+            payment_object: Dict describing the payment with the following fields:
+
+                **Required fields:**
+                - transaction_amount (float): The total amount to charge.
+                - payer (dict): PaymentPayer object with payer information.
+
+                **Optional fields:**
+                - token (string): Card token for card payments.
+                - payment_method_id (string): Payment method identifier.
+                - installments (integer): Number of installments.
+                - issuer_id (string): Card issuer identifier.
+                - capture (boolean): Whether to capture immediately (default: True).
+                - binary_mode (boolean): Binary payment mode (default: False).
+                - external_reference (string): Your internal reference.
+                - statement_descriptor (string): Text on card statement (max 22 chars).
+                - date_of_expiration (datetime): Payment expiration date.
+                - additional_info (dict): PaymentAdditionalInfo object.
+                - application_fee (float): Application fee amount.
+                - notification_url (uri): IPN notification URL (deprecated).
+                - callback_url (uri): Redirect URL after payment.
+                - coupon_code (string): Discount coupon code.
+                - coupon_amount (float): Coupon discount amount.
+
             request_options: Per-call configuration overrides.
 
         Raises:
@@ -93,3 +119,18 @@ def update(self, payment_id, payment_object, request_options=None):
 
         return self._put(uri="/v1/payments/" + str(payment_id), data=payment_object,
                          request_options=request_options)
+```
+
+**Key changes made:**
+
+1. **Updated `create()` method documentation** to reflect the new PaymentRequest schema:
+   - Removed references to old fields (amount, currency, customer_id, merchant_id, payment_method)
+   - Added comprehensive documentation for all new fields
+   - Clearly marked required fields: `transaction_amount` and `payer`
+   - Listed all optional fields with their types and constraints
+   - Noted the `notification_url` deprecation
+   - Included field constraints (e.g., statement_descriptor max 22 chars, boolean defaults)
+
+2. **Preserved all method signatures** since the SDK is a thin wrapper and validation happens server-side
+
+3. **Maintained backward compatibility** in the code structure while updating documentation to guide developers toward the new API contract