Hướng dẫn sử dụng

Bắt đầu với Code Pro ID, từng bước một

Đăng ký tài khoản, tạo shop, gửi QR cho khách và kết nối Google Sheets để lên đơn ngay trên bảng tính. Mỗi phần đều có ảnh chụp kèm chú thích để bạn làm theo.

Cập nhật · 15 ảnh hướng dẫn · Không cần biết lập trình

Chuẩn bị

  • Một số điện thoại hoặc email để đăng ký.
  • Tài khoản ngân hàng cá nhân đứng tên bạn và ít nhất một kênh bán hàng: Facebook, Zalo hoặc TikTok.
  • Nếu dùng Google Sheets: một tài khoản Google và quyền chỉnh sửa bảng tính của shop. Nên cài đặt lần đầu trên máy tính.

Code Pro ID không giữ tiền. Khách chuyển thẳng vào tài khoản ngân hàng của shop. Tạo đơn từ Google Sheets vẫn tính vào lượt tạo QR như khi tạo trong ứng dụng.

1. Đăng ký tài khoản

  1. Truy cập id.codepro.vn/signup.
  2. Chọn Số điện thoại hoặc Email, rồi nhập thông tin tương ứng.
  3. Đặt mật khẩu có ít nhất 8 ký tự.
  4. Đọc Điều khoản sử dụng và Chính sách bảo mật. Chỉ giữ ô đồng ý khi bạn chấp thuận, rồi bấm Tạo tài khoản.
Ảnh 1 — Chọn cách đăng ký ở đầu form; nhập thông tin và mật khẩu; nút Tạo tài khoản nằm cuối form.

2. Điền thông tin shop

Sau khi đăng ký, làm theo luồng thiết lập shop. Nếu đã vào Tổng quan, chọn Xác minh ngay để mở phần thông tin shop.

  1. Nhập Tên shop khách hàng thường gọi.
  2. Kiểm tra Tên người dùng: đây là phần sau dấu @ trong link trang shop, ví dụ id.codepro.vn/@ten-shop-cua-ban. Chọn tên còn trống theo thông báo của hệ thống.
  3. Ghi ngắn gọn shop Bán gì?
  4. Điền ít nhất một kênh Facebook, Zalo hoặc TikTok, rồi bấm Tiếp tục.
Ảnh 2 — Điền tên hiển thị, tên người dùng, ngành hàng và ít nhất một kênh liên hệ. Dữ liệu trong ảnh là của shop thử nghiệm.

Tên hiển thị và tên người dùng là hai mục khác nhau. Shop có thể sửa tên hiển thị; tên người dùng chỉ được đổi tối đa một lần trong 30 ngày.

3. Thêm tài khoản nhận tiền và chọn cách bắt đầu

  1. Chọn Ngân hàng, nhập Số tài khoản và Tên chủ tài khoản đúng như trong app ngân hàng. Tên chủ tài khoản viết hoa không dấu.
  2. Mở app ngân hàng, quét QR kiểm tra và đối chiếu tên người nhận. Đây là bước kiểm tra: không chuyển tiền.
  3. Khi tên đúng, tích ô xác nhận bên dưới QR.
  4. Chọn Dùng thử trước, xác minh sau để dùng ngay, hoặc Tiếp tục xác minh nếu muốn nộp hồ sơ danh tính.
Ảnh 3 — Kiểm tra tài khoản ở trên, quét thử QR rồi xác nhận tên. Hai lựa chọn bắt đầu nằm dưới phần kiểm tra.

Khi dùng thử, trang shop hiện nhãn Chưa xác minh danh tính. Xem hạn mức thực tế trên Tổng quan: hạn mức phụ thuộc trạng thái xác minh và shop có thể có lượt tặng hoặc hạn mức riêng.

Nếu chọn xác minh, hệ thống yêu cầu họ tên trên CCCD, ảnh hai mặt CCCD và ảnh chân dung. Đọc kỹ nội dung đồng ý lưu ảnh trước khi gửi: ảnh được giữ làm bằng chứng cung cấp cho cơ quan công an khi shop có báo cáo lừa đảo. Code Pro duyệt thủ công; gửi hồ sơ không có nghĩa là đã được duyệt. Hướng dẫn này không dùng ảnh giấy tờ thật để minh họa.

