gmt-python-sdk 0.6.0__tar.gz → 0.7.0__tar.gz

gmt_python_sdk-0.7.0/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.7.0"
+}

{gmt_python_sdk-0.6.0 → gmt_python_sdk-0.7.0}/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.7.0 (2025-12-08)
+
+Full Changelog: [v0.6.0...v0.7.0](https://github.com/cameo6/gmt-python-sdk/compare/v0.6.0...v0.7.0)
+
+### Features
+
+* **api:** add refund repository ([d8db552](https://github.com/cameo6/gmt-python-sdk/commit/d8db552d131f6c5ef561b525a88ddb640367f381))
+
 ## 0.6.0 (2025-12-08)
 
 Full Changelog: [v0.5.0...v0.6.0](https://github.com/cameo6/gmt-python-sdk/compare/v0.5.0...v0.6.0)

{gmt_python_sdk-0.6.0 → gmt_python_sdk-0.7.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: gmt-python-sdk
-Version: 0.6.0
+Version: 0.7.0
 Summary: The official Python library for the gmt API
 Project-URL: Homepage, https://github.com/cameo6/gmt-python-sdk
 Project-URL: Repository, https://github.com/cameo6/gmt-python-sdk

{gmt_python_sdk-0.6.0 → gmt_python_sdk-0.7.0}/api.md

@@ -46,6 +46,7 @@ from gmt.types import (
     PurchaseCreateResponse,
     PurchaseRetrieveResponse,
     PurchaseListResponse,
+    PurchaseRefundResponse,
     PurchaseRequestVerificationCodeResponse,
 )
 ```
@@ -55,6 +56,7 @@ Methods:
 - <code title="post /v1/purchases/">client.purchases.<a href="./src/gmt/resources/purchases.py">create</a>(\*\*<a href="src/gmt/types/purchase_create_params.py">params</a>) -> <a href="./src/gmt/types/purchase_create_response.py">PurchaseCreateResponse</a></code>
 - <code title="get /v1/purchases/{purchase_id}">client.purchases.<a href="./src/gmt/resources/purchases.py">retrieve</a>(purchase_id) -> <a href="./src/gmt/types/purchase_retrieve_response.py">PurchaseRetrieveResponse</a></code>
 - <code title="get /v1/purchases/">client.purchases.<a href="./src/gmt/resources/purchases.py">list</a>(\*\*<a href="src/gmt/types/purchase_list_params.py">params</a>) -> <a href="./src/gmt/types/purchase_list_response.py">SyncPageNumber[PurchaseListResponse]</a></code>
+- <code title="post /v1/purchases/{purchase_id}/refund">client.purchases.<a href="./src/gmt/resources/purchases.py">refund</a>(purchase_id) -> <a href="./src/gmt/types/purchase_refund_response.py">PurchaseRefundResponse</a></code>
 - <code title="post /v1/purchases/{purchase_id}/request-code">client.purchases.<a href="./src/gmt/resources/purchases.py">request_verification_code</a>(purchase_id, \*\*<a href="src/gmt/types/purchase_request_verification_code_params.py">params</a>) -> <a href="./src/gmt/types/purchase_request_verification_code_response.py">PurchaseRequestVerificationCodeResponse</a></code>
 
 # Webhooks

{gmt_python_sdk-0.6.0 → gmt_python_sdk-0.7.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "gmt-python-sdk"
-version = "0.6.0"
+version = "0.7.0"
 description = "The official Python library for the gmt API"
 dynamic = ["readme"]
 license = "Apache-2.0"

{gmt_python_sdk-0.6.0 → gmt_python_sdk-0.7.0}/src/gmt/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "gmt"
-__version__ = "0.6.0"  # x-release-please-version
+__version__ = "0.7.0"  # x-release-please-version

{gmt_python_sdk-0.6.0 → gmt_python_sdk-0.7.0}/src/gmt/resources/purchases.py

@@ -21,6 +21,7 @@ from ..pagination import SyncPageNumber, AsyncPageNumber
 from .._base_client import AsyncPaginator, make_request_options
 from ..types.purchase_list_response import PurchaseListResponse
 from ..types.purchase_create_response import PurchaseCreateResponse
+from ..types.purchase_refund_response import PurchaseRefundResponse
 from ..types.purchase_retrieve_response import PurchaseRetrieveResponse
 from ..types.purchase_request_verification_code_response import PurchaseRequestVerificationCodeResponse
 
@@ -207,6 +208,44 @@ class PurchasesResource(SyncAPIResource):
             model=PurchaseListResponse,
         )
 
+    def refund(
+        self,
+        purchase_id: int,
+        *,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> PurchaseRefundResponse:
+        """
+        Refunds a purchase if verification code was not received within 20 minutes.
+
+        **Requirements:**
+
+        - Status `PENDING`, code not received
+        - At least 20 minutes since purchase creation
+
+        Args:
+          purchase_id: Unique purchase identifier.
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        return self._post(
+            f"/v1/purchases/{purchase_id}/refund",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=PurchaseRefundResponse,
+        )
+
     def request_verification_code(
         self,
         purchase_id: int,
@@ -454,6 +493,44 @@ class AsyncPurchasesResource(AsyncAPIResource):
             model=PurchaseListResponse,
         )
 
+    async def refund(
+        self,
+        purchase_id: int,
+        *,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> PurchaseRefundResponse:
+        """
+        Refunds a purchase if verification code was not received within 20 minutes.
+
+        **Requirements:**
+
+        - Status `PENDING`, code not received
+        - At least 20 minutes since purchase creation
+
+        Args:
+          purchase_id: Unique purchase identifier.
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        return await self._post(
+            f"/v1/purchases/{purchase_id}/refund",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=PurchaseRefundResponse,
+        )
+
     async def request_verification_code(
         self,
         purchase_id: int,
@@ -532,6 +609,9 @@ class PurchasesResourceWithRawResponse:
         self.list = to_raw_response_wrapper(
             purchases.list,
         )
+        self.refund = to_raw_response_wrapper(
+            purchases.refund,
+        )
         self.request_verification_code = to_raw_response_wrapper(
             purchases.request_verification_code,
         )
@@ -550,6 +630,9 @@ class AsyncPurchasesResourceWithRawResponse:
         self.list = async_to_raw_response_wrapper(
             purchases.list,
         )
+        self.refund = async_to_raw_response_wrapper(
+            purchases.refund,
+        )
         self.request_verification_code = async_to_raw_response_wrapper(
             purchases.request_verification_code,
         )
@@ -568,6 +651,9 @@ class PurchasesResourceWithStreamingResponse:
         self.list = to_streamed_response_wrapper(
             purchases.list,
         )
+        self.refund = to_streamed_response_wrapper(
+            purchases.refund,
+        )
         self.request_verification_code = to_streamed_response_wrapper(
             purchases.request_verification_code,
         )
@@ -586,6 +672,9 @@ class AsyncPurchasesResourceWithStreamingResponse:
         self.list = async_to_streamed_response_wrapper(
             purchases.list,
         )
+        self.refund = async_to_streamed_response_wrapper(
+            purchases.refund,
+        )
         self.request_verification_code = async_to_streamed_response_wrapper(
             purchases.request_verification_code,
         )

{gmt_python_sdk-0.6.0 → gmt_python_sdk-0.7.0}/src/gmt/types/__init__.py

@@ -10,6 +10,7 @@ from .webhook_test_response import WebhookTestResponse as WebhookTestResponse
 from .purchase_create_params import PurchaseCreateParams as PurchaseCreateParams
 from .purchase_list_response import PurchaseListResponse as PurchaseListResponse
 from .purchase_create_response import PurchaseCreateResponse as PurchaseCreateResponse
+from .purchase_refund_response import PurchaseRefundResponse as PurchaseRefundResponse
 from .account_retrieve_response import AccountRetrieveResponse as AccountRetrieveResponse
 from .profile_retrieve_response import ProfileRetrieveResponse as ProfileRetrieveResponse
 from .purchase_retrieve_response import PurchaseRetrieveResponse as PurchaseRetrieveResponse

gmt_python_sdk-0.7.0/src/gmt/types/purchase_refund_response.py

@@ -0,0 +1,141 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+from typing_extensions import Literal
+
+from .._models import BaseModel
+
+__all__ = [
+    "PurchaseRefundResponse",
+    "Purchase",
+    "PurchaseDisplayName",
+    "PurchasePrice",
+    "PurchaseVerification",
+    "Refund",
+    "RefundAmount",
+]
+
+
+class PurchaseDisplayName(BaseModel):
+    en: str
+    """Name in English."""
+
+    ru: str
+    """Name in Russian."""
+
+
+class PurchasePrice(BaseModel):
+    amount: str
+    """Monetary amount as a string with up to 2 decimal places."""
+
+    currency_code: str
+    """ISO 4217 currency code."""
+
+
+class PurchaseVerification(BaseModel):
+    code: str
+    """Verification code for account."""
+
+    password: str
+    """Account password."""
+
+    received_at: str
+    """
+    **Code Retrieval Timestamp.** Marks when verification code was successfully
+    fetched from the provider (not when purchase was created).
+
+    **Example timeline.**
+
+    - `created_at`: `2024-11-19T10:00:00Z` (purchase created)
+    - `received_at`: `2024-11-19T10:05:02Z` (code requested 5 minutes later)
+
+    **Note.** These timestamps may be identical if code is requested immediately
+    after purchase.
+    """
+
+
+class Purchase(BaseModel):
+    id: int
+    """Unique purchase identifier."""
+
+    country_code: str
+    """ISO 3166-1 alpha-2 country code."""
+
+    created_at: str
+    """Purchase creation time in ISO 8601 format (UTC)."""
+
+    display_name: PurchaseDisplayName
+
+    phone_number: str
+    """
+    **E.164 International Format.** Phone number with country code prefix (e.g.,
+    `+12025550123` for US, `+79991234567` for Russia).
+
+    **Usage.** This is your Telegram account login. Use it with `verification.code`
+    and `verification.password` to access the account.
+    """
+
+    price: PurchasePrice
+    """
+    **Final Price After Discount.** The actual amount deducted from your balance,
+    with your personal discount already applied.
+
+    **To see pricing breakdown before purchase.** Check
+    `GET /accounts/:country_code` which shows both discounted price and original
+    `base_price`.
+
+    **Discount eligibility.** Based on your total successful purchase count. Higher
+    volume = bigger discounts.
+    """
+
+    status: Literal["PENDING", "SUCCESS", "ERROR", "REFUND"]
+    """
+    **Purchase Status Lifecycle.** `PENDING` (initial) → `SUCCESS` (after code
+    request) or `ERROR` (provider failure). Any status can transition to `REFUND`
+    via admin action.
+
+    **Important.** Status is immutable once set to `SUCCESS`, `ERROR`, or `REFUND`.
+
+    **Filter options**
+
+    - `PENDING` - code not requested.
+    - `SUCCESS` - code ready.
+    - `ERROR` - provider failed.
+    - `REFUND` - money returned.
+    """
+
+    verification: Optional[PurchaseVerification] = None
+    """
+    **Verification Credentials.** Login credentials for the purchased Telegram
+    account. Initially `null` after purchase creation.
+
+    **Availability.** Populated after calling `POST /purchases/:id/request-code`.
+    Once received, credentials are permanent and cannot be re-requested.
+
+    **Security.** Verification data is only visible to the purchase owner.
+    """
+
+
+class RefundAmount(BaseModel):
+    amount: str
+    """Monetary amount as a string with up to 2 decimal places."""
+
+    currency_code: str
+    """ISO 4217 currency code."""
+
+
+class Refund(BaseModel):
+    amount: RefundAmount
+    """Refunded amount (full purchase price)"""
+
+    reason: str
+    """Refund reason"""
+
+    refunded_at: str
+    """Refund timestamp in ISO 8601 format"""
+
+
+class PurchaseRefundResponse(BaseModel):
+    purchase: Purchase
+
+    refund: Refund

{gmt_python_sdk-0.6.0 → gmt_python_sdk-0.7.0}/tests/api_resources/test_purchases.py

@@ -11,6 +11,7 @@ from gmt import Gmt, AsyncGmt
 from gmt.types import (
     PurchaseListResponse,
     PurchaseCreateResponse,
+    PurchaseRefundResponse,
     PurchaseRetrieveResponse,
     PurchaseRequestVerificationCodeResponse,
 )
@@ -138,6 +139,40 @@ class TestPurchases:
 
         assert cast(Any, response.is_closed) is True
 
+    @pytest.mark.skip(reason="Prism tests are disabled")
+    @parametrize
+    def test_method_refund(self, client: Gmt) -> None:
+        purchase = client.purchases.refund(
+            12345,
+        )
+        assert_matches_type(PurchaseRefundResponse, purchase, path=["response"])
+
+    @pytest.mark.skip(reason="Prism tests are disabled")
+    @parametrize
+    def test_raw_response_refund(self, client: Gmt) -> None:
+        response = client.purchases.with_raw_response.refund(
+            12345,
+        )
+
+        assert response.is_closed is True
+        assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+        purchase = response.parse()
+        assert_matches_type(PurchaseRefundResponse, purchase, path=["response"])
+
+    @pytest.mark.skip(reason="Prism tests are disabled")
+    @parametrize
+    def test_streaming_response_refund(self, client: Gmt) -> None:
+        with client.purchases.with_streaming_response.refund(
+            12345,
+        ) as response:
+            assert not response.is_closed
+            assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+
+            purchase = response.parse()
+            assert_matches_type(PurchaseRefundResponse, purchase, path=["response"])
+
+        assert cast(Any, response.is_closed) is True
+
     @pytest.mark.skip(reason="Prism tests are disabled")
     @parametrize
     def test_method_request_verification_code(self, client: Gmt) -> None:
@@ -302,6 +337,40 @@ class TestAsyncPurchases:
 
         assert cast(Any, response.is_closed) is True
 
+    @pytest.mark.skip(reason="Prism tests are disabled")
+    @parametrize
+    async def test_method_refund(self, async_client: AsyncGmt) -> None:
+        purchase = await async_client.purchases.refund(
+            12345,
+        )
+        assert_matches_type(PurchaseRefundResponse, purchase, path=["response"])
+
+    @pytest.mark.skip(reason="Prism tests are disabled")
+    @parametrize
+    async def test_raw_response_refund(self, async_client: AsyncGmt) -> None:
+        response = await async_client.purchases.with_raw_response.refund(
+            12345,
+        )
+
+        assert response.is_closed is True
+        assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+        purchase = await response.parse()
+        assert_matches_type(PurchaseRefundResponse, purchase, path=["response"])
+
+    @pytest.mark.skip(reason="Prism tests are disabled")
+    @parametrize
+    async def test_streaming_response_refund(self, async_client: AsyncGmt) -> None:
+        async with async_client.purchases.with_streaming_response.refund(
+            12345,
+        ) as response:
+            assert not response.is_closed
+            assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+
+            purchase = await response.parse()
+            assert_matches_type(PurchaseRefundResponse, purchase, path=["response"])
+
+        assert cast(Any, response.is_closed) is True
+
     @pytest.mark.skip(reason="Prism tests are disabled")
     @parametrize
     async def test_method_request_verification_code(self, async_client: AsyncGmt) -> None:

gmt_python_sdk-0.6.0/.release-please-manifest.json

@@ -1,3 +0,0 @@
-{
-  ".": "0.6.0"
-}