paynode-sdk-python 2.1.0__tar.gz → 2.2.1__tar.gz

{paynode_sdk_python-2.1.0/paynode_sdk_python.egg-info → paynode_sdk_python-2.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: paynode-sdk-python
-Version: 2.1.0
+Version: 2.2.1
 Summary: PayNode Protocol Python SDK for AI Agents
 Author-email: PayNodeLabs <contact@paynode.dev>
 License: MIT
@@ -16,6 +16,8 @@ Provides-Extra: test
 Requires-Dist: pytest>=7.0.0; extra == "test"
 Requires-Dist: responses>=0.23.0; extra == "test"
 Requires-Dist: pytest-mock>=3.10.0; extra == "test"
+Provides-Extra: webhook
+Requires-Dist: aiohttp>=3.9.0; extra == "webhook"
 Dynamic: license-file
 
 # PayNode Python SDK
@@ -23,7 +25,7 @@ Dynamic: license-file
 [![Official Documentation](https://img.shields.io/badge/Docs-docs.paynode.dev-00ff88?style=for-the-badge&logo=readthedocs)](https://docs.paynode.dev)
 [![PyPI Version](https://img.shields.io/pypi/v/paynode-sdk-python.svg?style=for-the-badge)](https://pypi.org/project/paynode-sdk-python/)
 
-The official Python SDK for the **PayNode Protocol (v3.1)**. PayNode allows autonomous AI Agents to seamlessly pay for APIs and computational resources using USDC on Base L2, utilizing the standardized HTTP 402 protocol with support for both on-chain receipts and off-chain signatures (EIP-3009).
+The official Python SDK for the **PayNode Protocol (v2.2.1)**. PayNode allows autonomous AI Agents to seamlessly pay for APIs and computational resources using USDC on Base L2, utilizing the standardized HTTP 402 protocol with support for both on-chain receipts and off-chain signatures (EIP-3009).
 
 ## 📖 Read the Docs
 
@@ -54,7 +56,7 @@ response = agent.request_gate("https://api.merchant.com/premium-data", method="P
 print(response.json())
 ```
 
-### Key Features (v2.1)
+### Key Features (v2.2.1)
 - **EIP-3009 Support**: Sign payments off-chain using `TransferWithAuthorization`, allowing for gasless or relayer-mediated settlement.
 - **X402 V2 Protocol**: JSON-based handshake for more structured and machine-readable payment instructions.
 - **Dual Flow**: Automatic fallback to V1 (on-chain receipts) for legacy merchant support.

{paynode_sdk_python-2.1.0 → paynode_sdk_python-2.2.1}/README.md

@@ -3,7 +3,7 @@
 [![Official Documentation](https://img.shields.io/badge/Docs-docs.paynode.dev-00ff88?style=for-the-badge&logo=readthedocs)](https://docs.paynode.dev)
 [![PyPI Version](https://img.shields.io/pypi/v/paynode-sdk-python.svg?style=for-the-badge)](https://pypi.org/project/paynode-sdk-python/)
 
-The official Python SDK for the **PayNode Protocol (v3.1)**. PayNode allows autonomous AI Agents to seamlessly pay for APIs and computational resources using USDC on Base L2, utilizing the standardized HTTP 402 protocol with support for both on-chain receipts and off-chain signatures (EIP-3009).
+The official Python SDK for the **PayNode Protocol (v2.2.1)**. PayNode allows autonomous AI Agents to seamlessly pay for APIs and computational resources using USDC on Base L2, utilizing the standardized HTTP 402 protocol with support for both on-chain receipts and off-chain signatures (EIP-3009).
 
 ## 📖 Read the Docs
 
@@ -34,7 +34,7 @@ response = agent.request_gate("https://api.merchant.com/premium-data", method="P
 print(response.json())
 ```
 
-### Key Features (v2.1)
+### Key Features (v2.2.1)
 - **EIP-3009 Support**: Sign payments off-chain using `TransferWithAuthorization`, allowing for gasless or relayer-mediated settlement.
 - **X402 V2 Protocol**: JSON-based handshake for more structured and machine-readable payment instructions.
 - **Dual Flow**: Automatic fallback to V1 (on-chain receipts) for legacy merchant support.

{paynode_sdk_python-2.1.0 → paynode_sdk_python-2.2.1}/paynode_sdk/client.py

@@ -1,3 +1,5 @@
+import json
+import base64
 import time
 import logging
 import threading
@@ -15,7 +17,7 @@ logger = logging.getLogger("paynode_sdk.client")
 
 class PayNodeAgentClient:
     """
-    The main PayNode Client for AI Agents (v3.1).
+    The main PayNode Client for AI Agents (v2.2.1).
     Automatically handles the x402 'Payment Required' handshake.
     Supports RPC redundancy, EIP-2612 Permit, and EIP-3009 Authorization.
     """
@@ -93,13 +95,13 @@ class PayNodeAgentClient:
     def _request_with_402_retry(self, method: str, url: str, max_retries: int = 3, **kwargs) -> requests.Response:
         response = None
         for attempt in range(max_retries):
-            response = self.session.request(method, url, **kwargs)
+            response = self._request_with_settlement_check(method, url, **kwargs)
             if response.status_code == 402:
                 logger.info(f"💡 [PayNode-PY] 402 Detected (Attempt {attempt+1}/{max_retries}). Analyzing protocol version...")
                 
-                # Check for x402 v2 (JSON body or X-402-Required header)
+                # Check for x402 v2 (JSON body or official PAYMENT-REQUIRED header)
                 content_type = response.headers.get('Content-Type', '')
-                b64_required = response.headers.get('X-402-Required')
+                b64_required = response.headers.get('PAYMENT-REQUIRED') or response.headers.get('X-402-Required')
                 order_id = response.headers.get('X-402-Order-Id')
                 
                 body = None
@@ -109,17 +111,22 @@ class PayNodeAgentClient:
                     except Exception as e:
                         logger.debug(f"⚠️ [PayNode-PY] Failed to parse 402 JSON body: {e}")
                 
-                if not body and b64_required:
+                header_body = None
+                if b64_required:
                     try:
-                        import base64
-                        import json
-                        body = json.loads(base64.b64decode(b64_required).decode())
+                        header_body = json.loads(base64.b64decode(b64_required).decode())
                     except Exception as e:
-                        logger.warning(f"❌ [PayNode-PY] Failed to decode X-402-Required header: {e}")
+                        logger.warning(f"❌ [PayNode-PY] Failed to decode PAYMENT-REQUIRED header: {e}")
+
+                if not body and header_body:
+                    body = header_body
+                elif body and header_body and not body.get('x402Version'):
+                    # Robustness: Merge header info into body if body is missing critical bits
+                    body.update({k: v for k, v in header_body.items() if k not in body})
 
                 if body and body.get('x402Version') == 2:
                     logger.info("🚀 [PayNode-PY] x402 v2 detected. Handling autonomous payment...")
-                    if order_id: body['orderId'] = order_id
+                    if order_id and not body.get('orderId'): body['orderId'] = order_id
                     kwargs = self._handle_x402_v2(url, body, **kwargs)
                     continue
 
@@ -202,29 +209,67 @@ class PayNodeAgentClient:
             
             payload_data = {"txHash": tx_hash}
 
-        # Unified Payload for v3.1
+        # Official X402 V2 Payload with PayNode extensions
         payment_payload = {
-            "version": "3.1",
-            "type": ptype,
-            "orderId": order_id,
-            "payload": payload_data
+            "x402Version": 2,
+            "resource": requirements.get('resource'),
+            "accepted": {
+                "scheme": requirement.get('scheme'),
+                "network": requirement.get('network'),
+                "amount": requirement.get('amount'),
+                "asset": requirement.get('asset'),
+                "payTo": requirement.get('payTo'),
+                "maxTimeoutSeconds": requirement.get('maxTimeoutSeconds'),
+                "extra": requirement.get('extra', {})
+            },
+            "payload": payload_data,
+            "_paynode": {
+                "version": "2.2.1",
+                "type": ptype,
+                "orderId": order_id
+            }
         }
+        
+        # Add router for onchain
+        if ptype == 'onchain':
+            payment_payload["accepted"]["router"] = requirement.get('router')
 
         logger.info(f"✅ [PayNode-PY] {ptype} payment prepared. Retrying request...")
         
-        import json
-        import base64
         b64_payload = base64.b64encode(json.dumps(payment_payload).encode()).decode()
 
         retry_headers = kwargs.get('headers', {}).copy()
         retry_headers.update({
             'Content-Type': 'application/json',
-            'X-402-Payload': b64_payload,
+            'PAYMENT-SIGNATURE': b64_payload,
+            'X-402-Payload': b64_payload, # Backward compatibility
             'X-402-Order-Id': order_id
         })
         kwargs['headers'] = retry_headers
         return kwargs
 
+    def _request_with_settlement_check(self, method: str, url: str, **kwargs) -> requests.Response:
+        """Wrapper to check for PAYMENT-RESPONSE after retry."""
+        response = self.session.request(method, url, **kwargs)
+        
+        settle_header = response.headers.get('PAYMENT-RESPONSE') or response.headers.get('X-PAYMENT-RESPONSE')
+        if settle_header:
+            try:
+                settle_header_str = settle_header.strip()
+                if settle_header_str.startswith('{'):
+                    decoded = settle_header_str
+                else:
+                    decoded = base64.b64decode(settle_header).decode()
+                settle_data = json.loads(decoded)
+                if settle_data.get('success'):
+                    logger.info(f"✅ [PayNode-PY] Settlement confirmed: {settle_data.get('transaction')}")
+                else:
+                    logger.warning(f"⚠️ [PayNode-PY] Settlement failed: {settle_data.get('errorReason', 'Unknown error')}")
+            except Exception as e:
+                logger.warning(f"⚠️ [PayNode-PY] Failed to parse settlement response: {e}")
+        
+        return response
+
     def sign_transfer_with_authorization(self, token_addr, to, amount, valid_after, valid_before, nonce, extra=None):
         extra = extra or {}
         token_addr = Web3.to_checksum_address(token_addr)

{paynode_sdk_python-2.1.0 → paynode_sdk_python-2.2.1}/paynode_sdk/constants.py

@@ -9,8 +9,8 @@ PROTOCOL_TREASURY = "0x598bF63F5449876efafa7b36b77Deb2070621C0E"
 PROTOCOL_FEE_BPS = 100
 MIN_PAYMENT_AMOUNT = 1000
 
-BASE_RPC_URLS = ["https://mainnet.base.org", "https://base.meowrpc.com", "https://1rpc.io/base"]
-BASE_RPC_URLS_SANDBOX = ["https://sepolia.base.org", "https://base-sepolia-rpc.publicnode.com"]
+BASE_RPC_URLS = ['https://mainnet.base.org', 'https://base.meowrpc.com', 'https://1rpc.io/base']
+BASE_RPC_URLS_SANDBOX = ['https://sepolia.base.org', 'https://base-sepolia-rpc.publicnode.com']
 
 ACCEPTED_TOKENS = {
     8453: ["0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"],

{paynode_sdk_python-2.1.0 → paynode_sdk_python-2.2.1}/paynode_sdk/errors.py

@@ -28,7 +28,7 @@ ERROR_MESSAGES = {
     ErrorCode.transaction_not_found: "Transaction not found on-chain.",
     ErrorCode.wrong_contract: "Payment event was not emitted by the official PayNode contract.",
     ErrorCode.order_mismatch: "OrderId in receipt does not match requested ID.",
-    ErrorCode.missing_receipt: "Please pay to PayNode contract and provide 'X-402-Payload' header.",
+    ErrorCode.missing_receipt: "Please pay to PayNode contract and provide 'PAYMENT-SIGNATURE' header.",
 }
 
 class PayNodeException(Exception):

{paynode_sdk_python-2.1.0 → paynode_sdk_python-2.2.1}/paynode_sdk/middleware.py

@@ -59,19 +59,51 @@ class PayNodeMiddleware(BaseHTTPMiddleware):
         self.max_timeout_seconds = kwargs.get('max_timeout_seconds', 3600)
 
     async def dispatch(self, request: Request, call_next):
-        v2_payload_header = request.headers.get('X-402-Payload')
+        v2_payload_header = request.headers.get('PAYMENT-SIGNATURE') or request.headers.get('X-402-Payload')
         order_id = request.headers.get('X-402-Order-Id')
 
         if not order_id:
-            order_id = self.generate_order_id(request)
+            order_id = (self.generate_order_id)(request)
 
         # Handle x402 v2 Unified Payload
         unified_payload = None
         if v2_payload_header:
             try:
-                unified_payload = json.loads(base64.b64decode(v2_payload_header.encode()).decode())
+                parsed = json.loads(base64.b64decode(v2_payload_header.encode()).decode())
+                
+                if parsed.get('x402Version') == 2 and parsed.get('accepted'):
+                    # Official X402 V2 format - convert to internal format
+                    internal_order_id = parsed.get('_paynode', {}).get('orderId') \
+                                     or order_id \
+                                     or f"auto_{int(time.time() * 1000)}"
+                    
+                    # Infer type from payload content if missing
+                    payload_content = parsed.get('payload', {})
+                    inferred_type = 'onchain'
+                    if payload_content.get('signature') or payload_content.get('authorization'):
+                        inferred_type = 'eip3009'
+                    elif payload_content.get('txHash'):
+                        inferred_type = 'onchain'
+                    
+                    p_type = parsed.get('_paynode', {}).get('type') or inferred_type
+                    
+                    unified_payload = {
+                        "version": "2.2.1",
+                        "type": p_type,
+                        "orderId": internal_order_id,
+                        "router": parsed.get('accepted', {}).get('router'),
+                        "payload": parsed.get('payload')
+                    }
+                    order_id = internal_order_id
+                elif isinstance(parsed.get('version'), str) and parsed.get('version').startswith(("2.3", "2.2")):
+                    # Legacy PayNode format
+                    unified_payload = parsed
+                    if 'orderId' in unified_payload:
+                        order_id = unified_payload['orderId']
+                    elif 'order_id' in unified_payload:
+                        order_id = unified_payload['order_id']
             except Exception as e:
-                logger.error(f"❌ [PayNode-Middleware] Failed to decode X-402-Payload header: {e}")
+                logger.error(f"❌ [PayNode-Middleware] Failed to decode payment payload header: {e}")
 
         if unified_payload:
             try:
@@ -91,14 +123,43 @@ class PayNodeMiddleware(BaseHTTPMiddleware):
                 )
                 if result.get("isValid"):
                     request.state.paynode = {"unified_payload": unified_payload, "orderId": order_id}
-                    return await call_next(request)
+                    
+                    # Construct settlement response header
+                    settle_response = {
+                        "success": True,
+                        "transaction": unified_payload.get("payload", {}).get("txHash") or "",
+                        "network": f"eip155:{self.chain_id}",
+                        "payer": result.get("payer", "")
+                    }
+                    b64_settle = base64.b64encode(json.dumps(settle_response).encode()).decode()
+                    
+                    response = await call_next(request)
+                    response.headers["PAYMENT-RESPONSE"] = b64_settle
+                    response.headers["X-PAYMENT-RESPONSE"] = b64_settle # Compatibility
+                    return response
                 else:
                     err = result.get("error")
+                    error_code = err.code if hasattr(err, 'code') else ErrorCode.invalid_receipt
+                    
+                    # Also include PAYMENT-RESPONSE header on failure for protocol symmetry
+                    settle_fail = {
+                        "success": False,
+                        "errorReason": error_code,
+                        "transaction": "",
+                        "network": f"eip155:{self.chain_id}"
+                    }
+                    b64_settle_fail = base64.b64encode(json.dumps(settle_fail).encode()).decode()
+                    
+                    headers = {
+                        "PAYMENT-RESPONSE": b64_settle_fail,
+                        "X-PAYMENT-RESPONSE": b64_settle_fail
+                    }
                     return JSONResponse(
                         status_code=403,
+                        headers=headers,
                         content={
                             "error": "Forbidden",
-                            "code": err.code if hasattr(err, 'code') else ErrorCode.invalid_receipt,
+                            "code": error_code,
                             "message": str(err)
                         }
                     )
@@ -144,6 +205,7 @@ class PayNodeMiddleware(BaseHTTPMiddleware):
         b64_required = base64.b64encode(json.dumps(v2_response).encode()).decode()
 
         headers = {
+            'PAYMENT-REQUIRED': b64_required,
             'X-402-Required': b64_required,
             'X-402-Order-Id': order_id,
         }

{paynode_sdk_python-2.1.0 → paynode_sdk_python-2.2.1}/paynode_sdk/verifier.py

@@ -136,6 +136,7 @@ class PayNodeVerifier:
         order_id_bytes = self.w3.keccak(text=expected.get("orderId", ""))
 
         valid_log_found = False
+        found_payer = None
         order_id_mismatch_found = False
         for log in processed_logs:
             args = log.args
@@ -147,6 +148,7 @@ class PayNodeVerifier:
             if is_merchant_match and is_token_match and is_amount_match:
                 if is_order_match:
                     valid_log_found = True
+                    found_payer = args.get("payer")
                     break
                 else:
                     order_id_mismatch_found = True
@@ -161,7 +163,7 @@ class PayNodeVerifier:
             if not is_new:
                 return {"isValid": False, "error": PayNodeException(ErrorCode.duplicate_transaction)}
 
-        return {"isValid": True}
+        return {"isValid": True, "payer": found_payer}
 
     async def verify_transfer_with_authorization(
         self,
@@ -305,6 +307,6 @@ class PayNodeVerifier:
                 if self.store: await self.store.delete(nonce)
                 return {"isValid": False, "error": PayNodeException(ErrorCode.duplicate_transaction, message="Nonce already consumed on-chain")}
 
-            return {"isValid": True}
+            return {"isValid": True, "payer": auth["from"]}
         except Exception as e:
             return {"isValid": False, "error": PayNodeException(ErrorCode.internal_error, message=str(e))}

{paynode_sdk_python-2.1.0 → paynode_sdk_python-2.2.1/paynode_sdk_python.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: paynode-sdk-python
-Version: 2.1.0
+Version: 2.2.1
 Summary: PayNode Protocol Python SDK for AI Agents
 Author-email: PayNodeLabs <contact@paynode.dev>
 License: MIT
@@ -16,6 +16,8 @@ Provides-Extra: test
 Requires-Dist: pytest>=7.0.0; extra == "test"
 Requires-Dist: responses>=0.23.0; extra == "test"
 Requires-Dist: pytest-mock>=3.10.0; extra == "test"
+Provides-Extra: webhook
+Requires-Dist: aiohttp>=3.9.0; extra == "webhook"
 Dynamic: license-file
 
 # PayNode Python SDK
@@ -23,7 +25,7 @@ Dynamic: license-file
 [![Official Documentation](https://img.shields.io/badge/Docs-docs.paynode.dev-00ff88?style=for-the-badge&logo=readthedocs)](https://docs.paynode.dev)
 [![PyPI Version](https://img.shields.io/pypi/v/paynode-sdk-python.svg?style=for-the-badge)](https://pypi.org/project/paynode-sdk-python/)
 
-The official Python SDK for the **PayNode Protocol (v3.1)**. PayNode allows autonomous AI Agents to seamlessly pay for APIs and computational resources using USDC on Base L2, utilizing the standardized HTTP 402 protocol with support for both on-chain receipts and off-chain signatures (EIP-3009).
+The official Python SDK for the **PayNode Protocol (v2.2.1)**. PayNode allows autonomous AI Agents to seamlessly pay for APIs and computational resources using USDC on Base L2, utilizing the standardized HTTP 402 protocol with support for both on-chain receipts and off-chain signatures (EIP-3009).
 
 ## 📖 Read the Docs
 
@@ -54,7 +56,7 @@ response = agent.request_gate("https://api.merchant.com/premium-data", method="P
 print(response.json())
 ```
 
-### Key Features (v2.1)
+### Key Features (v2.2.1)
 - **EIP-3009 Support**: Sign payments off-chain using `TransferWithAuthorization`, allowing for gasless or relayer-mediated settlement.
 - **X402 V2 Protocol**: JSON-based handshake for more structured and machine-readable payment instructions.
 - **Dual Flow**: Automatic fallback to V1 (on-chain receipts) for legacy merchant support.

{paynode_sdk_python-2.1.0 → paynode_sdk_python-2.2.1}/paynode_sdk_python.egg-info/requires.txt

@@ -7,3 +7,6 @@ fastapi>=0.111.0
 pytest>=7.0.0
 responses>=0.23.0
 pytest-mock>=3.10.0
+
+[webhook]
+aiohttp>=3.9.0

{paynode_sdk_python-2.1.0 → paynode_sdk_python-2.2.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "paynode-sdk-python"
-version = "2.1.0"
+version = "2.2.1"
 description = "PayNode Protocol Python SDK for AI Agents"
 readme = "README.md"
 authors = [{ name = "PayNodeLabs", email = "contact@paynode.dev" }]
@@ -23,6 +23,9 @@ test = [
     "responses>=0.23.0",
     "pytest-mock>=3.10.0"
 ]
+webhook = [
+    "aiohttp>=3.9.0"
+]
 
 [project.urls]
 Homepage = "https://github.com/PayNodeLabs/paynode-sdk-python"

{paynode_sdk_python-2.1.0 → paynode_sdk_python-2.2.1}/tests/test_client.py

@@ -8,9 +8,9 @@ from paynode_sdk import PayNodeAgentClient, PayNodeException, ErrorCode
 # Standard Base Sepolia Mock Values
 MOCK_PRIVATE_KEY = "0x" + "1" * 64
 MOCK_RPC = "https://sepolia.base.org"
-MOCK_MERCHANT = "0xMerchantWalletAddress789"
+MOCK_MERCHANT = "0x" + "7" * 40
 MOCK_TOKEN = "0x65c088EfBDB0E03185Dbe8e258Ad0cf4Ab7946b0"
-MOCK_ROUTER = "0xPayNodeRouterAddress123"
+MOCK_ROUTER = "0x" + "9" * 40
 MOCK_ORDER_ID = "order_12345"
 MOCK_TX_HASH = "0x6f3e1a0000000000000000000000000000000000000000000000000000000000"
 
@@ -71,11 +71,12 @@ def test_402_v2_onchain_handshake(client):
         assert response.status_code == 200
         assert response.json()["data"] == "Premium Secret Content"
         
-        # Verify X-402-Payload was sent
+        # Verify PAYMENT-SIGNATURE was sent
         retry_request = responses.calls[1].request
-        assert 'X-402-Payload' in retry_request.headers
-        payload = json.loads(base64.b64decode(retry_request.headers['X-402-Payload']).decode())
-        assert payload['type'] == 'onchain'
+        assert 'PAYMENT-SIGNATURE' in retry_request.headers
+        payload = json.loads(base64.b64decode(retry_request.headers['PAYMENT-SIGNATURE']).decode())
+        assert payload['x402Version'] == 2
+        assert payload['_paynode']['type'] == 'onchain'
         assert payload['payload']['txHash'] == MOCK_TX_HASH
 
 def test_dust_limit_protection(client):
@@ -133,7 +134,8 @@ def test_insufficient_funds_on_chain(client):
     })
 
     with patch.object(client, '_get_allowance', return_value=1000000), \
-         patch.object(client, 'pay', side_effect=PayNodeException(ErrorCode.transaction_failed)):
+         patch.object(client, 'pay', side_effect=PayNodeException(ErrorCode.transaction_failed)), \
+         patch.object(client, 'pay_with_permit', side_effect=PayNodeException(ErrorCode.transaction_failed)):
         
         with pytest.raises(PayNodeException) as exc:
             client.get(target_url)
@@ -182,9 +184,48 @@ def test_402_v2_eip3009_handshake(client):
         assert response.status_code == 200
         assert mock_sign.called
         
-        # Verify X-402-Payload
+        # Verify PAYMENT-SIGNATURE
         retry_request = responses.calls[1].request
-        assert 'X-402-Payload' in retry_request.headers
-        payload = json.loads(base64.b64decode(retry_request.headers['X-402-Payload']).decode())
-        assert payload['type'] == 'eip3009'
+        assert 'PAYMENT-SIGNATURE' in retry_request.headers
+        payload = json.loads(base64.b64decode(retry_request.headers['PAYMENT-SIGNATURE']).decode())
+        assert payload['x402Version'] == 2
+        assert payload['_paynode']['type'] == 'eip3009'
         assert payload['payload']['signature'] == '0xsig'
+
+@responses.activate
+def test_settlement_confirmation_logging(client):
+    """
+    Ensures the client correctly reads and logs the PAYMENT-RESPONSE header.
+    """
+    target_url = "http://api.agent/settle"
+    
+    # 1. Mock the 402 response
+    v2_req = {
+        "x402Version": 2,
+        "accepts": [{"type": "onchain", "network": "eip155:84532", "amount": "1000", "asset": MOCK_TOKEN, "payTo": MOCK_MERCHANT, "router": MOCK_ROUTER}]
+    }
+    b64_req = base64.b64encode(json.dumps(v2_req).encode()).decode()
+    responses.add(responses.GET, target_url, status=402, headers={'X-402-Required': b64_req})
+    
+    # 2. Mock settlement header in success response
+    settle_data = {"success": True, "transaction": MOCK_TX_HASH}
+    b64_settle = base64.b64encode(json.dumps(settle_data).encode()).decode()
+    
+    responses.add(
+        responses.GET, target_url,
+        status=200,
+        headers={'PAYMENT-RESPONSE': b64_settle},
+        json={"data": "OK"}
+    )
+    
+    with patch.object(client, 'pay', return_value=MOCK_TX_HASH), \
+         patch.object(client, '_get_allowance', return_value=1000000), \
+         patch('paynode_sdk.client.logger') as mock_logger:
+        
+        response = client.get(target_url)
+        assert response.status_code == 200
+        
+        # Verify logger was called with confirmation
+        # Since logger.info is called directly from the module logger, we need to handle that.
+        # But here we patched it specifically.
+        mock_logger.info.assert_any_call(f"✅ [PayNode-PY] Settlement confirmed: {MOCK_TX_HASH}")