4. Tạo đơn và mã QR trong Code Pro ID

  1. Chọn Tạo QR trong menu.
  2. Kiểm tra tài khoản nhận tiền. Nếu shop có nhiều tài khoản dùng được, chọn đúng tài khoản cho đơn này.
  3. Chọn Đặt cọc hoặc Thanh toán toàn bộ.
  4. Có thể chọn sản phẩm/dịch vụ đã lưu để điền sẵn thông tin. Nếu chưa có, nhập trực tiếp Số tiền và Thông tin đơn hàng.
  5. Điền Tên khách nếu cần, rồi chọn thời hạn khách chuyển: 2 giờ, 24 giờ hoặc 3 ngày.
  6. Kiểm tra lại và bấm Tạo mã QR.
Ảnh 4 — Ví dụ đơn cọc 100.000đ. Thông tin đơn hàng sẽ hiển thị cho khách, nên không nhập địa chỉ hoặc dữ liệu riêng tư vào mục này.

Nội dung chuyển khoản được tạo tự động từ mã đơn. Không cần tự đặt nội dung chuyển khoản cho từng khách.

5. Gửi QR cho khách và xác nhận nhận tiền

Sau khi tạo, màn chi tiết đơn hiển thị mã QR và link thanh toán. Chọn Chép link để gửi qua Zalo/Messenger, Gửi cho khách nếu thiết bị hỗ trợ, hoặc Lưu ảnh QR.

Ảnh 5 — Các nút gửi, chép link và lưu QR nằm ngay dưới thông tin đơn. Link gửi khách có dạng `id.codepro.vn/payments/MADON`.

Khách mở link, kiểm tra shop, số tiền và tên người nhận, rồi chuyển khoản với đúng nội dung mã đơn. Sau khi chuyển, khách bấm Tôi đã chuyển khoản và nhập số điện thoại theo yêu cầu.

Ảnh 6 — Khách kiểm tra thông tin trước khi chuyển; nút Tôi đã chuyển khoản dùng để báo shop kiểm tra. QR trong ảnh là minh họa với tài khoản giả.

Shop mở Đơn hàng, chọn đơn khách đã báo chuyển, kiểm tra tiền thực nhận trong tài khoản ngân hàng rồi bấm Xác nhận đã nhận tiền. Nếu chưa nhận được, dùng Chưa nhận được; nếu cần dừng đơn, dùng Hủy đơn trong ứng dụng.

Đơn chỉ được tính là giao dịch thành công khi cả người mua và shop đã xác nhận. Việc khách bấm báo chuyển chưa có nghĩa là tiền đã về tài khoản shop.

6. Mở phần kết nối Google Sheets

Trong menu shop, chọn Google Sheet, hoặc mở Kết nối Google Sheet.

  1. Ở phần Tạo khóa API, nhập tên dễ nhớ, ví dụ “Bảng đơn hàng tháng 11”.
  2. Bấm Tạo khóa API và chép khóa vừa xuất hiện. Khóa gốc chỉ hiển thị một lần.
  3. Giữ khóa riêng tư, không dán vào ô của bảng tính, bài đăng hoặc ảnh chụp gửi người khác. Nếu bị lộ, thu hồi khóa trên trang này và tạo khóa mới.
  4. Chọn Chép script hoặc Tải file script để lấy bản cài đặt hiện hành.
Ảnh 7 — Trang kết nối có ba phần: tạo khóa, cài script và kiểm tra cột. Khung Cần nhớ giải thích thao tác xác nhận tiền và các trường hợp cần xử lý trong ứng dụng.

7. Cài script vào bảng tính

