growsurf-python 0.6.1__tar.gz → 0.7.0__tar.gz

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

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

{growsurf_python-0.6.1 → growsurf_python-0.7.0}/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.7.0 (2026-06-29)
+
+Full Changelog: [v0.6.1...v0.7.0](https://github.com/growsurf/growsurf-python/compare/v0.6.1...v0.7.0)
+
+### Features
+
+* **api:** support delayed referral rewards and affiliate refunds ([f0afb36](https://github.com/growsurf/growsurf-python/commit/f0afb361ec64165cbb21134d277e8ad224a57106))
+
 ## 0.6.1 (2026-06-26)
 
 Full Changelog: [v0.6.0...v0.6.1](https://github.com/growsurf/growsurf-python/compare/v0.6.0...v0.6.1)

{growsurf_python-0.6.1 → growsurf_python-0.7.0}/PKG-INFO

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

{growsurf_python-0.6.1 → growsurf_python-0.7.0}/api.md

@@ -43,6 +43,7 @@ from growsurf.types.campaign import (
     ParticipantDeleteResponse,
     ParticipantListRewardsResponse,
     ParticipantRecordTransactionResponse,
+    ParticipantRefundTransactionResponse,
     ParticipantSendInvitesResponse,
     ParticipantTriggerReferralResponse,
 )
@@ -59,8 +60,10 @@ Methods:
 - <code title="get /campaign/{id}/participant/{participantIdOrEmail}/referrals">client.campaign.participant.<a href="./src/growsurf/resources/campaign/participant.py">list_referrals</a>(participant_id_or_email, \*, id, \*\*<a href="src/growsurf/types/campaign/participant_list_referrals_params.py">params</a>) -> <a href="./src/growsurf/types/referral_list.py">ReferralList</a></code>
 - <code title="get /campaign/{id}/participant/{participantIdOrEmail}/rewards">client.campaign.participant.<a href="./src/growsurf/resources/campaign/participant.py">list_rewards</a>(participant_id_or_email, \*, id, \*\*<a href="src/growsurf/types/campaign/participant_list_rewards_params.py">params</a>) -> <a href="./src/growsurf/types/campaign/participant_list_rewards_response.py">ParticipantListRewardsResponse</a></code>
 - <code title="post /campaign/{id}/participant/{participantIdOrEmail}/transaction">client.campaign.participant.<a href="./src/growsurf/resources/campaign/participant.py">record_transaction</a>(participant_id_or_email, \*, id, \*\*<a href="src/growsurf/types/campaign/participant_record_transaction_params.py">params</a>) -> <a href="./src/growsurf/types/campaign/participant_record_transaction_response.py">ParticipantRecordTransactionResponse</a></code>
+- <code title="post /campaign/{id}/participant/{participantIdOrEmail}/transaction/refund">client.campaign.participant.<a href="./src/growsurf/resources/campaign/participant.py">refund_transaction</a>(participant_id_or_email, \*, id, \*\*<a href="src/growsurf/types/campaign/participant_refund_transaction_params.py">params</a>) -> <a href="./src/growsurf/types/campaign/participant_refund_transaction_response.py">ParticipantRefundTransactionResponse</a></code>
 - <code title="post /campaign/{id}/participant/{participantIdOrEmail}/invites">client.campaign.participant.<a href="./src/growsurf/resources/campaign/participant.py">send_invites</a>(participant_id_or_email, \*, id, \*\*<a href="src/growsurf/types/campaign/participant_send_invites_params.py">params</a>) -> <a href="./src/growsurf/types/campaign/participant_send_invites_response.py">ParticipantSendInvitesResponse</a></code>
-- <code title="post /campaign/{id}/participant/{participantIdOrEmail}/ref">client.campaign.participant.<a href="./src/growsurf/resources/campaign/participant.py">trigger_referral</a>(participant_id_or_email, \*, id) -> <a href="./src/growsurf/types/campaign/participant_trigger_referral_response.py">ParticipantTriggerReferralResponse</a></code>
+- <code title="post /campaign/{id}/participant/{participantIdOrEmail}/ref">client.campaign.participant.<a href="./src/growsurf/resources/campaign/participant.py">trigger_referral</a>(participant_id_or_email, \*, id, \*\*<a href="src/growsurf/types/campaign/participant_trigger_referral_params.py">params</a>) -> <a href="./src/growsurf/types/campaign/participant_trigger_referral_response.py">ParticipantTriggerReferralResponse</a></code>
+- <code title="delete /campaign/{id}/participant/{participantIdOrEmail}/ref">client.campaign.participant.<a href="./src/growsurf/resources/campaign/participant.py">cancel_delayed_referral</a>(participant_id_or_email, \*, id) -> <a href="./src/growsurf/types/campaign/participant_trigger_referral_response.py">ParticipantTriggerReferralResponse</a></code>
 
 ## Reward
 

{growsurf_python-0.6.1 → growsurf_python-0.7.0}/pyproject.toml

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

{growsurf_python-0.6.1 → growsurf_python-0.7.0}/src/growsurf/_version.py

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

{growsurf_python-0.6.1 → growsurf_python-0.7.0}/src/growsurf/resources/campaign/participant.py

@@ -27,7 +27,9 @@ from ...types.campaign import (
     participant_send_invites_params,
     participant_list_referrals_params,
     participant_list_commissions_params,
+    participant_trigger_referral_params,
     participant_record_transaction_params,
+    participant_refund_transaction_params,
 )
 from ...types.referral_list import ReferralList
 from ...types.campaign.participant import Participant
@@ -39,6 +41,7 @@ from ...types.campaign.participant_list_rewards_response import ParticipantListR
 from ...types.campaign.participant_send_invites_response import ParticipantSendInvitesResponse
 from ...types.campaign.participant_trigger_referral_response import ParticipantTriggerReferralResponse
 from ...types.campaign.participant_record_transaction_response import ParticipantRecordTransactionResponse
+from ...types.campaign.participant_refund_transaction_response import ParticipantRefundTransactionResponse
 
 __all__ = ["ParticipantResource", "AsyncParticipantResource"]
 
@@ -646,6 +649,87 @@ class ParticipantResource(SyncAPIResource):
             ),
         )
 
+    def refund_transaction(
+        self,
+        participant_id_or_email: str,
+        *,
+        id: str,
+        amendment_type: Literal["REFUND", "CHARGEBACK"] | Omit = omit,
+        amount: int | Omit = omit,
+        amount_refunded: int | Omit = omit,
+        charge_id: str | Omit = omit,
+        currency: str | Omit = omit,
+        description: str | Omit = omit,
+        external_id: str | Omit = omit,
+        invoice_id: str | Omit = omit,
+        order_id: str | Omit = omit,
+        payment_id: str | Omit = omit,
+        payment_intent_id: str | Omit = omit,
+        refund_amount: int | Omit = omit,
+        refund_id: str | Omit = omit,
+        refund_status: str | Omit = omit,
+        transaction_id: str | Omit = omit,
+        # 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,
+    ) -> ParticipantRefundTransactionResponse:
+        """
+        Records an amendment (refund, partial refund, refund cancellation, or
+        chargeback) against a previously recorded transaction and reverses or adjusts
+        the referrer's commission. The inverse of Record Affiliate Transaction.
+        Commissions already paid out are not clawed back; the amendment is recorded for
+        tax reporting only.
+
+        Args:
+          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
+        """
+        if not id:
+            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        if not participant_id_or_email:
+            raise ValueError(
+                f"Expected a non-empty value for `participant_id_or_email` but received {participant_id_or_email!r}"
+            )
+        return self._post(
+            path_template(
+                "/campaign/{id}/participant/{participant_id_or_email}/transaction/refund",
+                id=id,
+                participant_id_or_email=participant_id_or_email,
+            ),
+            body=maybe_transform(
+                {
+                    "amendment_type": amendment_type,
+                    "amount": amount,
+                    "amount_refunded": amount_refunded,
+                    "charge_id": charge_id,
+                    "currency": currency,
+                    "description": description,
+                    "external_id": external_id,
+                    "invoice_id": invoice_id,
+                    "order_id": order_id,
+                    "payment_id": payment_id,
+                    "payment_intent_id": payment_intent_id,
+                    "refund_amount": refund_amount,
+                    "refund_id": refund_id,
+                    "refund_status": refund_status,
+                    "transaction_id": transaction_id,
+                },
+                participant_refund_transaction_params.ParticipantRefundTransactionParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=ParticipantRefundTransactionResponse,
+        )
+
     def send_invites(
         self,
         participant_id_or_email: str,
@@ -704,6 +788,7 @@ class ParticipantResource(SyncAPIResource):
         participant_id_or_email: str,
         *,
         id: str,
+        delay_in_days: int | Omit = omit,
         # 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,
@@ -716,6 +801,12 @@ class ParticipantResource(SyncAPIResource):
         participant ID or email address.
 
         Args:
+          delay_in_days: Number of whole days to hold referral credit before it is awarded. Useful for
+              honoring a refund window before crediting a referrer. Omit this field to award
+              credit immediately. The credit is awarded automatically once the delay elapses,
+              and can be cancelled before then with the Cancel delayed referral trigger
+              request.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -731,6 +822,52 @@ class ParticipantResource(SyncAPIResource):
                 f"Expected a non-empty value for `participant_id_or_email` but received {participant_id_or_email!r}"
             )
         return self._post(
+            path_template(
+                "/campaign/{id}/participant/{participant_id_or_email}/ref",
+                id=id,
+                participant_id_or_email=participant_id_or_email,
+            ),
+            body=maybe_transform(
+                {"delay_in_days": delay_in_days}, participant_trigger_referral_params.ParticipantTriggerReferralParams
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=ParticipantTriggerReferralResponse,
+        )
+
+    def cancel_delayed_referral(
+        self,
+        participant_id_or_email: str,
+        *,
+        id: str,
+        # 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,
+    ) -> ParticipantTriggerReferralResponse:
+        """
+        Cancels a pending delayed referral trigger for a participant by GrowSurf
+        participant ID or email address.
+
+        Args:
+          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
+        """
+        if not id:
+            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        if not participant_id_or_email:
+            raise ValueError(
+                f"Expected a non-empty value for `participant_id_or_email` but received {participant_id_or_email!r}"
+            )
+        return self._delete(
             path_template(
                 "/campaign/{id}/participant/{participant_id_or_email}/ref",
                 id=id,
@@ -1346,6 +1483,87 @@ class AsyncParticipantResource(AsyncAPIResource):
             ),
         )
 
+    async def refund_transaction(
+        self,
+        participant_id_or_email: str,
+        *,
+        id: str,
+        amendment_type: Literal["REFUND", "CHARGEBACK"] | Omit = omit,
+        amount: int | Omit = omit,
+        amount_refunded: int | Omit = omit,
+        charge_id: str | Omit = omit,
+        currency: str | Omit = omit,
+        description: str | Omit = omit,
+        external_id: str | Omit = omit,
+        invoice_id: str | Omit = omit,
+        order_id: str | Omit = omit,
+        payment_id: str | Omit = omit,
+        payment_intent_id: str | Omit = omit,
+        refund_amount: int | Omit = omit,
+        refund_id: str | Omit = omit,
+        refund_status: str | Omit = omit,
+        transaction_id: str | Omit = omit,
+        # 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,
+    ) -> ParticipantRefundTransactionResponse:
+        """
+        Records an amendment (refund, partial refund, refund cancellation, or
+        chargeback) against a previously recorded transaction and reverses or adjusts
+        the referrer's commission. The inverse of Record Affiliate Transaction.
+        Commissions already paid out are not clawed back; the amendment is recorded for
+        tax reporting only.
+
+        Args:
+          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
+        """
+        if not id:
+            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        if not participant_id_or_email:
+            raise ValueError(
+                f"Expected a non-empty value for `participant_id_or_email` but received {participant_id_or_email!r}"
+            )
+        return await self._post(
+            path_template(
+                "/campaign/{id}/participant/{participant_id_or_email}/transaction/refund",
+                id=id,
+                participant_id_or_email=participant_id_or_email,
+            ),
+            body=await async_maybe_transform(
+                {
+                    "amendment_type": amendment_type,
+                    "amount": amount,
+                    "amount_refunded": amount_refunded,
+                    "charge_id": charge_id,
+                    "currency": currency,
+                    "description": description,
+                    "external_id": external_id,
+                    "invoice_id": invoice_id,
+                    "order_id": order_id,
+                    "payment_id": payment_id,
+                    "payment_intent_id": payment_intent_id,
+                    "refund_amount": refund_amount,
+                    "refund_id": refund_id,
+                    "refund_status": refund_status,
+                    "transaction_id": transaction_id,
+                },
+                participant_refund_transaction_params.ParticipantRefundTransactionParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=ParticipantRefundTransactionResponse,
+        )
+
     async def send_invites(
         self,
         participant_id_or_email: str,
@@ -1404,6 +1622,7 @@ class AsyncParticipantResource(AsyncAPIResource):
         participant_id_or_email: str,
         *,
         id: str,
+        delay_in_days: int | Omit = omit,
         # 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,
@@ -1416,6 +1635,12 @@ class AsyncParticipantResource(AsyncAPIResource):
         participant ID or email address.
 
         Args:
+          delay_in_days: Number of whole days to hold referral credit before it is awarded. Useful for
+              honoring a refund window before crediting a referrer. Omit this field to award
+              credit immediately. The credit is awarded automatically once the delay elapses,
+              and can be cancelled before then with the Cancel delayed referral trigger
+              request.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -1431,6 +1656,52 @@ class AsyncParticipantResource(AsyncAPIResource):
                 f"Expected a non-empty value for `participant_id_or_email` but received {participant_id_or_email!r}"
             )
         return await self._post(
+            path_template(
+                "/campaign/{id}/participant/{participant_id_or_email}/ref",
+                id=id,
+                participant_id_or_email=participant_id_or_email,
+            ),
+            body=await async_maybe_transform(
+                {"delay_in_days": delay_in_days}, participant_trigger_referral_params.ParticipantTriggerReferralParams
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=ParticipantTriggerReferralResponse,
+        )
+
+    async def cancel_delayed_referral(
+        self,
+        participant_id_or_email: str,
+        *,
+        id: str,
+        # 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,
+    ) -> ParticipantTriggerReferralResponse:
+        """
+        Cancels a pending delayed referral trigger for a participant by GrowSurf
+        participant ID or email address.
+
+        Args:
+          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
+        """
+        if not id:
+            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        if not participant_id_or_email:
+            raise ValueError(
+                f"Expected a non-empty value for `participant_id_or_email` but received {participant_id_or_email!r}"
+            )
+        return await self._delete(
             path_template(
                 "/campaign/{id}/participant/{participant_id_or_email}/ref",
                 id=id,
@@ -1474,12 +1745,18 @@ class ParticipantResourceWithRawResponse:
         self.record_transaction = to_raw_response_wrapper(
             participant.record_transaction,
         )
+        self.refund_transaction = to_raw_response_wrapper(
+            participant.refund_transaction,
+        )
         self.send_invites = to_raw_response_wrapper(
             participant.send_invites,
         )
         self.trigger_referral = to_raw_response_wrapper(
             participant.trigger_referral,
         )
+        self.cancel_delayed_referral = to_raw_response_wrapper(
+            participant.cancel_delayed_referral,
+        )
 
 
 class AsyncParticipantResourceWithRawResponse:
@@ -1513,12 +1790,18 @@ class AsyncParticipantResourceWithRawResponse:
         self.record_transaction = async_to_raw_response_wrapper(
             participant.record_transaction,
         )
+        self.refund_transaction = async_to_raw_response_wrapper(
+            participant.refund_transaction,
+        )
         self.send_invites = async_to_raw_response_wrapper(
             participant.send_invites,
         )
         self.trigger_referral = async_to_raw_response_wrapper(
             participant.trigger_referral,
         )
+        self.cancel_delayed_referral = async_to_raw_response_wrapper(
+            participant.cancel_delayed_referral,
+        )
 
 
 class ParticipantResourceWithStreamingResponse:
@@ -1552,12 +1835,18 @@ class ParticipantResourceWithStreamingResponse:
         self.record_transaction = to_streamed_response_wrapper(
             participant.record_transaction,
         )
+        self.refund_transaction = to_streamed_response_wrapper(
+            participant.refund_transaction,
+        )
         self.send_invites = to_streamed_response_wrapper(
             participant.send_invites,
         )
         self.trigger_referral = to_streamed_response_wrapper(
             participant.trigger_referral,
         )
+        self.cancel_delayed_referral = to_streamed_response_wrapper(
+            participant.cancel_delayed_referral,
+        )
 
 
 class AsyncParticipantResourceWithStreamingResponse:
@@ -1591,9 +1880,15 @@ class AsyncParticipantResourceWithStreamingResponse:
         self.record_transaction = async_to_streamed_response_wrapper(
             participant.record_transaction,
         )
+        self.refund_transaction = async_to_streamed_response_wrapper(
+            participant.refund_transaction,
+        )
         self.send_invites = async_to_streamed_response_wrapper(
             participant.send_invites,
         )
         self.trigger_referral = async_to_streamed_response_wrapper(
             participant.trigger_referral,
         )
+        self.cancel_delayed_referral = async_to_streamed_response_wrapper(
+            participant.cancel_delayed_referral,
+        )

{growsurf_python-0.6.1 → growsurf_python-0.7.0}/src/growsurf/types/campaign/__init__.py

@@ -24,12 +24,19 @@ from .participant_list_referrals_params import ParticipantListReferralsParams as
 from .participant_list_rewards_response import ParticipantListRewardsResponse as ParticipantListRewardsResponse
 from .participant_send_invites_response import ParticipantSendInvitesResponse as ParticipantSendInvitesResponse
 from .participant_list_commissions_params import ParticipantListCommissionsParams as ParticipantListCommissionsParams
+from .participant_trigger_referral_params import ParticipantTriggerReferralParams as ParticipantTriggerReferralParams
 from .participant_record_transaction_params import (
     ParticipantRecordTransactionParams as ParticipantRecordTransactionParams,
 )
+from .participant_refund_transaction_params import (
+    ParticipantRefundTransactionParams as ParticipantRefundTransactionParams,
+)
 from .participant_trigger_referral_response import (
     ParticipantTriggerReferralResponse as ParticipantTriggerReferralResponse,
 )
 from .participant_record_transaction_response import (
     ParticipantRecordTransactionResponse as ParticipantRecordTransactionResponse,
 )
+from .participant_refund_transaction_response import (
+    ParticipantRefundTransactionResponse as ParticipantRefundTransactionResponse,
+)

growsurf_python-0.7.0/src/growsurf/types/campaign/participant_refund_transaction_params.py

@@ -0,0 +1,43 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Literal, Required, Annotated, TypedDict
+
+from ..._utils import PropertyInfo
+
+__all__ = ["ParticipantRefundTransactionParams"]
+
+
+class ParticipantRefundTransactionParams(TypedDict, total=False):
+    id: Required[str]
+
+    amendment_type: Annotated[Literal["REFUND", "CHARGEBACK"], PropertyInfo(alias="amendmentType")]
+
+    amount: int
+
+    amount_refunded: Annotated[int, PropertyInfo(alias="amountRefunded")]
+
+    charge_id: Annotated[str, PropertyInfo(alias="chargeId")]
+
+    currency: str
+
+    description: str
+
+    external_id: Annotated[str, PropertyInfo(alias="externalId")]
+
+    invoice_id: Annotated[str, PropertyInfo(alias="invoiceId")]
+
+    order_id: Annotated[str, PropertyInfo(alias="orderId")]
+
+    payment_id: Annotated[str, PropertyInfo(alias="paymentId")]
+
+    payment_intent_id: Annotated[str, PropertyInfo(alias="paymentIntentId")]
+
+    refund_amount: Annotated[int, PropertyInfo(alias="refundAmount")]
+
+    refund_id: Annotated[str, PropertyInfo(alias="refundId")]
+
+    refund_status: Annotated[str, PropertyInfo(alias="refundStatus")]
+
+    transaction_id: Annotated[str, PropertyInfo(alias="transactionId")]

growsurf_python-0.7.0/src/growsurf/types/campaign/participant_refund_transaction_response.py

@@ -0,0 +1,30 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List, Optional
+from typing_extensions import Literal
+
+from pydantic import Field as FieldInfo
+
+from ..._models import BaseModel
+
+__all__ = ["ParticipantRefundTransactionResponse"]
+
+
+class ParticipantRefundTransactionResponse(BaseModel):
+    adjusted: int
+
+    amendment_type: Literal["REFUND", "CHARGEBACK"] = FieldInfo(alias="amendmentType")
+
+    deleted: int
+
+    matched: int
+
+    matching_commission_ids: List[str] = FieldInfo(alias="matchingCommissionIds")
+
+    message: str
+
+    reversed: int
+
+    success: bool
+
+    not_found: Optional[bool] = FieldInfo(alias="notFound", default=None)

growsurf_python-0.7.0/src/growsurf/types/campaign/participant_trigger_referral_params.py

@@ -0,0 +1,22 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Required, Annotated, TypedDict
+
+from ..._utils import PropertyInfo
+
+__all__ = ["ParticipantTriggerReferralParams"]
+
+
+class ParticipantTriggerReferralParams(TypedDict, total=False):
+    id: Required[str]
+
+    delay_in_days: Annotated[int, PropertyInfo(alias="delayInDays")]
+    """Number of whole days to hold referral credit before it is awarded.
+
+    Useful for honoring a refund window before crediting a referrer. Omit this field
+    to award credit immediately. The credit is awarded automatically once the delay
+    elapses, and can be cancelled before then with the Cancel delayed referral
+    trigger request.
+    """