mmpay-python-sdk 0.1.2__tar.gz → 0.1.3__tar.gz

{mmpay_python_sdk-0.1.2 → mmpay_python_sdk-0.1.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mmpay-python-sdk
-Version: 0.1.2
+Version: 0.1.3
 Summary: Python SDK for MyanMyanPay
 Home-page: https://github.com/nawing/MMPay-Python-SDK
 Author: Naw Ing
@@ -90,13 +90,12 @@ Used inside the `items` list of a Payment Request.
 | `amount` | `float` | Yes | Price per unit. |
 | `quantity` | `int` | Yes | Quantity of the item. |
 
-### 2. Create a Payment (Sandbox)
-
+### 2. Create a Payment
 
 ```python
 try:
     payment_request = {
-        "orderId": "ORD-SANDBOX-001",
+        "orderId": "ORD-LIVE-98765",
         "amount": 5000,
         "callbackUrl": "https://your-site.com/webhook/mmpay",
         "customMessage": "Your Custom Message",
@@ -109,8 +108,8 @@ try:
         ]
     }
 
-    response = sdk.sandbox_pay(payment_request)
-    print(response)
+    response = sdk.pay(payment_request)
+    print(response.get('url'))
 
 except Exception as e:
     print(e)
@@ -119,57 +118,96 @@ except Exception as e:
 ### 3. Retrieve a Payment 
 
 ```python
-#(Sandbox)
 try:
     get_request = {
         "orderId": "ORD-SANDBOX-001"
     }
 
-    response = sdk.sandbox_get(get_request)
+    response = sdk.get(get_request)
     print(response)
-
-except Exception as e:
-    print(e)
 ```
 
+### 4. Handling Webhooks
 
-```python
-#(Production)
-try:
-    get_request = {
-        "orderId": "ORD-SANDBOX-001"
-    }
+When MyanMyanPay sends a callback to your `callbackUrl`[cite: 1], you must verify the request signature to ensure it is genuine. 
+When you implement this method, our package automatically process the Hmac verification  
 
-    response = sdk.get(get_request)
-    print(response)
-```
+**Incoming Headers**
 
-### 4. Create a Payment (Production)
+| Field Name | Type | Required | Description |
+| :--- | :--- | :--- | :--- |
+| `Content-Type` | `str` | Yes | `application/json` |
+| `X-Mmpay-Signature` | `str` | Yes | Generated HMAC signature |
+| `X-Mmpay-Nonce` | `str` | Yes | Unique nonce string |
 
 ```python
-try:
-    payment_request = {
-        "orderId": "ORD-LIVE-98765",
-        "amount": 5000,
-        "callbackUrl": "https://your-site.com/webhook/mmpay",
-        "customMessage": "Your Custom Message",
-        "items": [
-            {
-                "name": "Premium Subscription",
-                "amount": 5000,
-                "quantity": 1
-            }
-        ]
-    }
 
-    response = sdk.pay(payment_request)
-    print(response.get('url'))
+from mmpay.client import MMPaySDK
+
+sdk = MMPaySDK({
+    'appId': 'your_app_id',
+    'publishableKey': 'pk_test_12345',
+    'secretKey': 'your_secret_key',
+    'apiBaseUrl': 'https://api.myanmyanpay.com'
+})
+
+def handle_create(tx):
+    print("Created:", tx.get('orderId'))
+
+def handle_success(tx):
+    print("Success:", tx.get('orderId'))
+
+def handle_fail(tx):
+    print("Failed:", tx.get('orderId'))
+
+def handle_refund(tx):
+    print("Refunded:", tx.get('orderId'))
+
+def handle_cancel(tx):
+    print("Cancelled:", tx.get('orderId'))
+
+def handle_expire(tx):
+    print("Expired:", tx.get('orderId'))
+
+def handle_heartbeat(tx):
+    print("Heartbeat:", tx.get('orderId'))
+
+def handle_unknown(tx):
+    print("Unknown:", tx.get('status'))
+
+def handle_error(error):
+    print("Error:", error)
+
+sdk.on_tx_create(handle_create)
+sdk.on_tx_success(handle_success)
+sdk.on_tx_fail(handle_fail)
+sdk.on_tx_refund(handle_refund)
+sdk.on_tx_cancel(handle_cancel)
+sdk.on_tx_expire(handle_expire)
+sdk.on_heartbeat(handle_heartbeat)
+sdk.on('tx:unknown', handle_unknown)
+sdk.on('error', handle_error)
+
+
+@app.route('/webhooks/mmpay', methods=['POST'])
+def mmpay_webhook():
+    payload_str = request.data.decode('utf-8')
+    nonce = request.headers.get('X-Mmpay-Nonce')
+    signature = request.headers.get('X-Mmpay-Signature')
+
+    if not nonce or not signature:
+        return jsonify({"error": "Missing headers"}), 400
+
+    sdk.listen(payload_str, nonce, signature)
+    
+    return jsonify({"received": True}), 200
+
+if __name__ == '__main__':
+    app.run(port=5000)
 
-except Exception as e:
-    print(e)
 ```
 
-### 5. Verify Callback (Webhook)
+### 5. Verify Callback (Manually)
 
 When MyanMyanPay sends a callback to your `callbackUrl`[cite: 1], you must verify the request signature to ensure it is genuine. 
 
@@ -187,7 +225,7 @@ When MyanMyanPay sends a callback to your `callbackUrl`[cite: 1], you must verif
 ```python
 from flask import request
 
-@app.route('/webhook/mmpay', methods=['POST'])
+@app.route('/webhooks/mmpay', methods=['POST'])
 def mmpay_webhook():
     payload_str = request.data.decode('utf-8')
     nonce = request.headers.get('X-Mmpay-Nonce')

{mmpay_python_sdk-0.1.2 → mmpay_python_sdk-0.1.3}/README.md

@@ -65,13 +65,12 @@ Used inside the `items` list of a Payment Request.
 | `amount` | `float` | Yes | Price per unit. |
 | `quantity` | `int` | Yes | Quantity of the item. |
 
-### 2. Create a Payment (Sandbox)
-
+### 2. Create a Payment
 
 ```python
 try:
     payment_request = {
-        "orderId": "ORD-SANDBOX-001",
+        "orderId": "ORD-LIVE-98765",
         "amount": 5000,
         "callbackUrl": "https://your-site.com/webhook/mmpay",
         "customMessage": "Your Custom Message",
@@ -84,8 +83,8 @@ try:
         ]
     }
 
-    response = sdk.sandbox_pay(payment_request)
-    print(response)
+    response = sdk.pay(payment_request)
+    print(response.get('url'))
 
 except Exception as e:
     print(e)
@@ -94,57 +93,96 @@ except Exception as e:
 ### 3. Retrieve a Payment 
 
 ```python
-#(Sandbox)
 try:
     get_request = {
         "orderId": "ORD-SANDBOX-001"
     }
 
-    response = sdk.sandbox_get(get_request)
+    response = sdk.get(get_request)
     print(response)
-
-except Exception as e:
-    print(e)
 ```
 
+### 4. Handling Webhooks
 
-```python
-#(Production)
-try:
-    get_request = {
-        "orderId": "ORD-SANDBOX-001"
-    }
+When MyanMyanPay sends a callback to your `callbackUrl`[cite: 1], you must verify the request signature to ensure it is genuine. 
+When you implement this method, our package automatically process the Hmac verification  
 
-    response = sdk.get(get_request)
-    print(response)
-```
+**Incoming Headers**
 
-### 4. Create a Payment (Production)
+| Field Name | Type | Required | Description |
+| :--- | :--- | :--- | :--- |
+| `Content-Type` | `str` | Yes | `application/json` |
+| `X-Mmpay-Signature` | `str` | Yes | Generated HMAC signature |
+| `X-Mmpay-Nonce` | `str` | Yes | Unique nonce string |
 
 ```python
-try:
-    payment_request = {
-        "orderId": "ORD-LIVE-98765",
-        "amount": 5000,
-        "callbackUrl": "https://your-site.com/webhook/mmpay",
-        "customMessage": "Your Custom Message",
-        "items": [
-            {
-                "name": "Premium Subscription",
-                "amount": 5000,
-                "quantity": 1
-            }
-        ]
-    }
 
-    response = sdk.pay(payment_request)
-    print(response.get('url'))
+from mmpay.client import MMPaySDK
+
+sdk = MMPaySDK({
+    'appId': 'your_app_id',
+    'publishableKey': 'pk_test_12345',
+    'secretKey': 'your_secret_key',
+    'apiBaseUrl': 'https://api.myanmyanpay.com'
+})
+
+def handle_create(tx):
+    print("Created:", tx.get('orderId'))
+
+def handle_success(tx):
+    print("Success:", tx.get('orderId'))
+
+def handle_fail(tx):
+    print("Failed:", tx.get('orderId'))
+
+def handle_refund(tx):
+    print("Refunded:", tx.get('orderId'))
+
+def handle_cancel(tx):
+    print("Cancelled:", tx.get('orderId'))
+
+def handle_expire(tx):
+    print("Expired:", tx.get('orderId'))
+
+def handle_heartbeat(tx):
+    print("Heartbeat:", tx.get('orderId'))
+
+def handle_unknown(tx):
+    print("Unknown:", tx.get('status'))
+
+def handle_error(error):
+    print("Error:", error)
+
+sdk.on_tx_create(handle_create)
+sdk.on_tx_success(handle_success)
+sdk.on_tx_fail(handle_fail)
+sdk.on_tx_refund(handle_refund)
+sdk.on_tx_cancel(handle_cancel)
+sdk.on_tx_expire(handle_expire)
+sdk.on_heartbeat(handle_heartbeat)
+sdk.on('tx:unknown', handle_unknown)
+sdk.on('error', handle_error)
+
+
+@app.route('/webhooks/mmpay', methods=['POST'])
+def mmpay_webhook():
+    payload_str = request.data.decode('utf-8')
+    nonce = request.headers.get('X-Mmpay-Nonce')
+    signature = request.headers.get('X-Mmpay-Signature')
+
+    if not nonce or not signature:
+        return jsonify({"error": "Missing headers"}), 400
+
+    sdk.listen(payload_str, nonce, signature)
+    
+    return jsonify({"received": True}), 200
+
+if __name__ == '__main__':
+    app.run(port=5000)
 
-except Exception as e:
-    print(e)
 ```
 
-### 5. Verify Callback (Webhook)
+### 5. Verify Callback (Manually)
 
 When MyanMyanPay sends a callback to your `callbackUrl`[cite: 1], you must verify the request signature to ensure it is genuine. 
 
@@ -162,7 +200,7 @@ When MyanMyanPay sends a callback to your `callbackUrl`[cite: 1], you must verif
 ```python
 from flask import request
 
-@app.route('/webhook/mmpay', methods=['POST'])
+@app.route('/webhooks/mmpay', methods=['POST'])
 def mmpay_webhook():
     payload_str = request.data.decode('utf-8')
     nonce = request.headers.get('X-Mmpay-Nonce')

{mmpay_python_sdk-0.1.2 → mmpay_python_sdk-0.1.3}/mmpay/client.py

@@ -3,7 +3,7 @@ import json
 import hmac
 import hashlib
 import requests
-from typing import List, Optional, TypedDict, Dict, Any, Union
+from typing import List, Optional, TypedDict, Dict, Any, Union, Callable
 
 class Item(TypedDict):
     name: str
@@ -83,7 +83,19 @@ class MMPaySDK:
         self._publishable_key = options['publishableKey']
         self._secret_key = options['secretKey']
         self._api_base_url = options['apiBaseUrl'].rstrip('/')
+        self._is_sandbox = self._publishable_key.startswith('pk_test')
         self._btoken: Optional[str] = None
+        self._listeners: Dict[str, List[Callable]] = {
+            'tx:create': [],
+            'tx:success': [],
+            'tx:failed': [],
+            'tx:refunded': [],
+            'tx:cancel': [],
+            'tx:expire': [],
+            'tx:heartbeat': [],
+            'tx:unknown': [],
+            'error': []
+        }
 
     def _generate_signature(self, body_string: str, nonce: str) -> str:
         string_to_sign = f"{nonce}.{body_string}"
@@ -99,125 +111,28 @@ class MMPaySDK:
     def _json_stringify(self, data: Any) -> str:
         return json.dumps(data, separators=(',', ':'))
 
-    def sandbox_handshake(self, payload: HandShakeRequest) -> Union[HandShakeResponse, Dict[str, Any]]:
-        endpoint = f"{self._api_base_url}/payments/sandbox-handshake"
-        nonce = self._get_nonce()
-        
-        body_string = self._json_stringify(payload)
-        signature = self._generate_signature(body_string, nonce)
-
-        headers = {
-            'Authorization': f"Bearer {self._publishable_key}",
-            'X-Mmpay-Nonce': nonce,
-            'X-Mmpay-Signature': signature,
-            'Content-Type': 'application/json',
-        }
-
-        try:
-            response = requests.post(endpoint, data=body_string, headers=headers)
-            response.raise_for_status()
-            data = response.json()
-            if 'token' in data:
-                self._btoken = data['token']
-            return data
-        except requests.exceptions.RequestException as e:
-            return {"error": str(e), "details": getattr(e.response, 'text', '')}
-
-    def sandbox_pay(self, params: PaymentRequest) -> Dict[str, Any]:
-        endpoint = f"{self._api_base_url}/payments/sandbox-create"
-        nonce = self._get_nonce()
-
-        xpayload: Dict[str, Any] = {
-            "appId": self._app_id,
-            "nonce": nonce,
-            "amount": params['amount'],
-            "orderId": params['orderId'],
-        }
-
-        if 'items' in params:
-            xpayload['items'] = params['items']
-        if 'callbackUrl' in params:
-            xpayload['callbackUrl'] = params['callbackUrl']
-        if 'customMessage' in params:
-            xpayload['customMessage'] = params['customMessage']
-
-        body_string = self._json_stringify(xpayload)
-        signature = self._generate_signature(body_string, nonce)
-
-        handshake_payload: HandShakeRequest = {
-            'orderId': str(xpayload['orderId']), 
-            'nonce': str(xpayload['nonce'])
-        }
-        
-        handshake_res = self.sandbox_handshake(handshake_payload)
-        if 'error' in handshake_res:
-            return handshake_res
-
-        headers = {
-            'Authorization': f"Bearer {self._publishable_key}",
-            'X-Mmpay-Btoken': self._btoken or '',
-            'X-Mmpay-Nonce': nonce,
-            'X-Mmpay-Signature': signature,
-            'Content-Type': 'application/json',
-        }
-
-        try:
-            response = requests.post(endpoint, data=body_string, headers=headers)
-            response.raise_for_status()
-            return response.json()
-        except requests.exceptions.RequestException as e:
-            return {"error": str(e), "details": getattr(e.response, 'text', '')}
-
-    def sandbox_get(self, params: PayGetRequest) -> Union[PayGetResponse, Dict[str, Any]]:
-        endpoint = f"{self._api_base_url}/payments/sandbox-get"
-        nonce = self._get_nonce()
-
-        xpayload: Dict[str, Any] = {
-            "orderId": params['orderId'],
-            "nonce": nonce
-        }
-
-        body_string = self._json_stringify(xpayload)
-        signature = self._generate_signature(body_string, nonce)
-
-        handshake_payload: HandShakeRequest = {
-            'orderId': str(xpayload['orderId']),
-            'nonce': str(xpayload['nonce'])
-        }
-
-        handshake_res = self.sandbox_handshake(handshake_payload)
-        if 'error' in handshake_res:
-            return handshake_res
-
-        headers = {
-            'Authorization': f"Bearer {self._publishable_key}",
-            'X-Mmpay-Btoken': self._btoken or '',
-            'X-Mmpay-Nonce': nonce,
-            'X-Mmpay-Signature': signature,
-            'Content-Type': 'application/json',
-        }
+    def on(self, event: str, callback: Callable) -> 'MMPaySDK':
+        if event in self._listeners:
+            self._listeners[event].append(callback)
+        return self
 
-        try:
-            response = requests.post(endpoint, data=body_string, headers=headers)
-            response.raise_for_status()
-            return response.json()
-        except requests.exceptions.RequestException as e:
-            return {"error": str(e), "details": getattr(e.response, 'text', '')}
+    def emit(self, event: str, *args, **kwargs) -> None:
+        if event in self._listeners:
+            for cb in self._listeners[event]:
+                cb(*args, **kwargs)
 
     def handshake(self, payload: HandShakeRequest) -> Union[HandShakeResponse, Dict[str, Any]]:
-        endpoint = f"{self._api_base_url}/payments/handshake"
+        path = "/payments/sandbox-handshake" if self._is_sandbox else "/payments/handshake"
+        endpoint = f"{self._api_base_url}{path}"
         nonce = self._get_nonce()
-        
         body_string = self._json_stringify(payload)
         signature = self._generate_signature(body_string, nonce)
-
         headers = {
             'Authorization': f"Bearer {self._publishable_key}",
             'X-Mmpay-Nonce': nonce,
             'X-Mmpay-Signature': signature,
             'Content-Type': 'application/json',
         }
-
         try:
             response = requests.post(endpoint, data=body_string, headers=headers)
             response.raise_for_status()
@@ -229,35 +144,30 @@ class MMPaySDK:
             return {"error": str(e), "details": getattr(e.response, 'text', '')}
 
     def pay(self, params: PaymentRequest) -> Dict[str, Any]:
-        endpoint = f"{self._api_base_url}/payments/create"
+        path = "/payments/sandbox-create" if self._is_sandbox else "/payments/create"
+        endpoint = f"{self._api_base_url}{path}"
         nonce = self._get_nonce()
-
         xpayload: Dict[str, Any] = {
             "appId": self._app_id,
             "nonce": nonce,
             "amount": params['amount'],
             "orderId": params['orderId'],
         }
-
         if 'items' in params:
             xpayload['items'] = params['items']
         if 'callbackUrl' in params:
             xpayload['callbackUrl'] = params['callbackUrl']
         if 'customMessage' in params:
             xpayload['customMessage'] = params['customMessage']
-
         body_string = self._json_stringify(xpayload)
         signature = self._generate_signature(body_string, nonce)
-
         handshake_payload: HandShakeRequest = {
             'orderId': str(xpayload['orderId']), 
             'nonce': str(xpayload['nonce'])
         }
-        
         handshake_res = self.handshake(handshake_payload)
         if 'error' in handshake_res:
             return handshake_res
-
         headers = {
             'Authorization': f"Bearer {self._publishable_key}",
             'X-Mmpay-Btoken': self._btoken or '',
@@ -265,7 +175,6 @@ class MMPaySDK:
             'X-Mmpay-Signature': signature,
             'Content-Type': 'application/json',
         }
-
         try:
             response = requests.post(endpoint, data=body_string, headers=headers)
             response.raise_for_status()
@@ -274,26 +183,22 @@ class MMPaySDK:
             return {"error": str(e), "details": getattr(e.response, 'text', '')}
 
     def get(self, params: PayGetRequest) -> Union[PayGetResponse, Dict[str, Any]]:
-        endpoint = f"{self._api_base_url}/payments/get"
+        path = "/payments/sandbox-get" if self._is_sandbox else "/payments/get"
+        endpoint = f"{self._api_base_url}{path}"
         nonce = self._get_nonce()
-
         xpayload: Dict[str, Any] = {
             "orderId": params['orderId'],
             "nonce": nonce
         }
-
         body_string = self._json_stringify(xpayload)
         signature = self._generate_signature(body_string, nonce)
-
         handshake_payload: HandShakeRequest = {
             'orderId': str(xpayload['orderId']),
             'nonce': str(xpayload['nonce'])
         }
-
         handshake_res = self.handshake(handshake_payload)
         if 'error' in handshake_res:
             return handshake_res
-
         headers = {
             'Authorization': f"Bearer {self._publishable_key}",
             'X-Mmpay-Btoken': self._btoken or '',
@@ -301,7 +206,6 @@ class MMPaySDK:
             'X-Mmpay-Signature': signature,
             'Content-Type': 'application/json',
         }
-
         try:
             response = requests.post(endpoint, data=body_string, headers=headers)
             response.raise_for_status()
@@ -312,16 +216,62 @@ class MMPaySDK:
     def verify_cb(self, payload: str, nonce: str, expected_signature: str) -> bool:
         if not payload or not nonce or not expected_signature:
             raise ValueError("Callback verification failed: Missing payload, nonce, or signature.")
-
         string_to_sign = f"{nonce}.{payload}"
         generated_signature = hmac.new(
             self._secret_key.encode('utf-8'),
             string_to_sign.encode('utf-8'),
             hashlib.sha256
         ).hexdigest()
-
         if generated_signature != expected_signature:
-            print(f"Signature mismatch: gen={generated_signature}, exp={expected_signature}")
             return False
-        
-        return True
+        return True
+
+    def listen(self, payload: str, nonce: str, expected_signature: str) -> 'MMPaySDK':
+        try:
+            is_valid = self.verify_cb(payload, nonce, expected_signature)
+            if not is_valid:
+                self.emit('error', ValueError('Signature verification failed'))
+                return self
+            tx = json.loads(payload)
+            status = tx.get('status')
+            if status == 'PENDING':
+                self.emit('tx:create', tx)
+            elif status == 'SUCCESS':
+                if tx.get('condition') == 'TOUCHED':
+                    self.emit('tx:heartbeat', tx)
+                else:
+                    self.emit('tx:success', tx)
+            elif status == 'FAILED':
+                self.emit('tx:failed', tx)
+            elif status == 'REFUNDED':
+                self.emit('tx:refunded', tx)
+            elif status == 'CANCELLED':
+                self.emit('tx:cancel', tx)
+            elif status == 'EXPIRED':
+                self.emit('tx:expire', tx)
+            else:
+                self.emit('tx:unknown', tx)
+        except Exception as err:
+            self.emit('error', err)
+        return self
+
+    def on_tx_create(self, cb: Callable) -> 'MMPaySDK':
+        return self.on('tx:create', cb)
+
+    def on_tx_success(self, cb: Callable) -> 'MMPaySDK':
+        return self.on('tx:success', cb)
+
+    def on_tx_fail(self, cb: Callable) -> 'MMPaySDK':
+        return self.on('tx:failed', cb)
+
+    def on_tx_refund(self, cb: Callable) -> 'MMPaySDK':
+        return self.on('tx:refunded', cb)
+
+    def on_tx_cancel(self, cb: Callable) -> 'MMPaySDK':
+        return self.on('tx:cancel', cb)
+
+    def on_tx_expire(self, cb: Callable) -> 'MMPaySDK':
+        return self.on('tx:expire', cb)
+
+    def on_heartbeat(self, cb: Callable) -> 'MMPaySDK':
+        return self.on('tx:heartbeat', cb)

{mmpay_python_sdk-0.1.2 → mmpay_python_sdk-0.1.3}/mmpay_python_sdk.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mmpay-python-sdk
-Version: 0.1.2
+Version: 0.1.3
 Summary: Python SDK for MyanMyanPay
 Home-page: https://github.com/nawing/MMPay-Python-SDK
 Author: Naw Ing
@@ -90,13 +90,12 @@ Used inside the `items` list of a Payment Request.
 | `amount` | `float` | Yes | Price per unit. |
 | `quantity` | `int` | Yes | Quantity of the item. |
 
-### 2. Create a Payment (Sandbox)
-
+### 2. Create a Payment
 
 ```python
 try:
     payment_request = {
-        "orderId": "ORD-SANDBOX-001",
+        "orderId": "ORD-LIVE-98765",
         "amount": 5000,
         "callbackUrl": "https://your-site.com/webhook/mmpay",
         "customMessage": "Your Custom Message",
@@ -109,8 +108,8 @@ try:
         ]
     }
 
-    response = sdk.sandbox_pay(payment_request)
-    print(response)
+    response = sdk.pay(payment_request)
+    print(response.get('url'))
 
 except Exception as e:
     print(e)
@@ -119,57 +118,96 @@ except Exception as e:
 ### 3. Retrieve a Payment 
 
 ```python
-#(Sandbox)
 try:
     get_request = {
         "orderId": "ORD-SANDBOX-001"
     }
 
-    response = sdk.sandbox_get(get_request)
+    response = sdk.get(get_request)
     print(response)
-
-except Exception as e:
-    print(e)
 ```
 
+### 4. Handling Webhooks
 
-```python
-#(Production)
-try:
-    get_request = {
-        "orderId": "ORD-SANDBOX-001"
-    }
+When MyanMyanPay sends a callback to your `callbackUrl`[cite: 1], you must verify the request signature to ensure it is genuine. 
+When you implement this method, our package automatically process the Hmac verification  
 
-    response = sdk.get(get_request)
-    print(response)
-```
+**Incoming Headers**
 
-### 4. Create a Payment (Production)
+| Field Name | Type | Required | Description |
+| :--- | :--- | :--- | :--- |
+| `Content-Type` | `str` | Yes | `application/json` |
+| `X-Mmpay-Signature` | `str` | Yes | Generated HMAC signature |
+| `X-Mmpay-Nonce` | `str` | Yes | Unique nonce string |
 
 ```python
-try:
-    payment_request = {
-        "orderId": "ORD-LIVE-98765",
-        "amount": 5000,
-        "callbackUrl": "https://your-site.com/webhook/mmpay",
-        "customMessage": "Your Custom Message",
-        "items": [
-            {
-                "name": "Premium Subscription",
-                "amount": 5000,
-                "quantity": 1
-            }
-        ]
-    }
 
-    response = sdk.pay(payment_request)
-    print(response.get('url'))
+from mmpay.client import MMPaySDK
+
+sdk = MMPaySDK({
+    'appId': 'your_app_id',
+    'publishableKey': 'pk_test_12345',
+    'secretKey': 'your_secret_key',
+    'apiBaseUrl': 'https://api.myanmyanpay.com'
+})
+
+def handle_create(tx):
+    print("Created:", tx.get('orderId'))
+
+def handle_success(tx):
+    print("Success:", tx.get('orderId'))
+
+def handle_fail(tx):
+    print("Failed:", tx.get('orderId'))
+
+def handle_refund(tx):
+    print("Refunded:", tx.get('orderId'))
+
+def handle_cancel(tx):
+    print("Cancelled:", tx.get('orderId'))
+
+def handle_expire(tx):
+    print("Expired:", tx.get('orderId'))
+
+def handle_heartbeat(tx):
+    print("Heartbeat:", tx.get('orderId'))
+
+def handle_unknown(tx):
+    print("Unknown:", tx.get('status'))
+
+def handle_error(error):
+    print("Error:", error)
+
+sdk.on_tx_create(handle_create)
+sdk.on_tx_success(handle_success)
+sdk.on_tx_fail(handle_fail)
+sdk.on_tx_refund(handle_refund)
+sdk.on_tx_cancel(handle_cancel)
+sdk.on_tx_expire(handle_expire)
+sdk.on_heartbeat(handle_heartbeat)
+sdk.on('tx:unknown', handle_unknown)
+sdk.on('error', handle_error)
+
+
+@app.route('/webhooks/mmpay', methods=['POST'])
+def mmpay_webhook():
+    payload_str = request.data.decode('utf-8')
+    nonce = request.headers.get('X-Mmpay-Nonce')
+    signature = request.headers.get('X-Mmpay-Signature')
+
+    if not nonce or not signature:
+        return jsonify({"error": "Missing headers"}), 400
+
+    sdk.listen(payload_str, nonce, signature)
+    
+    return jsonify({"received": True}), 200
+
+if __name__ == '__main__':
+    app.run(port=5000)
 
-except Exception as e:
-    print(e)
 ```
 
-### 5. Verify Callback (Webhook)
+### 5. Verify Callback (Manually)
 
 When MyanMyanPay sends a callback to your `callbackUrl`[cite: 1], you must verify the request signature to ensure it is genuine. 
 
@@ -187,7 +225,7 @@ When MyanMyanPay sends a callback to your `callbackUrl`[cite: 1], you must verif
 ```python
 from flask import request
 
-@app.route('/webhook/mmpay', methods=['POST'])
+@app.route('/webhooks/mmpay', methods=['POST'])
 def mmpay_webhook():
     payload_str = request.data.decode('utf-8')
     nonce = request.headers.get('X-Mmpay-Nonce')

{mmpay_python_sdk-0.1.2 → mmpay_python_sdk-0.1.3}/mmpay_python_sdk.egg-info/SOURCES.txt

@@ -1,4 +1,5 @@
 README.md
+pyproject.toml
 setup.py
 mmpay/__init__.py
 mmpay/client.py

mmpay_python_sdk-0.1.3/pyproject.toml

@@ -0,0 +1,3 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"

{mmpay_python_sdk-0.1.2 → mmpay_python_sdk-0.1.3}/setup.py

@@ -7,7 +7,7 @@ long_description = (here / "README.md").read_text(encoding="utf-8")
 
 setup(
     name="mmpay-python-sdk",
-    version="0.1.2",
+    version="0.1.3",
     description="Python SDK for MyanMyanPay",
     long_description=long_description,
     long_description_content_type="text/markdown",