afconwave 0.1.0__py3-none-any.whl

afconwave/__init__.py

@@ -0,0 +1,159 @@
+import requests
+import hmac
+import hashlib
+import json
+import time
+
+# ─── Exceptions ────────────────────────────────────────────────────────────────
+
+class AfconWaveError(Exception):
+    def __init__(self, message, status_code=None, code=None):
+        self.message = message
+        self.status_code = status_code
+        self.code = code
+        super().__init__(self.message)
+
+# ─── Resources ────────────────────────────────────────────────────────────────
+
+class Resource:
+    def __init__(self, client):
+        self.client = client
+
+class Payments(Resource):
+    def create(self, **kwargs):
+        return self.client.request('POST', '/payments', data=kwargs)
+        
+    def retrieve(self, payment_id):
+        return self.client.request('GET', f'/payments/{payment_id}')
+    
+    def list(self, **kwargs):
+        return self.client.request('GET', '/payments', params=kwargs)
+
+class Payouts(Resource):
+    def create(self, **kwargs):
+        return self.client.request('POST', '/payouts', data=kwargs)
+        
+    def retrieve(self, payout_id):
+        return self.client.request('GET', f'/payouts/{payout_id}')
+
+class Crypto(Resource):
+    def buy(self, **kwargs):
+        return self.client.request('POST', '/crypto/buy', data=kwargs)
+
+class Refunds(Resource):
+    def create(self, payment_id: str, amount: float, reason: str = None):
+        return self.client.request('POST', '/refunds', data={
+            'paymentId': payment_id,
+            'amount': amount,
+            'reason': reason
+        })
+
+    def list(self):
+        return self.client.request('GET', '/refunds')
+
+class Disputes(Resource):
+    def open(self, transaction_id: str, reason: str, description: str):
+        return self.client.request('POST', '/disputes', data={
+            'transactionId': transaction_id,
+            'reason': reason,
+            'description': description
+        })
+
+    def list(self):
+        return self.client.request('GET', '/disputes')
+
+    def resolve(self, dispute_id: str, resolution: str, resolution_details: str = None):
+        return self.client.request('POST', f'/disputes/{dispute_id}/resolve', data={
+            'resolution': resolution,
+            'resolutionDetails': resolution_details
+        })
+
+# ─── Main Client ───────────────────────────────────────────────────────────────
+
+class AfconWave:
+    def __init__(self, secret_key: str, base_url: str = 'https://api.afconwave.com/api/v1', timeout: int = 30):
+        self.secret_key = secret_key
+        self.base_url = base_url
+        self.timeout = timeout
+        
+        self.payments = Payments(self)
+        self.payouts = Payouts(self)
+        self.crypto = Crypto(self)
+        self.refunds = Refunds(self)
+        self.disputes = Disputes(self)
+
+    @staticmethod
+    def verify_webhook_signature(payload: str, signature: str, secret: str, tolerance: int = 300) -> bool:
+        """
+        Verifies that an incoming webhook was sent by AfconWave and checks for replay attacks.
+        
+        :param payload: The raw request body string.
+        :param signature: The X-Afcon-Signature header.
+        :param secret: Your webhook secret.
+        :param tolerance: Maximum allowed age in seconds (default 300).
+        """
+        # 1. Verify Signature
+        expected = hmac.new(
+            secret.encode(),
+            payload.encode(),
+            hashlib.sha256
+        ).hexdigest()
+        
+        if not hmac.compare_digest(expected, signature):
+            return False
+
+        # 2. Verify Timestamp (Replay Protection)
+        try:
+            data = json.loads(payload)
+            if 'timestamp' in data:
+                current_time = time.time() # seconds
+                webhook_time = data['timestamp'] / 1000.0 # convert ms to seconds
+                age = abs(current_time - webhook_time)
+
+                if age > tolerance:
+                    return False
+        except:
+            pass
+
+        return True
+
+    def request(self, method: str, path: str, data: dict = None, params: dict = None):
+        headers = {
+            'Authorization': f'Bearer {self.secret_key}',
+            'Content-Type': 'application/json',
+            'Accept': 'application/json'
+        }
+        url = f"{self.base_url}{path}"
+        
+        try:
+            response = requests.request(
+                method, url, headers=headers, json=data, params=params, timeout=self.timeout
+            )
+            
+            res_data = response.json()
+            
+            if not response.ok:
+                raise AfconWaveError(
+                    message=res_data.get('error', response.reason),
+                    status_code=response.status_code,
+                    code=res_data.get('code')
+                )
+                
+            return res_data.get('data', res_data)
+            
+        except requests.exceptions.RequestException as e:
+            raise AfconWaveError(message=str(e))
+
+    # ─── Top-level Convenience Methods (Matches README) ─────────────────────
+
+    def create_payment(self, **kwargs):
+        return self.payments.create(**kwargs)
+
+    def retrieve_payment(self, payment_id: str):
+        return self.payments.retrieve(payment_id)
+
+    def list_payments(self, **kwargs):
+        return self.payments.list(**kwargs)
+
+    def create_payout(self, **kwargs):
+        return self.payouts.create(**kwargs)

afconwave-0.1.0.dist-info/METADATA

@@ -0,0 +1,15 @@
+Metadata-Version: 2.4
+Name: afconwave
+Version: 0.1.0
+Summary: Official AfconWave Python SDK
+Author: AfconWave Team
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+License-File: LICENSE
+Requires-Dist: requests>=2.25.0
+Dynamic: author
+Dynamic: classifier
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: summary

afconwave-0.1.0.dist-info/RECORD

@@ -0,0 +1,6 @@
+afconwave/__init__.py,sha256=CtJRXCdBkiA-spfRqiXjviA37vRJ3HzTwKd_uiCwXJo,5798
+afconwave-0.1.0.dist-info/licenses/LICENSE,sha256=hln7B5etngKFHn0S0_YJtSfxPljtsihUfN5pl3Umft8,1066
+afconwave-0.1.0.dist-info/METADATA,sha256=qhPksOsrPpKbRHNXRyQgngDNyrXmWtw2rCVvreC8SG4,413
+afconwave-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+afconwave-0.1.0.dist-info/top_level.txt,sha256=VnOg6xsD2cmJEyqgBGEcmNk5xSFgWaFPptWeyyttziM,10
+afconwave-0.1.0.dist-info/RECORD,,

afconwave-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

afconwave-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AfconWave
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

afconwave-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+afconwave