Sandbox tester

Kết nối App Store Connect để đổi tốc độ gia hạn của sandbox tester và xoá lịch sử mua trước khi chạy lại flow mua hàng.

Nối Astra Scout với App Store Connect để xoá lịch sử mua và tăng tốc độ gia hạn của sandbox tester ngay trong app, không cần mở website. Admin chuẩn bị key; sau đó tester dùng.

Sandbox tester là tài khoản Apple dùng riêng để mua thử: giao dịch là giả, không trừ tiền. Bạn tạo nó trong App Store Connect, website quản lý app của Apple. Tài khoản đã mua một gói đăng ký thì không thấy lại ưu đãi dùng thử, và gói đăng ký thật gia hạn quá chậm để test.

Trước khi bắt đầu

• Một API key của App Store Connect (chìa khoá cho phép Astra Scout nói chuyện với Apple): file .p8, Issuer ID và Key ID của nó.
• Vai trò tài khoản Apple quản lý được sandbox tester (Admin hoặc Account Holder).
• Ít nhất một sandbox tester trong App Store Connect > Users and Access > Sandbox.

Team key (nên dùng) do Admin tạo trong App Store Connect > Users and Access > Integrations, với vai trò Admin. Apple chỉ cho tải file .p8 một lần, nên cần lưu lại.

Individual key cũng được hỗ trợ. Key này không có Issuer ID: bật Individual key (không có Issuer ID) trong mục này.

Thiết lập

1. Chọn Astra Scout > Cài đặt… (Cmd+,) và bấm App Store ở thanh bên. Tiêu đề của pane ghi App Store Connect.
2. Ở mục API key, nhập Issuer ID và Key ID. Với individual key, bật Individual key (không có Issuer ID); ô Issuer ID sẽ biến mất.
3. Bấm Chọn file .p8… và chọn file. Dòng đó ghi "Đã chọn key: " kèm tên file và "Bấm Lưu." Chưa có gì được lưu.
4. Bấm Lưu. Dòng đó sau đó ghi Đã lưu key. (Lưu bị tắt cho đến khi đã có Key ID, một key và, với team key, cả Issuer ID.)
5. Bấm Kiểm tra kết nối. Thành công sẽ hiện Đã kết nối · N sandbox tester, với N là số sandbox tester của tài khoản.
6. Mục Sandbox tester xuất hiện. Chọn tester mà iOS device đăng nhập. Ban đầu nó là Không có.

Key được lưu mã hoá trên máy Mac này và không bao giờ hiện lại. Gỡ hỏi "Xoá API key App Store Connect?" và xoá key khỏi máy Mac này.

Nếu tài khoản chưa có sandbox tester nào, mục này ghi "Tài khoản này chưa có sandbox tester nào" và chỉ nơi tạo. Nếu bạn xoá tester đang chọn trong App Store Connect, Astra Scout quên lựa chọn đó ở lần tải danh sách tiếp theo, và ô chọn quay về Không có.

Đổi tốc độ gia hạn

1. Ở Sandbox tester, chọn một tester. Menu Tốc độ gia hạn gói đăng ký chỉ hiện khi đã chọn tester.
2. Mở Tốc độ gia hạn gói đăng ký và chọn một tốc độ.
3. Dòng bên dưới cho biết gói 6 tháng kéo dài bao lâu ở tốc độ đó. Apple có thể mất đến một giờ để áp dụng.

Apple gia hạn gói sandbox tối đa 12 lần, rồi gói kết thúc.

Tốc độ	1 tuần	1 tháng	2 tháng	3 tháng	6 tháng	1 năm
Mỗi 3 phút	3 phút	3 phút	6 phút	9 phút	18 phút	36 phút
Mỗi 5 phút (mặc định của Apple)	3 phút	5 phút	10 phút	15 phút	30 phút	1 giờ
Mỗi 15 phút	khoảng 5 phút	khoảng 15 phút	khoảng 30 phút	khoảng 45 phút	khoảng 1 giờ 30 phút	khoảng 3 giờ
Mỗi 30 phút	10 phút	30 phút	1 giờ	1 giờ 30 phút	3 giờ	6 giờ
Mỗi giờ	15 phút	1 giờ	2 giờ	3 giờ	6 giờ	12 giờ