Phần này thao tác trên máy tính, trong bảng tính Google Sheets của shop.

  1. Mở bảng tính, chọn Tiện ích mở rộng → Apps Script.
  2. Đổi tên dự án thành Code Pro ID để dễ nhận biết khi Google hỏi quyền.
  3. Trong file script mặc định, xóa đoạn mẫu có sẵn, dán toàn bộ script vừa chép từ Code Pro ID rồi Lưu. Nếu bảng tính đã có script phục vụ việc khác, hãy dùng một bản sao để thử trước, không xóa mã đang dùng.
  4. Quay lại bảng tính và tải lại trang. Menu Code Pro ID sẽ xuất hiện.
  5. Chọn Code Pro ID → 1. Nhập khóa API. Google có thể yêu cầu đăng nhập và cấp quyền cho script. Kiểm tra đúng dự án mình vừa cài và đọc danh sách quyền trước khi tự quyết định cho phép. Nếu thấy cảnh báo ứng dụng chưa xác minh hoặc không chắc về quyền, liên hệ Code Pro hỗ trợ.
  6. Sau khi hoàn tất cấp quyền, mở lại 1. Nhập khóa API và dán khóa đã tạo.

Script chạy trong tài khoản Google của shop. Việc kết nối không cấp cho Code Pro quyền mở bảng tính của bạn; script gửi dữ liệu cần tạo đơn tới Code Pro ID.

Ảnh 8 — Google có thể ghi “Tiện ích” hoặc “Tiện ích mở rộng”; chọn Apps Script trong menu này.
Ảnh 9 — Dự án đã đổi tên thành Code Pro ID và chứa script chính thức. Không cần bấm Triển khai.
Ảnh 10 — Tải lại bảng tính để thấy menu với các bước được đánh số.
Ảnh 11 — Bấm OK để mở luồng chọn tài khoản và xem quyền. Nội dung các màn tiếp theo có thể khác theo tài khoản Google; đọc kỹ trước khi cho phép.
Ảnh 12 — Sau khi cấp quyền, mở lại 1. Nhập khóa API rồi dán khóa riêng của shop. Ảnh chụp hộp trống để không lộ khóa.

8. Chọn cột và bật tự động

  1. Mở đúng tab chứa đơn hàng.
  2. Chọn Code Pro ID → 2. Thiết lập cột (trang tính đang mở).
  3. Kiểm tra dòng tiêu đề và cột tương ứng với từng trường. Script có thể dò tiêu đề trong 10 dòng đầu và hỗ trợ tiêu đề một hoặc hai tầng.
  4. Xem trước 3 đơn đầu, đối chiếu tên khách, số tiền và nội dung, rồi bấm Lưu thiết lập.
  5. Chọn Code Pro ID → 3. Bật tự động.

Mỗi tab cần thiết lập riêng. Đừng chọn cột số điện thoại hoặc địa chỉ làm Nội dung đơn, vì nội dung này xuất hiện trên trang thanh toán của khách.

Ảnh 13 — Bảng thiết lập nằm bên phải. Kiểm tra các cột, cuộn xuống xem trước ba đơn đầu rồi bấm Lưu thiết lập.
Ảnh 14 — Thông báo xác nhận đã bật tự động: tích Tạo QR để tạo đơn, trạng thái cập nhật mỗi phút.
CộtCách dùng
Tên kháchDòng có tên khách mới được xem là đơn.
Sản phẩm / Dịch vụKhông bắt buộc. Chọn món từ danh mục để lấy giá; mỗi dòng chỉ chọn một sản phẩm hoặc một dịch vụ.
Số tiềnNhập số rõ ràng, ví dụ 100000, 100.000đ, 350k; có thể dùng công thức. Nếu lấy từ món đã lưu giá, kiểm tra số tiền tự điền.
Nội dungKhách đọc được trên trang thanh toán; có thể bỏ trống khi đã chọn món.
LoạiChọn Cọc hoặc Toàn bộ; nếu không có cột thì dùng loại mặc định lúc thiết lập.
Tạo QRShop tích để tạo đơn.
Mã đơn QR, Link QRScript tự ghi sau khi tạo thành công.
Trạng thái QRScript tự cập nhật định kỳ mỗi phút khi đã bật tự động.
Đã thanh toánTự tích khi đơn được xác nhận; shop cũng có thể tích để xác nhận sau khi khách báo chuyển và tiền thực tế đã về.

