Tự động ghi nhận lệ phí giải đấu bằng SePay: tạo tài khoản và cấu hình webhook

Galaz Team · 17/10/2026

Thu lệ phí bằng chuyển khoản nhanh cho VĐV nhưng mệt cho thủ quỹ: mỗi tối dò sao kê, đối từng khoản với từng đơn đăng ký. Galaz nối được với SePay để việc đó tự chạy. VĐV quét mã VietQR trên trang đăng ký, tiền về tài khoản của ban tổ chức, và vài giây sau suất đăng ký tự chuyển sang đã đóng.

Thiết lập làm một lần cho cả tổ chức và dùng cho mọi giải về sau. Mất khoảng 20–30 phút.

Cách hoạt động

Ai	Việc gì xảy ra
VĐV	Gửi đăng ký, quét mã VietQR. Nội dung chuyển khoản có sẵn mã đăng ký dạng `RLY` + 10 ký tự
Ngân hàng	Tiền về tài khoản nhận lệ phí của giải
SePay	Thấy biến động số dư, báo ngay cho Galaz kèm chữ ký bảo mật
Galaz	Mã đúng và đủ tiền thì ghi nhận lệ phí

Ba điều nên biết trước:

SePay chỉ đọc biến động số dư. Không ai chuyển được tiền ra khỏi tài khoản qua SePay hay Galaz.
Galaz không tự duyệt đơn. Đơn chờ duyệt chỉ được gắn nhãn Đã chuyển khoản; khi ban tổ chức duyệt, suất tự thành đã đóng. Suất đã duyệt thì chuyển sang đã đóng ngay.
Chỉ đơn gửi qua trang đăng ký công khai mới có mã đăng ký. Suất ban tổ chức tự nhập không được tự ghi nhận.

Cần chuẩn bị gì

Thứ cần có	Ghi chú
Tài khoản ngân hàng nhận lệ phí	Nên là tài khoản riêng cho lệ phí giải: SePay tính phí theo số giao dịch, và sổ lệ phí không lẫn với tiền khác
Quyền quản trị viên của tổ chức trên Galaz	Thư ký, thủ quỹ, trọng tài không thấy phần cài đặt này
Điện thoại có Zalo hoặc nhận SMS	Để nhận mã OTP khi đăng ký SePay
App ngân hàng của tài khoản nhận lệ phí	Để xác nhận khi liên kết với SePay

Bước 1: tạo tài khoản SePay

Mở my.sepay.vn/register, điền email, mật khẩu, số điện thoại rồi bấm Đăng ký.
Xác thực số điện thoại bằng mã OTP 6 số. Chọn nhận qua Zalo cho nhanh; chưa thấy mã thì đợi hết đếm ngược rồi bấm Gửi lại mã hoặc đổi sang SMS.
Chọn gói dịch vụ. SePay tính phí theo số giao dịch mỗi tháng và có gói miễn phí với số giao dịch giới hạn; giá hiện hành ở sepay.vn/bang-gia.html. Ước lượng: mỗi đơn đăng ký chuyển khoản một lần là một giao dịch. Giải 80 đôi thu lệ phí theo đôi khoảng 80 giao dịch, thu theo VĐV khoảng 160.
Nếu chọn gói trả phí: mở app ngân hàng, quét mã QR SePay hiện ra và giữ nguyên nội dung chuyển khoản. Thấy "Thanh toán thành công!" là xong.

Bước 2: liên kết tài khoản ngân hàng với SePay

SePay cần thấy tiền vào tài khoản nhận lệ phí. Có hai cách:

Cách liên kết	Tốc độ báo	Khi nào chọn
Qua API ngân hàng (nên dùng)	Gần như tức thì	Tài khoản ở ngân hàng SePay có API: MB, ACB, BIDV, VietinBank, VPBank, TPBank, OCB, MSB, KienLongBank, Sacombank… Danh sách đầy đủ hiện trong SePay khi thêm tài khoản
Qua SMS biến động số dư	Chậm hơn, phụ thuộc tin nhắn	Ngân hàng chưa có API. SePay cấp một số điện thoại; bạn đăng ký với ngân hàng để gửi SMS biến động số dư tới số đó

Trong SePay, mở mục Ngân hàng và thêm tài khoản. Chọn ngân hàng của tài khoản nhận lệ phí và làm theo hướng dẫn SePay hiện cho ngân hàng đó.
Chuyển thử 2.000đ vào tài khoản đó từ một tài khoản khác. Giao dịch hiện ở mục Giao dịch của SePay là liên kết đã chạy.

Bước 3: bật trên Galaz, lấy địa chỉ và khoá ký

Mở Galaz, vào menu Đăng ký. Kéo xuống thẻ Tài khoản nhận lệ phí và kiểm tra số tài khoản trùng với tài khoản vừa liên kết ở SePay.
Ngay bên dưới, ở thẻ Tự động ghi nhận chuyển khoản (SePay), bấm Bật. Thẻ hiện:
- Địa chỉ (URL): xem lại được bất cứ lúc nào.
- Khoá ký (Secret Key): chỉ hiện một lần.
Giữ nguyên trang Galaz trong lúc làm bước 4, hoặc bấm Sao chép khoá ký và dán tạm vào nơi chỉ mình bạn xem được.

Khoá ký như mật khẩu. Không gửi vào nhóm chat, không chụp màn hình gửi người khác. Lỡ làm mất hoặc nghi bị lộ: bấm Tạo khoá mới trên Galaz rồi dán khoá mới vào SePay. Địa chỉ URL giữ nguyên.

Bước 4: tạo webhook trên SePay

Mở my.sepay.vn/webhooks, bấm + Thêm webhook ở góc trên bên phải. SePay hỏi 4 bước; điền đúng như sau.

