agentref 1.0.4__tar.gz → 2.0.0__tar.gz

{agentref-1.0.4 → agentref-2.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentref
-Version: 1.0.4
+Version: 2.0.0
 Summary: Official Python SDK for the AgentRef Affiliate API
 Author-email: AgentRef <hi@agentref.dev>
 License: MIT

{agentref-1.0.4 → agentref-2.0.0}/agentref/resources/merchant.py

@@ -23,6 +23,9 @@ class MerchantResource:
         timezone: Optional[str] = None,
         default_cookie_duration: Optional[int] = None,
         default_payout_threshold: Optional[int] = None,
+        tracking_requires_consent: Optional[bool] = None,
+        tracking_param_aliases: Optional[list[str]] = None,
+        tracking_legacy_metadata_fallback_enabled: Optional[bool] = None,
     ) -> Merchant:
         payload = UpdateMerchantParams(
             company_name=company_name,
@@ -31,6 +34,9 @@ class MerchantResource:
             timezone=timezone,
             default_cookie_duration=default_cookie_duration,
             default_payout_threshold=default_payout_threshold,
+            tracking_requires_consent=tracking_requires_consent,
+            tracking_param_aliases=tracking_param_aliases,
+            tracking_legacy_metadata_fallback_enabled=tracking_legacy_metadata_fallback_enabled,
         ).model_dump(by_alias=True, exclude_none=True)
         envelope = self._http.request("PATCH", "/merchant", json=payload)
         return Merchant.model_validate(envelope["data"])
@@ -61,6 +67,9 @@ class AsyncMerchantResource:
         timezone: Optional[str] = None,
         default_cookie_duration: Optional[int] = None,
         default_payout_threshold: Optional[int] = None,
+        tracking_requires_consent: Optional[bool] = None,
+        tracking_param_aliases: Optional[list[str]] = None,
+        tracking_legacy_metadata_fallback_enabled: Optional[bool] = None,
     ) -> Merchant:
         payload = UpdateMerchantParams(
             company_name=company_name,
@@ -69,6 +78,9 @@ class AsyncMerchantResource:
             timezone=timezone,
             default_cookie_duration=default_cookie_duration,
             default_payout_threshold=default_payout_threshold,
+            tracking_requires_consent=tracking_requires_consent,
+            tracking_param_aliases=tracking_param_aliases,
+            tracking_legacy_metadata_fallback_enabled=tracking_legacy_metadata_fallback_enabled,
         ).model_dump(by_alias=True, exclude_none=True)
         envelope = await self._http.request("PATCH", "/merchant", json=payload)
         return Merchant.model_validate(envelope["data"])

{agentref-1.0.4 → agentref-2.0.0}/agentref/resources/payout_info.py

@@ -19,7 +19,9 @@ class PayoutInfoResource:
         *,
         payout_method: Optional[str] = None,
         paypal_email: Optional[str] = None,
+        bank_account_holder: Optional[str] = None,
         bank_iban: Optional[str] = None,
+        bank_bic: Optional[str] = None,
         first_name: Optional[str] = None,
         last_name: Optional[str] = None,
         address_line1: Optional[str] = None,