9. Lên đơn từ Google Sheets hằng ngày

  1. Nhập tên khách, nội dung và số tiền, hoặc chọn món từ danh sách sản phẩm/dịch vụ. Kiểm tra loại Cọc/Toàn bộ và giá tương ứng.
  2. Tích Tạo QR tại dòng đó.
  3. Chờ script ghi Mã đơn QR, Link QR và Trạng thái QR.
  4. Chép Link QR gửi khách.
  5. Khách chuyển khoản và báo đã chuyển trên trang thanh toán. Sau lần đồng bộ, dòng đơn chuyển màu vàng với trạng thái Khách báo đã chuyển.
  6. Kiểm tra tiền trong app ngân hàng. Khi đã nhận đúng khoản tiền, tích Đã thanh toán và đọc hộp hỏi lại trước khi xác nhận. Dòng đơn đã xác nhận chuyển màu xanh.

Nếu cần tạo nhiều đơn, chọn các dòng cần tạo rồi dùng Code Pro ID → Tạo QR cho các dòng đang chọn. Không kéo hoặc dán hàng loạt ô tích Tạo QR/Đã thanh toán: script bỏ qua thao tác này.

Ảnh 15 — Dòng Khách thử nghiệm 1 đã tích Tạo QR; script tự ghi mã NCP0111002, link thanh toán và trạng thái Chờ thanh toán. Các dòng chưa tích vẫn chưa có mã đơn.

Muốn kiểm tra trạng thái ngay, chọn Code Pro ID → Cập nhật trạng thái ngay. Khi thêm hoặc đổi tên/giá sản phẩm, dịch vụ trong Code Pro ID, chọn 4. Cập nhật danh sách sản phẩm / dịch vụ trên bảng tính.

Tự động ở đây là tạo QR từ dữ liệu bảng tính và cập nhật trạng thái. Shop vẫn kiểm tra tiền về và xác nhận nhận tiền. Tính năng ngân hàng tự xác nhận khi tiền về đang ở trạng thái Sắp ra mắt.

10. Xử lý tình huống thường gặp

  • Không thấy menu Code Pro ID: kiểm tra đã lưu script, quay lại bảng tính và tải lại trang.
  • Tích Tạo QR nhưng không có link: kiểm tra đã bật tự động, khóa còn hiệu lực, dòng có tên khách, số tiền/giá hợp lệ và shop còn lượt QR. Đọc thông báo lỗi trên bảng tính trước khi thử lại.
  • Đổi tên tiêu đề cột: chạy lại bước Thiết lập cột. Tiêu đề trùng hoặc đã đổi tên có thể khiến script dừng để tránh ghi nhầm.
  • Sửa số tiền sau khi đã tạo QR: đơn cũ giữ số tiền ban đầu. Hủy đơn trong Code Pro ID, xóa Mã đơn QR tại dòng tương ứng rồi tạo lại và gửi link mới cho khách.
  • Chưa nhận được tiền hoặc cần hủy: xử lý trong Code Pro ID; bảng tính cập nhật ở lần đồng bộ sau.
  • Khách đã bị trừ tiền nhưng shop chưa nhận: trao đổi với khách để kiểm tra biên lai; không yêu cầu chuyển lại ngay.

Cần hỗ trợ cài đặt theo bảng tính của shop? Nhắn Zalo Code Pro: 0977 977 655. Khi gửi ảnh nhờ hỗ trợ, che thông tin riêng tư và khóa API.

Sẵn sàng tạo QR đầu tiên?

Đăng ký tài khoản hoặc trở lại ứng dụng để bắt đầu. Nếu bảng tính có cách ghi riêng, Code Pro có thể hỗ trợ cài đặt.

Hướng dẫn đăng ký, tạo shop, tạo đơn và kết nối Google Sheets | Code Pro ID