Metadata-Version: 2.4
Name: walletku-sdk
Version: 1.1.0
Summary: SDK resmi Walletku Payment Gateway (server-side): create payment QRIS/VA/e-wallet/cstore, refund, disbursement, vault, sub-merchant, verifikasi webhook.
Author-email: Walletku <halo@walletku.net>
License: MIT
Project-URL: Homepage, https://docs.walletku.net/sdk/
Project-URL: Documentation, https://docs.walletku.net
Keywords: walletku,payment-gateway,qris,virtual-account,indonesia
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# walletku-sdk (Python)

SDK resmi [Walletku](https://walletku.net) untuk backend Python ≥ 3.9 — stdlib saja.

> **PENTING:** memegang `apiSecret` — hanya untuk server, bukan mobile/frontend.

## Instalasi

```bash
pip install walletku-sdk        # resmi di PyPI
# alternatif tanpa registry:
pip install https://docs.walletku.net/sdk/files/walletku_sdk-1.0.0.tar.gz
```

## Pakai

```python
import os
from walletku import WalletkuClient, verify_webhook

wk = WalletkuClient("MID-000001", os.environ["WALLETKU_API_SECRET"],
                    base_url="https://sandbox-pay.walletku.net")
pay = wk.create_payment({"referenceId": "INV-001", "amount": 150000,
                         "paymentMethod": "qris"}, external_id="INV-001")

# webhook — verifikasi atas RAW BODY (bytes), jangan re-serialize
ok = verify_webhook(request.get_data(), request.headers["X-Webhook-Signature"],
                    request.headers["X-Webhook-Timestamp"],
                    os.environ["WALLETKU_WEBHOOK_SECRET"])
```

Test vector resmi: <https://docs.walletku.net/sdk/files/test-vectors.json> ·
Dokumentasi: <https://docs.walletku.net>
