Metadata-Version: 2.3
Name: blindpay
Version: 2.0.0
Summary: Official Python SDK for the Blindpay API — Global payments infrastructure
Project-URL: Homepage, https://github.com/blindpaylabs/blindpay-python
Project-URL: Repository, https://github.com/blindpaylabs/blindpay-python
Project-URL: Documentation, https://api.blindpay.com/reference
Project-URL: Bug Tracker, https://github.com/blindpaylabs/blindpay-python/issues
Author-email: Blindpay <alves@blindpay.com>
License: MIT
Keywords: api,blindpay,global-payments,payment-processing,payments,sdk
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Typing :: Typed
Requires-Python: >=3.12
Requires-Dist: httpx<1,>=0.23.0
Requires-Dist: pydantic<3,>=1.9.0
Requires-Dist: typing-extensions<5,>=4.11
Description-Content-Type: text/markdown

# BlindPay Python SDK <img src="https://github.com/user-attachments/assets/c42b121d-adf1-467c-88ce-6f5be1efa93c" align="right" width="102"/>

[![chat on Discord](https://img.shields.io/discord/856971667393609759.svg?logo=discord)](https://discord.gg/x7ap6Gkbe9)
[![twitter](https://img.shields.io/twitter/follow/blindpaylabs?style=social)](https://twitter.com/intent/follow?screen_name=blindpaylabs)
[![Version](https://img.shields.io/github/v/release/blindpaylabs/blindpay-python?include_prereleases)](https://github.com/blindpaylabs/blindpay-python/releases)

The official Python SDK for [BlindPay](https://blindpay.com) - Stablecoin API for global payments.


## Installation

```bash
pip install blindpay
```

## Requirements

- Python 3.12 or higher

## Error Handling

All API methods return a response dictionary with either `data` or `error`:

```python
    blindpay = BlindPay(
        api_key="your_api_key_here",
        instance_id="your_instance_id_here"
    )

    response = await blindpay.receivers.get("receiver-id")

    if response['error']:
        print(f"Error: {response['error']['message']}")
        return

    receiver = response['data']
    print(f"Receiver: {receiver}")
```

## Types

The SDK includes comprehensive type definitions for all API resources and parameters. These can be imported from the main package:

```python
from blindpay import (
    AccountClass,
    BankAccountType,
    Country,
    Currency,
    CurrencyType,
    Network,
    Rail,
    StablecoinToken,
    TransactionDocumentType,
    TransactionStatus,
    PaginationParams,
    PaginationMetadata,
    # ... and more
)
```

## Development

This SDK uses:
- `uv` for package management
- `httpx` for async HTTP requests
- `pydantic` for data validation
- `typing_extensions` for typing

## License

MIT

## Support

For support, please contact alves@blindpay.com or visit [blindpay](https://blindpay.com)
