ninepay-sdk 1.0.0__tar.gz

ninepay_sdk-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 9Pay Labs
+
+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.

ninepay_sdk-1.0.0/MANIFEST.in

@@ -0,0 +1,9 @@
+# Manifest file for Python package distribution
+include README.md
+include README.vi.md
+include LICENSE
+include CHANGELOG.md
+include CONTRIBUTING.md
+include requirements.txt
+recursive-include examples *.py
+recursive-include tests *.py

ninepay_sdk-1.0.0/PKG-INFO

@@ -0,0 +1,170 @@
+Metadata-Version: 2.4
+Name: ninepay-sdk
+Version: 1.0.0
+Summary: Official Python SDK for 9PAY Payment Gateway
+Home-page: https://github.com/9pay-labs/9pay-sdk-python
+Author: 9Pay Labs
+Author-email: support@9pay.vn
+Keywords: payment gateway 9pay vietnam payment-processing
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.25.0
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# 9PAY Payment Gateway Python SDK
+
+Official Python SDK for integrating 9PAY Payment Gateway.
+
+[English](#english) | [Tiếng Việt](#tiếng-việt)
+
+---
+
+## English
+
+### 🚀 Quick Start (Recommended)
+
+1. **Install SDK:**
+   ```bash
+   pip install ninepay-sdk python-dotenv
+   ```
+
+2. **Configure Environment:**
+   Copy `.env.example` to `.env` and fill in your credentials.
+   ```bash
+   cp .env.example .env
+   ```
+
+   ```env
+   NINEPAY_MERCHANT_ID=your_merchant_id
+   NINEPAY_SECRET_KEY=your_secret_key
+   NINEPAY_CHECKSUM_KEY=your_checksum_key
+   NINEPAY_ENV=SANDBOX
+   ```
+
+3. **Usage:**
+   ```python
+   from ninepay import NinePayConfig, NinePayGateway
+   
+   # Load config automatically from .env
+   config = NinePayConfig.from_env()
+   gateway = NinePayGateway(config)
+   ```
+
+### 📦 Features
+- ✅ **Dynamic Config**: Managed via `.env` files (PHP/Laravel style)
+- ✅ **Secure**: Signature generation and verification
+- ✅ **Complete**: Payment creation, inquiry, and webhook handlers
+- ✅ **Framework Friendly**: Ready for Django, Flask, FastAPI
+
+### 🛠 Installation
+```bash
+pip install ninepay-sdk
+```
+
+### 💡 Example: Create Payment
+```python
+from ninepay import CreatePaymentRequest, PaymentMethod, Currency, Language
+import time
+
+request = CreatePaymentRequest(
+    invoice_no=f'INV_{int(time.time())}',
+    amount='50000',
+    description='Order #12345',
+    back_url='https://yoursite.com/cancel',
+    return_url='https://yoursite.com/success'
+).with_method(PaymentMethod.ATM_CARD).with_lang(Language.EN)
+
+response = gateway.create_payment(request)
+if response.is_success():
+    print(f"Redirect URL: {response.get_data()['redirect_url']}")
+```
+
+---
+
+## Tiếng Việt
+
+### 🚀 Bắt đầu nhanh (Khuyên dùng)
+
+1. **Cài đặt:**
+   ```bash
+   pip install ninepay-sdk python-dotenv
+   ```
+
+2. **Cấu hình môi trường:**
+   Copy `.env.example` thành `.env` và điền thông tin của bạn.
+   ```bash
+   cp .env.example .env
+   ```
+
+3. **Sử dụng:**
+   ```python
+   from ninepay import NinePayConfig, NinePayGateway
+   
+   # Tự động load cấu hình từ file .env
+   config = NinePayConfig.from_env()
+   gateway = NinePayGateway(config)
+   ```
+
+### ✨ Tính năng chính
+- ✅ **Cấu hình tập trung**: Quản lý qua file `.env` (giống Laravel/PHP)
+- ✅ **Bảo mật**: Tự động tạo và xác thực chữ ký (checksum)
+- ✅ **Đầy đủ**: Hỗ trợ tạo thanh toán, truy vấn đơn hàng và Webhook
+- ✅ **Dễ tích hợp**: Tương thích tốt với Django, Flask, FastAPI
+
+### 💡 Ví dụ: Tạo thanh toán
+```python
+from ninepay import CreatePaymentRequest, PaymentMethod, Language
+import time
+
+request = CreatePaymentRequest(
+    invoice_no=f'INV_{int(time.time())}',
+    amount='100000',
+    description='Thanh toán đơn hàng #123',
+    back_url='https://site.com/cancel',
+    return_url='https://site.com/success'
+).with_method(PaymentMethod.ATM_CARD).with_lang(Language.VI)
+
+response = gateway.create_payment(request)
+if response.is_success():
+    print(f"URL Thanh toán: {response.get_data()['redirect_url']}")
+```
+
+### 🖥 Chạy Demo
+Bạn có thể chạy script demo để kiểm tra nhanh:
+```bash
+python demo.py
+```
+
+### 🧪 Chạy Test
+```bash
+python -m unittest discover tests -v
+```
+
+### 📞 Hỗ trợ
+- Email: support@9pay.vn
+- Website: https://9pay.vn
+
+---
+
+Licensed under MIT.

ninepay_sdk-1.0.0/README.md

@@ -0,0 +1,136 @@
+# 9PAY Payment Gateway Python SDK
+
+Official Python SDK for integrating 9PAY Payment Gateway.
+
+[English](#english) | [Tiếng Việt](#tiếng-việt)
+
+---
+
+## English
+
+### 🚀 Quick Start (Recommended)
+
+1. **Install SDK:**
+   ```bash
+   pip install ninepay-sdk python-dotenv
+   ```
+
+2. **Configure Environment:**
+   Copy `.env.example` to `.env` and fill in your credentials.
+   ```bash
+   cp .env.example .env
+   ```
+
+   ```env
+   NINEPAY_MERCHANT_ID=your_merchant_id
+   NINEPAY_SECRET_KEY=your_secret_key
+   NINEPAY_CHECKSUM_KEY=your_checksum_key
+   NINEPAY_ENV=SANDBOX
+   ```
+
+3. **Usage:**
+   ```python
+   from ninepay import NinePayConfig, NinePayGateway
+   
+   # Load config automatically from .env
+   config = NinePayConfig.from_env()
+   gateway = NinePayGateway(config)
+   ```
+
+### 📦 Features
+- ✅ **Dynamic Config**: Managed via `.env` files (PHP/Laravel style)
+- ✅ **Secure**: Signature generation and verification
+- ✅ **Complete**: Payment creation, inquiry, and webhook handlers
+- ✅ **Framework Friendly**: Ready for Django, Flask, FastAPI
+
+### 🛠 Installation
+```bash
+pip install ninepay-sdk
+```
+
+### 💡 Example: Create Payment
+```python
+from ninepay import CreatePaymentRequest, PaymentMethod, Currency, Language
+import time
+
+request = CreatePaymentRequest(
+    invoice_no=f'INV_{int(time.time())}',
+    amount='50000',
+    description='Order #12345',
+    back_url='https://yoursite.com/cancel',
+    return_url='https://yoursite.com/success'
+).with_method(PaymentMethod.ATM_CARD).with_lang(Language.EN)
+
+response = gateway.create_payment(request)
+if response.is_success():
+    print(f"Redirect URL: {response.get_data()['redirect_url']}")
+```
+
+---
+
+## Tiếng Việt
+
+### 🚀 Bắt đầu nhanh (Khuyên dùng)
+
+1. **Cài đặt:**
+   ```bash
+   pip install ninepay-sdk python-dotenv
+   ```
+
+2. **Cấu hình môi trường:**
+   Copy `.env.example` thành `.env` và điền thông tin của bạn.
+   ```bash
+   cp .env.example .env
+   ```
+
+3. **Sử dụng:**
+   ```python
+   from ninepay import NinePayConfig, NinePayGateway
+   
+   # Tự động load cấu hình từ file .env
+   config = NinePayConfig.from_env()
+   gateway = NinePayGateway(config)
+   ```
+
+### ✨ Tính năng chính
+- ✅ **Cấu hình tập trung**: Quản lý qua file `.env` (giống Laravel/PHP)
+- ✅ **Bảo mật**: Tự động tạo và xác thực chữ ký (checksum)
+- ✅ **Đầy đủ**: Hỗ trợ tạo thanh toán, truy vấn đơn hàng và Webhook
+- ✅ **Dễ tích hợp**: Tương thích tốt với Django, Flask, FastAPI
+
+### 💡 Ví dụ: Tạo thanh toán
+```python
+from ninepay import CreatePaymentRequest, PaymentMethod, Language
+import time
+
+request = CreatePaymentRequest(
+    invoice_no=f'INV_{int(time.time())}',
+    amount='100000',
+    description='Thanh toán đơn hàng #123',
+    back_url='https://site.com/cancel',
+    return_url='https://site.com/success'
+).with_method(PaymentMethod.ATM_CARD).with_lang(Language.VI)
+
+response = gateway.create_payment(request)
+if response.is_success():
+    print(f"URL Thanh toán: {response.get_data()['redirect_url']}")
+```
+
+### 🖥 Chạy Demo
+Bạn có thể chạy script demo để kiểm tra nhanh:
+```bash
+python demo.py
+```
+
+### 🧪 Chạy Test
+```bash
+python -m unittest discover tests -v
+```
+
+### 📞 Hỗ trợ
+- Email: support@9pay.vn
+- Website: https://9pay.vn
+
+---
+
+Licensed under MIT.

ninepay_sdk-1.0.0/examples/__init__.py

@@ -0,0 +1 @@
+# Examples for 9Pay SDK

ninepay_sdk-1.0.0/examples/create_payment.py

@@ -0,0 +1,67 @@
+"""
+Example: Basic payment creation
+"""
+
+from ninepay import (
+    NinePayConfig,
+    NinePayGateway,
+    CreatePaymentRequest,
+    PaymentMethod,
+    Currency,
+    Language
+)
+import time
+
+
+def main():
+    # Initialize configuration from .env file
+    # Make sure you have a .env file with:
+    # NINEPAY_MERCHANT_ID=your_merchant_id
+    # NINEPAY_SECRET_KEY=your_secret_key
+    # NINEPAY_CHECKSUM_KEY=your_checksum_key
+    # NINEPAY_ENV=SANDBOX
+    config = NinePayConfig.from_env()
+    
+    # Create gateway instance
+    gateway = NinePayGateway(config)
+    
+    # Create payment request
+    invoice_no = f'INV_{int(time.time())}'
+    
+    request = CreatePaymentRequest(
+        invoice_no=invoice_no,
+        amount='50000',
+        description='Payment for Order #123',
+        back_url='https://yoursite.com/payment/cancel',
+        return_url='https://yoursite.com/payment/success'
+    )
+    
+    # Add optional parameters
+    request.with_method(PaymentMethod.ATM_CARD) \
+           .with_client_ip('127.0.0.1') \
+           .with_currency(Currency.VND) \
+           .with_lang(Language.VI) \
+           .with_expires_time(1440)
+    
+    # Send payment request
+    try:
+        response = gateway.create_payment(request)
+        
+        if response.is_success():
+            data = response.get_data()
+            redirect_url = data.get('redirect_url')
+            print(f"✓ Payment created successfully!")
+            print(f"  Invoice No: {invoice_no}")
+            print(f"  Redirect URL: {redirect_url}")
+            print(f"\nPlease redirect user to: {redirect_url}")
+        else:
+            print(f"✗ Payment creation failed!")
+            print(f"  Error: {response.get_message()}")
+            print(f"  Error Code: {response.get_error_code()}")
+            
+    except Exception as e:
+        print(f"✗ Exception occurred: {str(e)}")
+
+
+if __name__ == '__main__':
+    main()