# Nhật ký thay đổi

## v1 — 2026-11-01

Phát hành công khai đầu tiên của API v1.

- Xác thực bằng key: mọi request (trừ `/v1/keys`) yêu cầu `shield_key` (`shpk_live_…` / `shpk_test_…`).
- Envelope ký Ed25519 trên `/v1/capture_order` và `/v1/stripe/complete` — xác minh dựa trên JWKS tại `/v1/keys` trước khi tin tưởng kết quả.
- Quản lý key theo từng đối tác: hết hạn, thu hồi, cho phép origin, và shield pool.
- Checkout smart-buttons PayPal và Stripe Express Checkout (Apple Pay / Google Pay) + checkout dạng card-form.
- Loại bỏ các route chỉ dành cho wallet của API cũ; xem [hướng dẫn chuyển đổi](/docs/v1/migration) nếu đang rời khỏi API không có version.