@@ -32,7 +34,9 @@ class PayoutInfoResource:
         payload = UpdatePayoutInfoParams(
             payout_method=payout_method,
             paypal_email=paypal_email,
+            bank_account_holder=bank_account_holder,
             bank_iban=bank_iban,
+            bank_bic=bank_bic,
             first_name=first_name,
             last_name=last_name,
             address_line1=address_line1,
@@ -59,7 +63,9 @@ class AsyncPayoutInfoResource:
         *,
         payout_method: Optional[str] = None,
         paypal_email: Optional[str] = None,
+        bank_account_holder: Optional[str] = None,
         bank_iban: Optional[str] = None,
+        bank_bic: Optional[str] = None,
         first_name: Optional[str] = None,
         last_name: Optional[str] = None,
         address_line1: Optional[str] = None,
@@ -72,7 +78,9 @@ class AsyncPayoutInfoResource:
         payload = UpdatePayoutInfoParams(
             payout_method=payout_method,
             paypal_email=paypal_email,
+            bank_account_holder=bank_account_holder,
             bank_iban=bank_iban,
+            bank_bic=bank_bic,
             first_name=first_name,
             last_name=last_name,
             address_line1=address_line1,

{agentref-1.0.4 → agentref-2.0.0}/agentref/resources/programs.py

@@ -68,6 +68,8 @@ class ProgramsResource:
         description: Optional[str] = None,
         landing_page_url: Optional[str] = None,
         commission_limit_months: Optional[int] = None,
+        portal_slug: Optional[str] = None,
+        currency: Optional[str] = None,
         idempotency_key: Optional[str] = None,
     ) -> Program:
         body: Dict[str, Any] = {
@@ -80,6 +82,8 @@ class ProgramsResource:
             "description": description,
             "landingPageUrl": landing_page_url,
             "commissionLimitMonths": commission_limit_months,
+            "portalSlug": portal_slug,
+            "currency": currency,
         }
         envelope = self._http.request(
             "POST",
@@ -102,8 +106,9 @@ class ProgramsResource:
         description: Optional[str] = None,
         landing_page_url: Optional[str] = None,
         status: Optional[Literal["active", "paused", "archived"]] = None,
-        is_public: Optional[bool] = None,
         commission_limit_months: Optional[int] = None,
+        portal_slug: Optional[str] = None,
+        currency: Optional[str] = None,
     ) -> Program:
         body: Dict[str, Any] = {
             "name": name,
@@ -115,8 +120,9 @@ class ProgramsResource:
             "description": description,
             "landingPageUrl": landing_page_url,
             "status": status,
-            "isPublic": is_public,
             "commissionLimitMonths": commission_limit_months,
+            "portalSlug": portal_slug,
+            "currency": currency,
         }
         envelope = self._http.request("PATCH", f"/programs/{id}", json={k: v for k, v in body.items() if v is not None})
         return Program.model_validate(envelope["data"])
@@ -227,7 +233,7 @@ class ProgramsResource:
         self,
         id: str,
         *,
-        status: Optional[Literal["private", "public"]] = None,
+        status: Optional[Literal["private", "pending", "public"]] = None,
         category: Optional[str] = None,
         description: Optional[str] = None,
         logo_url: Optional[str] = None,
@@ -297,6 +303,8 @@ class AsyncProgramsResource:
         description: Optional[str] = None,
         landing_page_url: Optional[str] = None,
         commission_limit_months: Optional[int] = None,
+        portal_slug: Optional[str] = None,
+        currency: Optional[str] = None,
         idempotency_key: Optional[str] = None,
     ) -> Program:
         body: Dict[str, Any] = {
@@ -309,6 +317,8 @@ class AsyncProgramsResource:
             "description": description,
             "landingPageUrl": landing_page_url,
             "commissionLimitMonths": commission_limit_months,
+            "portalSlug": portal_slug,
+            "currency": currency,
         }
         envelope = await self._http.request(
             "POST",
@@ -331,8 +341,9 @@ class AsyncProgramsResource:
         description: Optional[str] = None,
         landing_page_url: Optional[str] = None,
         status: Optional[Literal["active", "paused", "archived"]] = None,
-        is_public: Optional[bool] = None,
         commission_limit_months: Optional[int] = None,
+        portal_slug: Optional[str] = None,
+        currency: Optional[str] = None,
     ) -> Program:
         body: Dict[str, Any] = {
             "name": name,
@@ -344,8 +355,9 @@ class AsyncProgramsResource:
             "description": description,
             "landingPageUrl": landing_page_url,
             "status": status,
-            "isPublic": is_public,
             "commissionLimitMonths": commission_limit_months,
+            "portalSlug": portal_slug,
+            "currency": currency,
         }
         envelope = await self._http.request("PATCH", f"/programs/{id}", json={k: v for k, v in body.items() if v is not None})
         return Program.model_validate(envelope["data"])
@@ -456,7 +468,7 @@ class AsyncProgramsResource:
         self,
         id: str,
         *,
-        status: Optional[Literal["private", "public"]] = None,
+        status: Optional[Literal["private", "pending", "public"]] = None,
         category: Optional[str] = None,
         description: Optional[str] = None,
         logo_url: Optional[str] = None,

{agentref-1.0.4 → agentref-2.0.0}/agentref/types/models.py

@@ -32,18 +32,26 @@ class Program(BaseModel):
     model_config = _API_CONFIG
 
     id: str
+    merchant_id: str
     name: str
+    description: Optional[str] = None
+    slug: str
+    landing_page_url: Optional[str] = None
+    portal_slug: Optional[str] = None
+    status: str
+    marketplace_status: str
+    marketplace_category: Optional[str] = None
+    marketplace_description: Optional[str] = None
+    marketplace_logo_url: Optional[str] = None
     commission_type: str
     commission_percent: float
     commission_limit_months: Optional[int] = None
+    commission_hold_days: int
     cookie_duration: int
     payout_threshold: int
+    currency: str
     auto_approve_affiliates: bool
-    description: Optional[str] = None
-    landing_page_url: Optional[str] = None
-    status: str
-    is_public: bool
-    merchant_id: str
+    terms_url: Optional[str] = None
     created_at: str
     updated_at: str
 
@@ -51,17 +59,21 @@ class Program(BaseModel):
 class ProgramStats(BaseModel):
     model_config = _API_CONFIG
 
-    clicks: int
-    conversions: int
-    revenue: float
-    commissions: float
-    period: str
+    program_id: str
+    program_name: str
+    status: str
+    total_revenue: float
+    total_conversions: int
+    total_commissions: float
+    pending_commissions: float
+    active_affiliates: int
+    conversions_by_status: Dict[str, int]
 
 
 class UpdateProgramMarketplaceParams(BaseModel):
     model_config = _API_CONFIG
 
