# DigiDala alpha.44 — release changeset

Alpha.44 is the first verified Telegram Stars payment foundation release following the DigiDala public rename.

## Release identity

```text
Commit:
6387d2df260752ef51f7b79564038dffb5d8f38c

Tag:
v0.4.0-alpha.44

Active release:
/opt/pixdala/releases/v0.4.0-alpha.44
```

## Change

Added a permanent Telegram bot project-support payment flow using Telegram Stars. The Sandbox remains free. Stars are an external funding rail and do not grant access to the future internal `pix` economy.

User-facing flow:

```text
⭐ Поддержать проект
        ↓
1 / 5 / 10 / 25 / 50 / 100 ⭐
        ↓
Telegram invoice
        ↓
server-side pre-checkout verification
        ↓
successful payment
        ↓
paid record in SQLite
```

## Technical scope

- Added Telegram Stars currency `XTR` support.
- Added durable `telegram_payments` schema and indexes.
- Added `PaymentRepository` for project-support intents, verification and idempotent finalization.
- Added server-side internal payment endpoints restricted to localhost.
- Added Telegram bot handling for callback queries, pre-checkout queries and successful payments.
- Stored `telegram_payment_charge_id` for auditability and future refund/reconciliation work.
- Preserved separation between Stars payments and the future internal `pix` ledger.

## Verification

```text
Structure: OK
JavaScript syntax: OK
Unit: 10/10
Integration: 21/21
API: 10/10
Total: 41/41
```

Deployment used the exact tag `v0.4.0-alpha.44` and completed successfully.

Manual Telegram QA passed: support button, amount selection, Telegram invoice, pre-checkout, successful 1-Star payment and success response. The real payment was then confirmed in the active Alpha.44 SQLite database and associated with the Telegram user and charge ID.

## Known limitation

Closing/abandoning the Telegram invoice without successful payment does not currently create a dedicated cancellation event in the ledger, so some payment intents can remain `pending`. Reconciliation/recovery is intentionally deferred to payment hardening.

## Scope boundary

Alpha.44 does not introduce the internal `pix` / `pixcoin` economy or paid Mandala access. The next product step after payment hardening is P0.5b: the server-authoritative pix ledger.
