Metadata-Version: 2.4
Name: zap-sdk
Version: 1.0.0
Summary: Official Python SDK for Zap Payments
Home-page: https://github.com/zap-payments/zap-python
Author: Zap Payments
Author-email: sdk@zap.payments
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.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
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: httpx>=0.27.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: eth-account>=0.11.0
Requires-Dist: web3>=6.0.0
Provides-Extra: dev
Requires-Dist: pytest>=8.0.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.23.0; extra == "dev"
Requires-Dist: black>=24.0.0; extra == "dev"
Requires-Dist: mypy>=1.8.0; extra == "dev"
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: provides-extra
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# Zap Payments Python SDK

Official Python SDK for Zap Payments - the stablecoin payment platform for tourists and merchants.

## Installation

```bash
pip install zap-sdk
```

## Quick Start

```python
from zap import Zap

# Initialize the client
zap = Zap(
    api_key="your_api_key_here",
    environment="sandbox"  # or "production"
)

# Create a wallet
wallet = await zap.wallets.create(
    type="tourist",
    default_currency="USDC"
)

# Request a payment
payment = await zap.payments.request(
    merchant_id="merchant_123",
    amount_aed=100.00,
    description="Coffee purchase"
)

# Get payment status
payment_status = await zap.payments.get(payment.payment_id)
```

## Features

- **Wallet Management**: Create and manage tourist, resident, and merchant wallets
- **Virtual Cards**: Issue and manage Visa/Mastercard virtual cards
- **Payments**: NFC tap-to-pay and QR code payments
- **Stablecoin Support**: USDC, USDT, and DAI on Polygon
- **Webhooks**: Real-time event notifications
- **Type Safety**: Full type hints with Pydantic models

## Documentation

For full documentation, visit [docs.zap.payments](https://docs.zap.payments)

## Requirements

- Python 3.8+
- httpx
- pydantic
- eth-account
- web3

## License

MIT License - see LICENSE file for details