-    status: Optional[Literal["private", "public"]] = None
+    status: Optional[Literal["private", "pending", "public"]] = None
     category: Optional[str] = None
     description: Optional[str] = None
     logo_url: Optional[str] = None
@@ -209,13 +221,32 @@ class Merchant(BaseModel):
     model_config = _API_CONFIG
 
     id: str
-    email: str
-    company_name: Optional[str] = None
-    domain: Optional[str] = None
-    domain_verified: bool
-    trust_level: str
-    stripe_connected: bool
+    user_id: str
+    company_name: str
+    website: Optional[str] = None
+    logo_url: Optional[str] = None
+    stripe_account_id: Optional[str] = None
+    stripe_connected_at: Optional[str] = None
+    billing_tier: str
+    stripe_customer_id: Optional[str] = None
+    stripe_subscription_id: Optional[str] = None
+    payment_status: str
+    last_payment_failed_at: Optional[str] = None
+    default_cookie_duration: int
+    default_payout_threshold: int
+    timezone: str
+    tracking_requires_consent: bool
+    tracking_param_aliases: List[str]
+    tracking_legacy_metadata_fallback_enabled: bool
+    state: str
+    verified_domain: Optional[str] = None
+    domain_verification_token: Optional[str] = None
+    domain_verified_at: Optional[str] = None
+    notification_preferences: Optional[Dict[str, bool]] = None
+    onboarding_completed: bool
+    onboarding_step: int
     created_at: str
+    updated_at: str
 
 
 class UpdateMerchantParams(BaseModel):
@@ -227,14 +258,20 @@ class UpdateMerchantParams(BaseModel):
     timezone: Optional[str] = None
     default_cookie_duration: Optional[int] = None
     default_payout_threshold: Optional[int] = None
+    tracking_requires_consent: Optional[bool] = None
+    tracking_param_aliases: Optional[List[str]] = None
+    tracking_legacy_metadata_fallback_enabled: Optional[bool] = None
 
 
 class MerchantDomainStatus(BaseModel):
     model_config = _API_CONFIG
 
+    status: str
     domain: Optional[str] = None
-    verified: bool
     txt_record: Optional[str] = None
+    verified_at: Optional[str] = None
+    tracking_mode: str
+    advanced_tracking_enabled: bool
 
 
 class StripeConnectSession(BaseModel):
@@ -268,7 +305,9 @@ class PayoutInfo(BaseModel):
 
     payout_method: Optional[str] = None
     paypal_email: Optional[str] = None
+    bank_account_holder: Optional[str] = None
     bank_iban: Optional[str] = None
+    bank_bic: Optional[str] = None
     first_name: Optional[str] = None
     last_name: Optional[str] = None
     address_line1: Optional[str] = None
@@ -284,7 +323,9 @@ class UpdatePayoutInfoParams(BaseModel):
 
     payout_method: Optional[str] = None
     paypal_email: Optional[str] = None
+    bank_account_holder: Optional[str] = None
     bank_iban: Optional[str] = None
+    bank_bic: Optional[str] = None
     first_name: Optional[str] = None
     last_name: Optional[str] = None
     address_line1: Optional[str] = None
@@ -302,7 +343,7 @@ class NotificationPreferences(BaseModel):
     new_conversion: bool = True
     commission_approved: bool = True
     payout_processed: bool = True
-    weekly_digest: bool = True
+    weekly_digest: bool = False
 
 
 class UpdateNotificationPreferencesParams(BaseModel):

