Kết nối thanh toán Binance Pay

Binance Pay hoạt động với ChatHub như thế nào?#

Khi khách đến bước workflow Nạp số dư qua Binance Pay, ChatHub quy đổi số dư cần nạp sang loại tiền đã cấu hình và giữ một số tiền lẻ riêng cho phiên đó. Khách chuyển đúng số tiền tới Pay ID của shop; ChatHub dùng API key chỉ đọc để dò lịch sử Binance Pay, ghép giao dịch theo số tiền rồi cộng số dư đã hứa vào ví khách.

1. 1

   Tạo cặp API Key/API Secret dạng System generated (HMAC) trên tài khoản Binance nhận tiền.

2. 2

   Lấy Pay ID của shop trong Binance Pay.

3. 3

   Nhập khóa, Pay ID, loại tiền nhận và tỷ giá quy đổi trong ChatHub rồi kiểm tra kết nối.

4. 4

   Dùng bước Nạp số dư qua Binance Pay trong workflow và thực hiện một giao dịch thử có số tiền chính xác.

1. Chuẩn bị trước khi cấu hình#

1. 1

   Tài khoản ChatHub có quyền mở và lưu Quản trị → Cài đặt → Thanh toán.

2. 2

   Tài khoản Binance đã hoàn tất các yêu cầu xác minh mà Binance áp dụng cho việc tạo API key và có thể nhận Binance Pay.

3. 3

   Xác định đơn vị số dư của shop. Nếu ví ChatHub tính theo VND và nhận USDT, hãy chọn tỷ giá vận hành phù hợp, ví dụ 1 USDT đổi được 25000 đơn vị số dư.

4. 4

   Nếu giới hạn API theo IP, chuẩn bị địa chỉ IP công khai của máy chủ chạy ChatHub. Đồng hồ máy chủ cần được đồng bộ để Binance chấp nhận chữ ký API.

Mở Binance API Management ↗

2. Mở API Management trên Binance#

1. 1

   Đăng nhập tài khoản Binance sẽ nhận tiền và mở Account → API Management.

2. 2

   Đọc cảnh báo bảo mật trên trang: giữ khóa như mật khẩu, chỉ cho phép IP tin cậy khi có thể và hoàn tất KYC nếu Binance yêu cầu.

3. 3

   Bấm Create API. Không dùng Create Tax Report API vì khóa đó không dành cho việc đọc lịch sử Binance Pay của ChatHub.

3. Tạo API key chỉ đọc dạng HMAC#

1. 1

   Trong Choose API Key type, chọn System generated. ChatHub cần cặp API Key và API Secret HMAC nên không dùng Self-generated (Ed25519/RSA).

2. 2

   Bấm Next, đặt nhãn dễ nhận biết như ChatHub rồi tiếp tục.

3. 3

   Tự hoàn tất bước xác minh bảo mật của Binance và xác nhận tạo khóa. Bài hướng dẫn không thực hiện bước này trên tài khoản mẫu.

4. 4

   Sau khi khóa được tạo, giữ Enable Reading. Không bật Spot & Margin Trading, Futures, Withdrawals hoặc quyền chuyển tài sản.

5. 5

   Nếu Binance cho giới hạn IP và máy chủ có IP ra Internet cố định, chỉ cho phép IP máy chủ ChatHub. Sao chép API Key và API Secret vào nơi bảo mật để dùng ở bước 5.

4. Lấy Binance Pay ID của shop#

1. 1

   Mở ứng dụng Binance bằng đúng tài khoản nhận tiền, vào Pay và tìm Pay ID trên hồ sơ Binance Pay.

2. 2

   Sao chép Pay ID số. ChatHub cũng chấp nhận email hoặc số điện thoại nhận tiền, nhưng Pay ID thường dễ đối chiếu và ít thay đổi hơn.

3. 3

   Tự gửi thử một yêu cầu chuyển tiền tới định danh đó trong Binance và dừng trước bước xác nhận nếu chỉ muốn kiểm tra người nhận. Không chuyển tiền chỉ để chụp ảnh hướng dẫn.

5. Nhập cấu hình Binance Pay trong ChatHub#

1. 1

   Trong ChatHub, mở Quản trị → Cài đặt → Thanh toán. Ở nhóm Tiền mã hoá, mở thẻ Binance Pay.

2. 2

   Nhập Binance Pay ID của shop, API Key và API Secret vừa tạo.

3. 3

   Loại tiền nhận: nhập mã tài sản khách phải chuyển, ví dụ USDT. ChatHub bỏ qua giao dịch bằng loại tiền khác.

4. 4

   Tỷ giá quy đổi: nhập số đơn vị số dư nhận được cho 1 đơn vị tiền Binance. Ví dụ 25000 nghĩa là 1 USDT đổi được 25000 số dư; hãy dùng chính sách tỷ giá của shop, không coi số minh họa là tỷ giá thị trường hiện tại.