Tốc độ chỉ đổi khi bạn chọn một tốc độ ở đây, hoặc khi một AI CLI yêu cầu (xem Từ terminal).

Xoá lịch sử mua

1. Kết nối device (xem Device) và mở menu ... trên thanh công cụ của device (tooltip là "Thêm tác vụ device").

2. Chọn Xoá lịch sử mua sandbox…. Mục này có trong menu của mọi device iOS, kể cả simulator. Nếu chưa có key hoặc tester, Cài đặt sẽ mở ở mục App Store; thiết lập rồi thử lại.

3. Một hộp thoại native tên "Xoá lịch sử mua sandbox?" nêu tên tài khoản sandbox và nhắc rằng không hoàn tác được. Bấm Xoá lịch sử mua (hoặc Huỷ).

   

4. Trong lúc gửi yêu cầu, nút ... hiện vòng quay. Sau đó một thông báo Đã gửi yêu cầu xoá lịch sử mua hiện ra: Apple đã nhận yêu cầu nhưng không báo khi nào xong. Bấm OK.

   

Gói đăng ký chưa hết hạn vẫn còn đến khi hết hạn. Hộp thoại cho biết gói 6 tháng kéo dài bao lâu ở tốc độ hiện tại. Nếu bạn hay chạy lại flow mua hàng, chọn tốc độ gia hạn nhanh trước.

Sau khi xoá

1. Nếu iOS yêu cầu, đăng nhập lại tài khoản sandbox.
2. Mở Settings > Developer > Sandbox Apple Account. iOS có thể đã tắt Allow Purchases & Renewals; bật lại.
3. Mở lại app và kiểm tra app hiện trạng thái miễn phí hoặc paywall.
4. Chạy flow mua hàng.

Xem Test mua hàng cho phần còn lại của việc chuẩn bị iOS device.

Từ terminal

Nếu bạn điều khiển Astra Scout bằng một AI CLI (Claude Code, Codex, Gemini CLI), CLI có plugin Astra Scout dùng được cùng API key này (xem Plugin scout và skill test-purchase):

• list_sandbox_testers liệt kê các tester. Nó chỉ đọc.
• set_sandbox_renewal_rate đổi tốc độ gia hạn của một tester.
• clear_purchase_history không bao giờ tự thực hiện. Nó trả NEEDS_CONFIRMATION, và cùng hộp thoại native như trên ("Xoá lịch sử mua sandbox?") hiện trong Astra Scout. Yêu cầu được liệt kê là Chờ xác nhận trong Hoạt động từ CLI ở Cài đặt > AI > Kết nối MCP. Không gì bị xoá cho đến khi bạn bấm Xoá lịch sử mua.

Xử lý sự cố

Thông báo	Cách xử lý
Apple từ chối API key: kiểm tra lại Issuer ID, Key ID và file .p8.	Kiểm tra ba giá trị. File .p8 phải thuộc đúng Key ID đó. Individual key cần bật Individual key (không có Issuer ID).
API key này không có quyền quản lý sandbox tester (cần vai trò Admin hoặc Account Holder).	Nhờ Admin tạo key, hoặc đổi vai trò của chủ key.
Không tìm thấy sandbox tester này trên App Store Connect (có thể đã bị xoá).	Chọn tester khác ở Sandbox tester.
Apple đang giới hạn tốc độ yêu cầu (rate limit). Đợi một lát rồi thử lại.	Đợi một phút rồi thử lại.
Không mở được key đã lưu nữa. Hãy chọn lại file .p8.	Bấm Chọn file .p8… rồi Lưu.
Không kết nối được tới App Store Connect. Kiểm tra mạng.	Kiểm tra kết nối mạng của Mac.
File này không phải private key .p8.	Chọn file .p8 bạn đã tải từ App Store Connect.