{agentref-1.0.4 → agentref-2.0.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "agentref"
-version = "1.0.4"
+version = "2.0.0"
 description = "Official Python SDK for the AgentRef Affiliate API"
 authors = [{ name = "AgentRef", email = "hi@agentref.dev" }]
 license = { text = "MIT" }

{agentref-1.0.4 → agentref-2.0.0}/tests/test_async.py

@@ -40,18 +40,26 @@ async def test_async_list_all_stops_on_has_more_false() -> None:
                         "data": [
                             {
                                 "id": "prog_1",
+                                "merchantId": "merch_1",
                                 "name": "Program",
                                 "description": None,
+                                "slug": "program",
                                 "landingPageUrl": None,
+                                "portalSlug": "program",
+                                "status": "active",
+                                "marketplaceStatus": "public",
+                                "marketplaceCategory": None,
+                                "marketplaceDescription": None,
+                                "marketplaceLogoUrl": None,
                                 "commissionType": "one_time",
                                 "commissionPercent": 20,
                                 "commissionLimitMonths": None,
+                                "commissionHoldDays": 30,
                                 "cookieDuration": 30,
                                 "payoutThreshold": 5000,
+                                "currency": "USD",
                                 "autoApproveAffiliates": True,
-                                "status": "active",
-                                "isPublic": True,
-                                "merchantId": "merch_1",
+                                "termsUrl": None,
                                 "createdAt": "2026-01-01T00:00:00Z",
                                 "updatedAt": "2026-01-01T00:00:00Z",
                             }
@@ -71,18 +79,26 @@ async def test_async_list_all_stops_on_has_more_false() -> None:
                         "data": [
                             {
                                 "id": "prog_2",
+                                "merchantId": "merch_1",
                                 "name": "Program",
                                 "description": None,
+                                "slug": "program",
                                 "landingPageUrl": None,
+                                "portalSlug": "program",
+                                "status": "active",
+                                "marketplaceStatus": "public",
+                                "marketplaceCategory": None,
+                                "marketplaceDescription": None,
+                                "marketplaceLogoUrl": None,
                                 "commissionType": "one_time",
                                 "commissionPercent": 20,
                                 "commissionLimitMonths": None,
+                                "commissionHoldDays": 30,
                                 "cookieDuration": 30,
                                 "payoutThreshold": 5000,
+                                "currency": "USD",
                                 "autoApproveAffiliates": True,
-                                "status": "active",
-                                "isPublic": True,
-                                "merchantId": "merch_1",
+                                "termsUrl": None,
                                 "createdAt": "2026-01-01T00:00:00Z",
                                 "updatedAt": "2026-01-01T00:00:00Z",
                             }

{agentref-1.0.4 → agentref-2.0.0}/tests/test_errors.py

@@ -38,15 +38,26 @@ def test_pydantic_models_parse_camel_case() -> None:
     program = Program.model_validate(
         {
             "id": "p1",
+            "merchantId": "m1",
             "name": "Test",
+            "description": None,
+            "slug": "test",
+            "landingPageUrl": None,
+            "portalSlug": "test",
+            "status": "active",
+            "marketplaceStatus": "public",
+            "marketplaceCategory": None,
+            "marketplaceDescription": None,
+            "marketplaceLogoUrl": None,
             "commissionType": "one_time",
             "commissionPercent": 20.0,
+            "commissionLimitMonths": None,
+            "commissionHoldDays": 30,
             "cookieDuration": 30,
             "payoutThreshold": 5000,
+            "currency": "USD",
             "autoApproveAffiliates": True,
-            "status": "active",
-            "isPublic": True,
-            "merchantId": "m1",
+            "termsUrl": None,
             "createdAt": "2026-01-01T00:00:00Z",
             "updatedAt": "2026-01-01T00:00:00Z",
         }
@@ -58,6 +69,45 @@ def test_pydantic_models_parse_camel_case() -> None:
     assert program.auto_approve_affiliates is True
 
 
+def test_merchant_model_parses_current_rest_shape() -> None:
+    from agentref.types.models import Merchant
+
+    merchant = Merchant.model_validate(
+        {
+            "id": "merch_1",
+            "userId": "user_1",
+            "companyName": "AgentRef Inc",
+            "website": "https://agentref.dev",
+            "logoUrl": None,
+            "stripeAccountId": None,
+            "stripeConnectedAt": None,
+            "billingTier": "free",
+            "stripeCustomerId": None,
+            "stripeSubscriptionId": None,
+            "paymentStatus": "active",
+            "lastPaymentFailedAt": None,
+            "defaultCookieDuration": 30,
+            "defaultPayoutThreshold": 5000,
+            "timezone": "UTC",
+            "trackingRequiresConsent": True,
+            "trackingParamAliases": ["ref"],
+            "trackingLegacyMetadataFallbackEnabled": True,
+            "state": "verified",
+            "verifiedDomain": "agentref.dev",
+            "domainVerificationToken": None,
+            "domainVerifiedAt": "2026-01-01T00:00:00Z",
+            "notificationPreferences": {"newAffiliate": True},
+            "onboardingCompleted": True,
+            "onboardingStep": 4,
+            "createdAt": "2026-01-01T00:00:00Z",
+            "updatedAt": "2026-01-02T00:00:00Z",
+        }
+    )
+
+    assert merchant.state == "verified"
+    assert merchant.verified_domain == "agentref.dev"
+
+
 def test_pagination_meta_parses_camel_case() -> None:
     from agentref.types.models import PaginationMeta
 

agentref-2.0.0/tests/test_programs.py

@@ -0,0 +1,384 @@
+from __future__ import annotations
+
+import json
+
+import httpx
+import respx
+
+from agentref import AgentRef
+
+
+def _mock_program() -> dict:
+    return {
+        "id": "prog_1",
+        "merchantId": "merch_1",
+        "name": "Program",
+        "description": None,
+        "slug": "program",
+        "landingPageUrl": None,
+        "portalSlug": "program",
+        "status": "active",
+        "marketplaceStatus": "public",
+        "marketplaceCategory": None,
+        "marketplaceDescription": None,
+        "marketplaceLogoUrl": None,
+        "commissionType": "one_time",
+        "commissionPercent": 20,
+        "commissionLimitMonths": None,
+        "commissionHoldDays": 30,
+        "cookieDuration": 30,
+        "payoutThreshold": 5000,
+        "currency": "USD",
+        "autoApproveAffiliates": True,
+        "termsUrl": None,
+        "createdAt": "2026-01-01T00:00:00Z",
+        "updatedAt": "2026-01-01T00:00:00Z",
+    }
+
+
+def test_create_uses_real_field_names() -> None:
+    client = AgentRef(api_key="ak_live_test")
+
+    with respx.mock:
+        route = respx.post("https://www.agentref.dev/api/v1/programs").mock(
+            return_value=httpx.Response(201, json={"data": _mock_program(), "meta": {"requestId": "r"}})
+        )
+
+        client.programs.create(
+            name="Test",
+            commission_type="one_time",
+            commission_percent=20,
+            cookie_duration=30,
+            portal_slug="test-program",
+            currency="EUR",
+        )
+
+        body = json.loads(route.calls[0].request.content)
+
+    assert "commissionType" in body
+    assert "commissionPercent" in body
+    assert "cookieDuration" in body
+    assert body["portalSlug"] == "test-program"
+    assert body["currency"] == "EUR"
+    assert "commissionRate" not in body
+    assert "cookieDays" not in body
+
+
+def test_list_all_stops_on_has_more_false() -> None:
+    client = AgentRef(api_key="ak_live_test")
+
+    with respx.mock:
+        respx.get("https://www.agentref.dev/api/v1/programs").mock(
+            side_effect=[
+                httpx.Response(
+                    200,
+                    json={
+                        "data": [_mock_program()],
+                        "meta": {"total": 2, "page": 1, "pageSize": 1, "hasMore": True, "requestId": "r1"},
+                    },
+                ),
+                httpx.Response(
+                    200,
+                    json={
+                        "data": [{**_mock_program(), "id": "prog_2"}],
+                        "meta": {"total": 2, "page": 2, "pageSize": 1, "hasMore": False, "requestId": "r2"},
+                    },
+                ),
+            ]
+        )
+
+        all_programs = list(client.programs.list_all(page_size=1))
+
+    assert len(all_programs) == 2
+    assert all_programs[0].id == "prog_1"
+    assert all_programs[1].id == "prog_2"
+
+
+def test_flags_resolve_sends_block_affiliate_true() -> None:
+    client = AgentRef(api_key="ak_live_test")
+
+    with respx.mock:
+        route = respx.post("https://www.agentref.dev/api/v1/flags/flag_1/resolve").mock(
+            return_value=httpx.Response(
+                200,
+                json={
+                    "data": {
+                        "id": "flag_1",
+                        "affiliateId": "aff_1",
+                        "type": "manual_review",
+                        "status": "confirmed",
+                        "details": {"source": "test"},
+                        "note": "confirmed fraud",
+                        "createdAt": "2026-01-01T00:00:00Z",
+                        "resolvedAt": "2026-01-01T01:00:00Z",
+                    },
+                    "meta": {"requestId": "r"},
+                },
+            )
+        )
+
+        client.flags.resolve(
+            "flag_1",
+            status="confirmed",
+            note="confirmed fraud",
+            block_affiliate=True,
+            idempotency_key="idem-flag-1",
+        )
+
+        body = json.loads(route.calls[0].request.content)
+
+    assert body["status"] == "confirmed"
+    assert body["blockAffiliate"] is True
+
+
+def test_list_invites_returns_typed_invites() -> None:
+    client = AgentRef(api_key="ak_live_test")
+
+    with respx.mock:
+        respx.get("https://www.agentref.dev/api/v1/programs/prog_1/invites").mock(
+            return_value=httpx.Response(
+                200,
+                json={
+                    "data": [
+                        {
+                            "token": "tok_1",
+                            "email": "affiliate@example.com",
+                            "programId": "prog_1",
+                            "expiresAt": "2026-12-01T00:00:00Z",
+                            "createdAt": "2026-01-01T00:00:00Z",
+                        }
+                    ],
+                    "meta": {"requestId": "r"},
+                },
+            )
+        )
+        invites = client.programs.list_invites("prog_1")
+    assert invites[0].token == "tok_1"
+
+
+def test_update_marketplace_uses_camel_case_payload() -> None:
+    client = AgentRef(api_key="ak_live_test")
+
+    with respx.mock:
+        route = respx.patch("https://www.agentref.dev/api/v1/programs/prog_1/marketplace").mock(
+            return_value=httpx.Response(200, json={"data": {"status": "pending"}, "meta": {"requestId": "r"}})
+        )
+        client.programs.update_marketplace("prog_1", status="pending", logo_url="https://cdn.example.com/logo.png")
+        body = json.loads(route.calls[0].request.content)
+    assert body["status"] == "pending"
+    assert body["logoUrl"] == "https://cdn.example.com/logo.png"
+
+
+def test_payouts_create_sends_idempotency_and_body() -> None:
+    client = AgentRef(api_key="ak_live_test")
+
+    with respx.mock:
+        route = respx.post("https://www.agentref.dev/api/v1/payouts").mock(
+            return_value=httpx.Response(201, json={"data": {"id": "pay_1"}, "meta": {"requestId": "r"}})
+        )
+        client.payouts.create(
+            affiliate_id="aff_1",
+            program_id="prog_1",
+            method="paypal",
+            idempotency_key="idem-payout-1",
+        )
+        body = json.loads(route.calls[0].request.content)
+        idempotency = route.calls[0].request.headers.get("idempotency-key")
+    assert body["affiliateId"] == "aff_1"
+    assert body["programId"] == "prog_1"
+    assert body["method"] == "paypal"
+    assert idempotency == "idem-payout-1"
+
+
+def test_merchant_update_and_connect_stripe() -> None:
+    client = AgentRef(api_key="ak_live_test")
+
+    with respx.mock:
+        update_route = respx.patch("https://www.agentref.dev/api/v1/merchant").mock(
+            return_value=httpx.Response(
+                200,
+                json={
+                    "data": {
+                        "id": "merch_1",
+                        "userId": "user_1",
+                        "companyName": "AgentRef Inc",
+                        "website": "https://agentref.dev",
+                        "logoUrl": None,
+                        "stripeAccountId": None,
+                        "stripeConnectedAt": None,
+                        "billingTier": "free",
+                        "stripeCustomerId": None,
+                        "stripeSubscriptionId": None,
+                        "paymentStatus": "active",
+                        "lastPaymentFailedAt": None,
+                        "defaultCookieDuration": 30,
+                        "defaultPayoutThreshold": 5000,
+                        "timezone": "UTC",
+                        "trackingRequiresConsent": True,
+                        "trackingParamAliases": ["ref", "partner"],
+                        "trackingLegacyMetadataFallbackEnabled": True,
+                        "state": "verified",
+                        "verifiedDomain": "agentref.dev",
+                        "domainVerificationToken": None,
+                        "domainVerifiedAt": "2026-01-01T00:00:00Z",
+                        "notificationPreferences": {"newAffiliate": True},
+                        "onboardingCompleted": True,
+                        "onboardingStep": 4,
+                        "createdAt": "2026-01-01T00:00:00Z",
+                        "updatedAt": "2026-01-02T00:00:00Z",
+                    },
+                    "meta": {"requestId": "r"},
+                },
+            )
+        )
+        connect_route = respx.post("https://www.agentref.dev/api/v1/merchant/connect-stripe").mock(
+            return_value=httpx.Response(200, json={"data": {"url": "https://connect.stripe.com/x"}, "meta": {"requestId": "r"}})
+        )
+
+        merchant = client.merchant.update(
+            company_name="AgentRef Inc",
+            tracking_requires_consent=True,
+            tracking_param_aliases=["ref", "partner"],
+        )
+        connect = client.merchant.connect_stripe()
+        update_body = json.loads(update_route.calls[0].request.content)
+        connect_method = connect_route.calls[0].request.method
+
+    assert merchant.company_name == "AgentRef Inc"
+    assert update_body["companyName"] == "AgentRef Inc"
+    assert update_body["trackingRequiresConsent"] is True
+    assert update_body["trackingParamAliases"] == ["ref", "partner"]
+    assert merchant.state == "verified"
+    assert merchant.verified_domain == "agentref.dev"
+    assert connect.url.startswith("https://connect.stripe.com")
+    assert connect_method == "POST"
+
+
+def test_merchant_domain_status_uses_current_contract() -> None:
+    client = AgentRef(api_key="ak_live_test")
+
+    with respx.mock:
+        respx.get("https://www.agentref.dev/api/v1/merchant/domain-status").mock(
+            return_value=httpx.Response(
+                200,
+                json={
+                    "data": {
+                        "status": "verified",
+                        "domain": "agentref.dev",
+                        "txtRecord": None,
+                        "verifiedAt": "2026-01-01T00:00:00Z",
+                        "trackingMode": "advanced",
+                        "advancedTrackingEnabled": True,
+                    },
+                    "meta": {"requestId": "r"},
+                },
+            )
+        )
+
+        status = client.merchant.domain_status()
+
+    assert status.status == "verified"
+    assert status.tracking_mode == "advanced"
+
+
+def test_program_stats_uses_current_contract() -> None:
+    client = AgentRef(api_key="ak_live_test")
+
+    with respx.mock:
+        respx.get("https://www.agentref.dev/api/v1/programs/prog_1/stats").mock(
+            return_value=httpx.Response(
+                200,
+                json={
+                    "data": {
+                        "programId": "prog_1",
+                        "programName": "Growth Program",
+                        "status": "active",
+                        "totalRevenue": 25000,
+                        "totalConversions": 12,
+                        "totalCommissions": 5000,
+                        "pendingCommissions": 1200,
+                        "activeAffiliates": 3,
+                        "conversionsByStatus": {
+                            "pending": 1,
+                            "approved": 10,
+                            "rejected": 1,
+                            "refunded": 0,
+                        },
+                    },
+                    "meta": {"requestId": "r"},
+                },
+            )
+        )
+
+        stats = client.programs.stats("prog_1")
+
+    assert stats.program_id == "prog_1"
+    assert stats.conversions_by_status["approved"] == 10
+
+
+def test_payout_info_supports_bank_fields() -> None:
+    client = AgentRef(api_key="ak_live_test")
+
+    with respx.mock:
+        get_route = respx.get("https://www.agentref.dev/api/v1/me/payout-info").mock(
+            return_value=httpx.Response(
+                200,
+                json={
+                    "data": {
+                        "payoutMethod": "bank_transfer",
+                        "paypalEmail": None,
+                        "bankAccountHolder": "Jane Doe",
+                        "bankIban": "****1234",
+                        "bankBic": "COBADEFFXXX",
+                        "firstName": "Jane",
+                        "lastName": "Doe",
+                        "addressLine1": "Main Street 1",
+                        "addressLine2": None,
+                        "city": "Berlin",
+                        "state": None,
+                        "postalCode": "10115",
+                        "vatId": "DE123",
+                    },
+                    "meta": {"requestId": "r"},
+                },
+            )
+        )
+        update_route = respx.patch("https://www.agentref.dev/api/v1/me/payout-info").mock(
+            return_value=httpx.Response(
+                200,
+                json={
+                    "data": {
+                        "payoutMethod": "bank_transfer",
+                        "paypalEmail": None,
+                        "bankAccountHolder": "Jane Doe",
+                        "bankIban": "****1234",
+                        "bankBic": "COBADEFFXXX",
+                        "firstName": "Jane",
+                        "lastName": "Doe",
+                        "addressLine1": "Main Street 1",
+                        "addressLine2": None,
+                        "city": "Berlin",
+                        "state": None,
+                        "postalCode": "10115",
+                        "vatId": "DE123",
+                    },
+                    "meta": {"requestId": "r"},
+                },
+            )
+        )
+
+        payout_info = client.payout_info.get()
+        client.payout_info.update(
+            payout_method="bank_transfer",
+            bank_account_holder="Jane Doe",
+            bank_iban="DE89370400440532013000",
+            bank_bic="COBADEFFXXX",
+        )
+
+        update_body = json.loads(update_route.calls[0].request.content)
+
+    assert get_route.called
+    assert payout_info.bank_account_holder == "Jane Doe"
+    assert payout_info.bank_bic == "COBADEFFXXX"
+    assert update_body["bankAccountHolder"] == "Jane Doe"
+    assert update_body["bankBic"] == "COBADEFFXXX"

agentref-1.0.4/tests/test_programs.py

@@ -1,215 +0,0 @@
-from __future__ import annotations
-
-import json
-
-import httpx
-import respx
-
-from agentref import AgentRef
-
-
-def _mock_program() -> dict:
-    return {
-        "id": "prog_1",
-        "name": "Program",
-        "description": None,
-        "landingPageUrl": None,
-        "commissionType": "one_time",
-        "commissionPercent": 20,
-        "commissionLimitMonths": None,
-        "cookieDuration": 30,
-        "payoutThreshold": 5000,
-        "autoApproveAffiliates": True,
-        "status": "active",
-        "isPublic": True,
-        "merchantId": "merch_1",
-        "createdAt": "2026-01-01T00:00:00Z",
-        "updatedAt": "2026-01-01T00:00:00Z",
-    }
-
-
-def test_create_uses_real_field_names() -> None:
-    client = AgentRef(api_key="ak_live_test")
-
-    with respx.mock:
-        route = respx.post("https://www.agentref.dev/api/v1/programs").mock(
-            return_value=httpx.Response(201, json={"data": _mock_program(), "meta": {"requestId": "r"}})
-        )
-
-        client.programs.create(
-            name="Test",
-            commission_type="one_time",
-            commission_percent=20,
-            cookie_duration=30,
-        )
-
-        body = json.loads(route.calls[0].request.content)
-
-    assert "commissionType" in body
-    assert "commissionPercent" in body
-    assert "cookieDuration" in body
-    assert "commissionRate" not in body
-    assert "cookieDays" not in body
-
-
-def test_list_all_stops_on_has_more_false() -> None:
-    client = AgentRef(api_key="ak_live_test")
-
-    with respx.mock:
-        respx.get("https://www.agentref.dev/api/v1/programs").mock(
-            side_effect=[
-                httpx.Response(
-                    200,
-                    json={
-                        "data": [_mock_program()],
-                        "meta": {"total": 2, "page": 1, "pageSize": 1, "hasMore": True, "requestId": "r1"},
-                    },
-                ),
-                httpx.Response(
-                    200,
-                    json={
-                        "data": [{**_mock_program(), "id": "prog_2"}],
-                        "meta": {"total": 2, "page": 2, "pageSize": 1, "hasMore": False, "requestId": "r2"},
-                    },
-                ),
-            ]
-        )
-
-        all_programs = list(client.programs.list_all(page_size=1))
-
-    assert len(all_programs) == 2
-    assert all_programs[0].id == "prog_1"
-    assert all_programs[1].id == "prog_2"
-
-
-def test_flags_resolve_sends_block_affiliate_true() -> None:
-    client = AgentRef(api_key="ak_live_test")
-
-    with respx.mock:
-        route = respx.post("https://www.agentref.dev/api/v1/flags/flag_1/resolve").mock(
-            return_value=httpx.Response(
-                200,
-                json={
-                    "data": {
-                        "id": "flag_1",
-                        "affiliateId": "aff_1",
-                        "type": "manual_review",
-                        "status": "confirmed",
-                        "details": {"source": "test"},
-                        "note": "confirmed fraud",
-                        "createdAt": "2026-01-01T00:00:00Z",
-                        "resolvedAt": "2026-01-01T01:00:00Z",
-                    },
-                    "meta": {"requestId": "r"},
-                },
-            )
-        )
-
-        client.flags.resolve(
-            "flag_1",
-            status="confirmed",
-            note="confirmed fraud",
-            block_affiliate=True,
-            idempotency_key="idem-flag-1",
-        )
-
-        body = json.loads(route.calls[0].request.content)
-
-    assert body["status"] == "confirmed"
-    assert body["blockAffiliate"] is True
-
-
-def test_list_invites_returns_typed_invites() -> None:
-    client = AgentRef(api_key="ak_live_test")
-
-    with respx.mock:
-        respx.get("https://www.agentref.dev/api/v1/programs/prog_1/invites").mock(
-            return_value=httpx.Response(
-                200,
-                json={
-                    "data": [
-                        {
-                            "token": "tok_1",
-                            "email": "affiliate@example.com",
-                            "programId": "prog_1",
-                            "expiresAt": "2026-12-01T00:00:00Z",
-                            "createdAt": "2026-01-01T00:00:00Z",
-                        }
-                    ],
-                    "meta": {"requestId": "r"},
-                },
-            )
-        )
-        invites = client.programs.list_invites("prog_1")
-    assert invites[0].token == "tok_1"
-
-
-def test_update_marketplace_uses_camel_case_payload() -> None:
-    client = AgentRef(api_key="ak_live_test")
-
-    with respx.mock:
-        route = respx.patch("https://www.agentref.dev/api/v1/programs/prog_1/marketplace").mock(
-            return_value=httpx.Response(200, json={"data": {"status": "public"}, "meta": {"requestId": "r"}})
-        )
-        client.programs.update_marketplace("prog_1", status="public", logo_url="https://cdn.example.com/logo.png")
-        body = json.loads(route.calls[0].request.content)
-    assert body["status"] == "public"
-    assert body["logoUrl"] == "https://cdn.example.com/logo.png"
-
-
-def test_payouts_create_sends_idempotency_and_body() -> None:
-    client = AgentRef(api_key="ak_live_test")
-
-    with respx.mock:
-        route = respx.post("https://www.agentref.dev/api/v1/payouts").mock(
-            return_value=httpx.Response(201, json={"data": {"id": "pay_1"}, "meta": {"requestId": "r"}})
-        )
-        client.payouts.create(
-            affiliate_id="aff_1",
-            program_id="prog_1",
-            method="paypal",
-            idempotency_key="idem-payout-1",
-        )
-        body = json.loads(route.calls[0].request.content)
-        idempotency = route.calls[0].request.headers.get("idempotency-key")
-    assert body["affiliateId"] == "aff_1"
-    assert body["programId"] == "prog_1"
-    assert body["method"] == "paypal"
-    assert idempotency == "idem-payout-1"
-
-
-def test_merchant_update_and_connect_stripe() -> None:
-    client = AgentRef(api_key="ak_live_test")
-
-    with respx.mock:
-        update_route = respx.patch("https://www.agentref.dev/api/v1/merchant").mock(
-            return_value=httpx.Response(
-                200,
-                json={
-                    "data": {
-                        "id": "merch_1",
-                        "email": "merchant@example.com",
-                        "companyName": "AgentRef Inc",
-                        "domain": None,
-                        "domainVerified": False,
-                        "trustLevel": "standard",
-                        "stripeConnected": False,
-                        "createdAt": "2026-01-01T00:00:00Z",
-                    },
-                    "meta": {"requestId": "r"},
-                },
-            )
-        )
-        connect_route = respx.post("https://www.agentref.dev/api/v1/merchant/connect-stripe").mock(
-            return_value=httpx.Response(200, json={"data": {"url": "https://connect.stripe.com/x"}, "meta": {"requestId": "r"}})
-        )
-
-        merchant = client.merchant.update(company_name="AgentRef Inc")
-        connect = client.merchant.connect_stripe()
-        update_body = json.loads(update_route.calls[0].request.content)
-        connect_method = connect_route.calls[0].request.method
-
-    assert merchant.company_name == "AgentRef Inc"
-    assert update_body["companyName"] == "AgentRef Inc"
-    assert connect.url.startswith("https://connect.stripe.com")
-    assert connect_method == "POST"