Lập trìnhBảo vệ thanh toánChi tiết
- Chỉnh sửa trong phạm vi gói là miễn phí.
- Nếu bạn không phản hồi trong vòng 3 ngày sau khi bàn giao, kết quả sẽ được tự động chấp nhận.
Số tiền được tạm giữ khi bạn thanh toán và chỉ được chuyển khi bạn chấp nhận kết quả.

Ví dụ kết quả
Đặc tả Telegram Mini App đặt lịch rửa xe
Điểm truy cập
- Nút menu trong cuộc trò chuyện với @AquaDriveBot
- Đường dẫn trong kênh Telegram của chuỗi (11,000 người theo dõi)
- Mã QR tại mỗi khoang rửa, mở ứng dụng với chi nhánh đó đã được chọn sẵn
Màn hình
| Màn hình | Người dùng làm gì | Dữ liệu |
|---|---|---|
| Chi nhánh | Chọn một trong 5 tiệm trên bản đồ hoặc danh sách | Địa chỉ, giờ mở cửa, số xe đang chờ |
| Dịch vụ | Chọn kiểu rửa và cỡ xe | 4 gói, 3 cỡ xe, giá |
| Giờ | Chọn khung 20 phút | Khung trống trong 7 ngày tới |
| Thanh toán | Thanh toán hoặc chọn "trả tại tiệm" | Nhà cung cấp thanh toán qua BotFather |
| Lịch sử | Xem lịch đặt và tem thành viên | 5/6 tem, lần rửa tiếp theo miễn phí |
Quy tắc chính
- Người dùng được nhận diện bằng initData của Telegram, kiểm tra trên máy chủ bằng token của bot; không cần đăng ký riêng
- Khung giờ được giữ 10 phút trong lúc thanh toán, sau đó được giải phóng
- Bot gửi lời nhắc trước 1 giờ
- Ứng dụng theo giao diện của Telegram (sáng hoặc tối) và chạy trên màn hình từ 360 px
Ngoài phạm vi phiên bản 1
Gói thuê bao, ứng dụng cho nhân viên và thanh toán bằng Telegram Stars (Stars dành cho hàng hóa số, còn rửa xe là dịch vụ vật lý).
Bàn giao
Bản đặc tả 9 trang, sơ đồ màn hình và danh sách 12 phương thức API cho lập trình viên.
Khách hàng: Aqua Drive, chuỗi 5 tiệm rửa xe Yêu cầu: đặc tả Telegram Mini App: đặt khung giờ, thanh toán trước và tích điểm thành viên (rửa lần thứ 6 miễn phí)
Khách hàng và mọi thông tin đều là giả định.
Về dịch vụ này
Telegram Mini App là ứng dụng web mở bên trong Telegram, và điều đó thay đổi luật chơi: người dùng đăng nhập qua tài khoản Telegram, màn hình phải vừa cửa sổ chat trên điện thoại và theo giao diện Telegram, còn thanh toán cho hàng hóa kỹ thuật số đi qua Telegram Stars. Chúng tôi viết bản đặc tả bao gồm cách ứng dụng được khởi chạy, từng màn hình, hành vi của nút chính và nút quay lại, đăng nhập, thanh toán, thông báo và phần quản trị. Lập trình viên am hiểu nền tảng Telegram có thể báo giá và xây dựng dựa trên đó.
Bao gồm những gì
- Bạn nhận được gìBản đặc tả Mini App gồm mục tiêu, điểm khởi chạy, danh sách màn hình và nội dung, luồng đăng nhập và thanh toán, thông báo, tính năng quản trị và câu hỏi mở, dưới dạng văn bản đã định dạng; mọi con số về thời gian hay chi phí chỉ mang tính tham khảo sơ bộ, không phải báo giá.
- Điểm khởi chạyNút menu, đường dẫn, nút trong chat và kênh
- Màn hìnhMỗi màn hình được thiết kế vừa cửa sổ Telegram
- Điều khiển của TelegramNút chính, nút quay lại, màu giao diện
- Đăng nhập và thanh toánĐăng nhập bằng tài khoản Telegram, thanh toán bằng Stars hoặc thẻ
- Phần quản trịQuản lý đơn hàng, nội dung và người dùng
Cách hoạt động
- 1Yêu cầuBạn mô tả ứng dụng và đối tượng
- 2Lên kế hoạchChúng tôi lập sơ đồ khởi chạy, màn hình và thanh toán
- 3Đặc tảBạn nhận bản đặc tả cho lập trình viên
Chúng tôi cần gì từ bạn
Mini App làm gì và cho ai, người dùng sẽ mở nó từ đâu, họ có thể mua hoặc đặt gì, những Mini App bạn thích và bạn đã có kênh hoặc cộng đồng Telegram chưa.
Chúng tôi sẽ hỏi bạn:
- Mini App nên làm gì?
- Người dùng sẽ mở nó từ đâu?
- Người dùng có thanh toán trong ứng dụng không?
- Bạn có cần trang quản trị không, và ai sẽ dùng?
So sánh các gói
| Các gói | Cơ bản515.000 ₫ | Tiêu chuẩn1.057.000 ₫ | Cao cấp2.141.000 ₫ |
|---|---|---|---|
| Bao gồm những gì | Bản yêu cầu một trang | Đặc tả tối đa 10 trang | Đặc tả đầy đủ tối đa 20 trang |
| Thời hạn | 1 ngày | 3 ngày | 5 ngày |
| Số lần chỉnh sửa | 1 | 2 | 3 |
| Độ dài | 1 trang | tối đa 10 trang | tối đa 20 trang |
| Luồng thanh toán | Không | Có | Có |
| User story và tiêu chí nghiệm thu | Không | Không | Có |
| Đặt hàng Cơ bản | Đặt hàng Tiêu chuẩn | Đặt hàng Cao cấp |
Bảo vệ thanh toán
Bạn thanh toán khi đặt hàng, nhưng tiền chỉ được chuyển cho kết quả đã được chấp nhận.
- Giá cố địnhGiá gói không thay đổi sau khi bạn thanh toán.
- Số tiền được tạm giữKhi bạn thanh toán, số tiền chỉ được tạm giữ. Tiền được chuyển cho dịch vụ khi bạn chấp nhận kết quả.
- Kiểm tra trước khi bàn giaoMọi kết quả đều được kiểm tra chất lượng trước khi đến tay bạn, và bạn xem được kết quả trên trang đơn hàng trước khi chấp nhận.
- Chỉnh sửa miễn phíYêu cầu chỉnh sửa trong phạm vi bản yêu cầu của bạn, với số lần mà gói cho phép.
- Tự động chấp nhận sau 3 ngàyNếu trong vòng 3 ngày sau khi bàn giao, bạn không chấp nhận kết quả cũng không yêu cầu chỉnh sửa, kết quả sẽ được tự động chấp nhận. Nếu bạn nhắn tin trong chat đơn hàng sau khi bàn giao, đơn hàng sẽ chờ; sau khi trả lời, chúng tôi có thể tính lại 3 ngày từ đầu và sẽ thông báo trong chat.
- Làm lại hoặc hoàn tiền toàn bộNếu kết quả không đúng với yêu cầu của bạn và các lần chỉnh sửa không khắc phục được, hoặc công việc kéo dài quá gấp đôi thời hạn, hãy nhắn tin trong chat đơn hàng: chúng tôi sẽ làm lại hoặc hoàn tiền toàn bộ.
Hỏi đáp
Thanh toán có bắt buộc qua Telegram Stars không?
Với hàng hóa và dịch vụ kỹ thuật số bên trong Telegram, Stars là phương thức bắt buộc theo quy định hiện hành của nền tảng; hàng hóa vật lý có thể dùng nhà cung cấp dịch vụ thanh toán thẻ. Quy định nền tảng có thể thay đổi, nên bản đặc tả đánh dấu điểm này để lập trình viên của bạn xác nhận.
Ứng dụng có chạy được trên trình duyệt thông thường không?
Có thể, nếu bạn muốn. Bản đặc tả nêu rõ tính năng nào phụ thuộc vào Telegram và điều gì xảy ra khi ứng dụng được mở bên ngoài Telegram.
Bạn có xây dựng Mini App không?
Không, dịch vụ này chỉ là bản đặc tả.
Chưa tìm thấy câu trả lời?