5. 5

   Bấm Kiểm tra kết nối trước khi lưu. Khi hai ô khóa có giá trị mới, ChatHub thử chính cặp đang nhập; khi để trống, hệ thống thử cặp khóa đã lưu.

6. 6

   Khi báo khóa chạy được và đọc được lịch sử giao dịch, bấm Lưu. Chờ thông báo Đã lưu cài đặt thanh toán và kiểm tra thẻ chuyển sang Đã cấu hình.

6. Dùng Binance Pay trong workflow nạp số dư#

1. 1

   Mở Tự động hoá → Workflow và thêm hoặc kiểm tra bước Nạp số dư qua Binance Pay.

2. 2

   Nhập số tiền cần nạp theo đơn vị ví của shop. ChatHub chia theo tỷ giá và tạo số tiền nhận riêng tới tối đa bốn chữ số thập phân.

3. 3

   Trong tin nhắn cho khách, giữ các biến Pay ID, số tiền cần chuyển và loại tiền để khách nhận đúng hướng dẫn của phiên.

4. 4

   Nhắc khách chuyển đúng toàn bộ số tiền, kể cả phần lẻ. Binance Pay không mang nội dung chuyển khoản nên số tiền riêng là dữ liệu ChatHub dùng để ghép giao dịch.

5. 5

   Giữ nhánh thành công, lỗi và hết thời gian phù hợp trước khi bật workflow cho khách thật.

Xem hướng dẫn sử dụng Workflow ↗

7. Kiểm tra nhận tiền và cộng số dư#

1. 1

   Trước tiên bấm Kiểm tra kết nối. Kết quả thành công xác nhận máy chủ đọc được lịch sử Binance Pay; đây chưa phải giao dịch thanh toán.

2. 2

   Dùng một liên hệ kiểm thử chạy đến bước Binance Pay, ghi lại số dư cần nạp và số tiền USDT lẻ mà bot yêu cầu.

3. 3

   Từ một tài khoản Binance khác, kiểm tra Pay ID và tên người nhận rồi chuyển đúng loại tiền và đúng toàn bộ số tiền. Đây là giao dịch tiền thật, chỉ thực hiện với số nhỏ theo quy trình nội bộ.

4. 4

   Chờ hệ thống dò giao dịch, sau đó kiểm tra workflow đi tiếp, ví khách tăng đúng số dư đã yêu cầu và lịch sử biến động ghi nguồn Binance.

5. 5

   Nếu muốn kiểm tra ngay, khách có thể gửi mã giao dịch Binance cho bot; mã chỉ được chấp nhận khi khớp với giao dịch thật trong lịch sử.

8. Xử lý lỗi thường gặp#

1. 1

   Binance từ chối khóa: kiểm tra lại API Key/API Secret, khóa còn hoạt động và cặp secret đúng với key. Nếu mất secret, tạo cặp mới.

2. 2

   Báo thiếu quyền đọc: mở Edit restrictions của khóa trên Binance và bật Enable Reading; không bật các quyền tài chính không cần thiết.

3. 3

   Bị chặn theo IP: thêm đúng IP ra Internet của máy chủ ChatHub vào allowlist của khóa, hoặc tạm bỏ giới hạn để xác định nguyên nhân rồi cấu hình lại an toàn.

4. 4

   Báo lệch đồng hồ: đồng bộ giờ máy chủ bằng NTP và kiểm tra lại.

5. 5

   Lỗi mạng hoặc giới hạn tần suất: kiểm tra máy chủ truy cập được api.binance.com, DNS/tường lửa và chờ trước khi thử lại.

6. 6

   Khóa chạy được nhưng không cộng ví: kiểm tra loại tiền, số tiền có khớp đủ phần lẻ, phiên nạp còn chờ và giao dịch nằm trong 24 giờ từ lúc mở phiên.

7. 7

   Khách chuyển sai số tiền hoặc sai tài sản: không tự sửa dữ liệu giao dịch để ép khớp. Đối soát thủ công và xử lý theo quy trình hoàn/cộng số dư của shop.

9. Bảo mật và vận hành#

1. 1

   Giới hạn người được quản lý Cài đặt Thanh toán và API Management của Binance.

2. 2

   Đặt IP allowlist khi hạ tầng có IP cố định; định kỳ kiểm tra khóa vẫn chỉ có Enable Reading.

3. 3

   Nếu nghi khóa lộ, vô hiệu hóa hoặc xóa khóa trên Binance, tạo cặp mới, kiểm tra rồi cập nhật ChatHub ngay.

4. 4

   Theo dõi tỷ giá của shop và cập nhật có kiểm soát. Không đổi tỷ giá giữa lúc đang thử nếu chưa ghi lại số tiền bot đã yêu cầu.

5. 5

   Đối soát lịch sử Binance Pay với biến động ví ChatHub; không cộng tay lần nữa cho giao dịch đã được hệ thống ghi nhận.