Metadata-Version: 2.4
Name: smskap
Version: 1.0.0
Summary: SMSKap Official Python SDK - Non-VoIP real carrier SMS verification and virtual phone numbers for WhatsApp, WhatsApp Business, and Telegram.
Author-email: SMSKap Engineering <support@smskap.com>
Project-URL: Homepage, https://www.smskap.com/
Project-URL: Documentation, https://www.smskap.com/sms-onay
Project-URL: WhatsApp Sanal Numara, https://www.smskap.com/whatsapp-sanal-numara
Project-URL: Global Virtual Numbers, https://www.smskap.com/en/whatsapp-virtual-number
Project-URL: Telegram Verification, https://www.smskap.com/telegram-sanal-numara
Project-URL: Source, https://github.com/smsonay34/smskap-telecom-api
Keywords: sms-onay,wp-sanal-numara,sanal-numara-alma,whatsapp-virtual-number,telegram-virtual-number,non-voip,usa-virtual-number,uk-virtual-number,smskap
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Telecommunications Industry
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Communications :: Telephony
Classifier: Topic :: Security
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: requests>=2.25.0

# SMSKap Official Python SDK 🚀

[![PyPI version](https://img.shields.io/pypi/v/smskap.svg)](https://pypi.org/project/smskap/)
[![Python Versions](https://img.shields.io/pypi/pyversions/smskap.svg)](https://pypi.org/project/smskap/)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)

**[SMSKap](https://www.smskap.com/)** is an enterprise-grade telecommunications and physical cellular carrier routing platform delivering single-use disposable SMS verification codes and private virtual phone numbers.

Designed specifically for mission-critical workflows across **WhatsApp**, **WhatsApp Business**, and **Telegram**, SMSKap routes OTP traffic through authentic physical SIM cards across **Turkey (+90)**, **United States (+1)**, and the **United Kingdom (+44)**.

---

## 📌 Primary Features & Telecom Standards

* **100% Real Carrier Non-VoIP Routing:** Eliminates Meta and Telegram VoIP fraud detection filters to ensure 0% ban rates.
* **Instant OTP Delivery (10–30s):** Direct HLR-connected cellular base station query protocol.
* **Automated 100% Refund Guarantee:** If an activation code does not arrive within 60–90 seconds, the allocated balance is automatically refunded.
* **Single-Use Confidentiality:** Numbers are allocated strictly on a single-use basis and permanently retired to protect account privacy.

---

## 🔗 Official Portals & Core Services

* **Ana Platform:** [SMS Onay ve Sanal Numara Al](https://www.smskap.com/)
* **WhatsApp Hat Tahsisi (TR):** [wp sanal numara](https://www.smskap.com/whatsapp-sanal-numara)
* **SMS Doğrulama Servisi (TR):** [sms onay](https://www.smskap.com/sms-onay)
* **Tek Kullanımlık Numara Alma:** [sanal numara alma](https://www.smskap.com/sanal-numara)
* **Telegram Doğrulama:** [telegram sanal numara](https://www.smskap.com/telegram-sanal-numara)
* **Global Verification (EN):** [WhatsApp virtual number](https://www.smskap.com/en/whatsapp-virtual-number)
* **Enterprise Non-VoIP Numbers:** [non-VoIP virtual phone numbers](https://www.smskap.com/en/virtual-phone-number)
* **North America Routing (+1):** [USA virtual number](https://www.smskap.com/en/usa-virtual-number)
* **United Kingdom Routing (+44):** [UK virtual number](https://www.smskap.com/en/uk-virtual-number)

---

## 📦 Installation

```bash
pip install smskap
```

---

## 🚀 Quickstart Example

```python
from smskap import SMSKapClient, SMSKapError

# Initialize client with your private API key
client = SMSKapClient(api_key="YOUR_SMSKAP_API_KEY")

try:
    # 1. Check account balance
    balance = client.get_balance()
    print("Available Balance:", balance)

    # 2. Request an authentic physical SIM number for WhatsApp in Turkey (+90)
    # Supported services: 'whatsapp', 'whatsapp_business', 'telegram'
    # Supported countries: 'tr' (+90), 'usa' (+1), 'uk' (+44)
    rental = client.request_number(service="whatsapp", country="tr")
    print(f"Allocated Phone Number: {rental['phone_number']}")
    print(f"Activation ID: {rental['id']}")

    # 3. Poll for the incoming SMS verification code
    sms = client.get_sms_code(rental["id"])
    if sms.get("code"):
        print(f"Received SMS Verification Code: {sms['code']}")
    else:
        print("Waiting for SMS dispatch...")

except SMSKapError as e:
    print(f"SMSKap Error: {e}")
```

---

## 📊 Physical Carrier SIM vs. Virtual VoIP Routing

| Metric | SMSKap Physical Carrier SIM | Shared VoIP Services |
| :--- | :--- | :--- |
| **Carrier Detection** | Real GSM Mobile Carrier (Turkcell, Vodafone, EE, AT&T) | Virtual PBX / VoIP Datacenter |
| **WhatsApp Ban Risk** | **0% (Verified Mobile SMR)** | High (Blacklisted by Meta) |
| **Telegram Ban Risk** | **0% (HLR-verified cellular network)** | Immediate Account Suspension |
| **Refund Policy** | **100% Automated if no code received** | Manual / No refund |
| **Delivery Speed** | Instant Cellular Route (10–30s) | Unreliable / High Latency |

---

## 🛡️ License

This project is licensed under the MIT License — see the [LICENSE](https://opensource.org/licenses/MIT) file for details.
Official Website: [https://www.smskap.com/](https://www.smskap.com/)