Bước 1 của SePay: Thông tin cơ bản

Ô	Điền
Tên webhook	`Galaz – lệ phí giải` (tên gì cũng được)
Sự kiện	Có tiền vào. Không chọn "Có tiền ra" hay "Cả hai"
URL nhận webhook	Dán Địa chỉ (URL) từ Galaz, nguyên văn

Bước 2 của SePay: Tài khoản và bộ lọc

Ô	Điền
Tài khoản ngân hàng	Đúng tài khoản nhận lệ phí, trùng thẻ Tài khoản nhận lệ phí trên Galaz
Lọc theo tài khoản ảo (VA)	Không lọc
Lọc theo tiền tố mã thanh toán	Không lọc. Galaz tự đọc mã `RLY…` trong nội dung chuyển khoản; bật lọc của SePay có thể làm rơi khoản hợp lệ

Bước 3 của SePay: Bảo mật

Ô	Điền
Phương thức xác thực	HMAC-SHA256. Chọn cách khác thì Galaz từ chối mọi thông báo
Secret Key	Dán Khoá ký từ Galaz

Bước 4 của SePay: Cảnh báo

Bật email hoặc Telegram của người phụ trách tài chính. SePay sẽ báo khi gửi tới Galaz thất bại, để bạn biết sớm thay vì phát hiện lúc VĐV hỏi.

Bấm Thêm để lưu.

Bước 5: thử một lần cho chắc

Làm trước khi mở đăng ký, hoặc ngay nếu giải đã nhận đăng ký.

Tự gửi một đơn đăng ký thử trên trang đăng ký công khai của giải. Màn hình xác nhận hiện Mã đăng ký và mã VietQR.
Quét mã VietQR để chuyển đúng số lệ phí, giữ nguyên nội dung chuyển khoản.
Quay lại thẻ SePay trên Galaz. Danh sách Khoản chuyển gần đây ngân hàng đã báo hiện khoản vừa chuyển với chữ Đã ghi nhận lệ phí, và đơn thử có nhãn Đã chuyển khoản.
Từ chối hoặc xoá đơn thử và tự hoàn lại khoản tiền thử.

Không thấy gì sau 2–3 phút: xem mục Giao dịch của SePay. Không có giao dịch là lỗi liên kết ngân hàng (bước 2). Có giao dịch mà Galaz không hiện là lỗi webhook (bước 4): kiểm lại URL, phương thức HMAC-SHA256 và khoá ký.

Dặn VĐV một câu

"Quét mã VietQR trên trang đăng ký, giữ nguyên nội dung chuyển khoản, chuyển đủ lệ phí trong một lần." Hầu hết khoản tiền không tự ghi nhận là do VĐV tự gõ nội dung hoặc chuyển thiếu.

Khi một khoản tiền không được tự ghi nhận

Thẻ SePay trên Galaz ghi lý do cạnh từng khoản. Khoản không tự ghi thì ban tổ chức xử lý tay như trước, không mất gì.

Galaz báo	Thường do	Làm gì
Nội dung chuyển khoản không có mã đăng ký	VĐV tự gõ nội dung, không quét VietQR	Tìm đơn theo tên, đánh dấu đã đóng bằng tay
Không có đăng ký nào mang mã này	Gõ sai mã, hoặc mã của giải khác	Hỏi VĐV mã đúng rồi ghi tay
Số tiền chưa đủ lệ phí	Chuyển thiếu, hay gặp khi lệ phí tính theo VĐV	Nhắn VĐV chuyển phần còn thiếu, hoặc ghi tay nếu chấp nhận
Tiền vào tài khoản khác với tài khoản nhận lệ phí của giải	Webhook chọn nhầm tài khoản, hoặc giải đặt tài khoản khác	Cho hai nơi dùng cùng một tài khoản
Mã khớp nhiều hơn một đăng ký	Một khoản trả cho nhiều đơn	Xem bằng tay, chia tiền cho từng đơn
Đăng ký đã bị từ chối	VĐV chuyển sau khi bị từ chối	Cân nhắc hoàn tiền
Đã ghi nhận lệ phí từ trước	VĐV chuyển hai lần	Hoàn lại khoản thừa

Thẻ báo không bật được: bản Galaz bạn dùng chưa mở tính năng này. Trong lúc chờ, dùng Đối soát sao kê ở trang Tài chính: tải file sao kê từ app ngân hàng, Galaz đọc mã đăng ký và ghi nhận hàng loạt.

Câu hỏi thường gặp

Có an toàn cho tài khoản ngân hàng không? SePay chỉ nhận thông tin biến động số dư, không có quyền chuyển tiền. Galaz chỉ nhận thông báo được ký bằng khoá ký của tổ chức bạn; thông báo giả hoặc bị sửa giữa đường bị từ chối.

Một khoản bị báo hai lần thì có ghi trùng không? Không. Mỗi giao dịch SePay có mã riêng, Galaz bỏ qua lần báo lặp.

Tổ chức có nhiều giải thì sao? Một webhook dùng cho mọi giải. Mã đăng ký cho Galaz biết khoản tiền thuộc đơn nào, giải nào.

Đổi sang tài khoản ngân hàng khác? Sửa ở cả thẻ Tài khoản nhận lệ phí trên Galaz và bước 2 của webhook trên SePay.

Muốn dừng? Bấm Tắt ở thẻ SePay trên Galaz, rồi xoá webhook trên SePay. Lệ phí đã ghi nhận giữ nguyên.

Các bước phía SePay theo tài liệu chính thức của SePay (docs.sepay.vn). Giao diện SePay có thể đổi chữ hoặc vị trí nút; các ô cần điền vẫn như trên.