Cài đặt
Cấu hình ngân hàng, Telegram bot, logic đối soát.
Ngân hàng
Telegram bot
Đối soát
Gmail TIMO
VPBank Direct
MBBank
API Keys
Bank webhook
🔐 Bảo mật

Tài khoản ngân hàng nhận

Thêm tài khoản để sinh VietQR tự động.
Ngân hàngSố TKChủ tài khoảnBINTrạng thái
Đang tải…

Telegram bot

Cho phép khách đặt hàng qua Telegram: /shop, /buy <SKU>, /status. Dán token từ BotFather rồi bấm lưu, hệ thống sẽ tự kiểm tra bot, lưu cấu hình và sync webhook.


Webhook sync

Website tự dùng domain hiện tại để gắn webhook Telegram. Nếu chạy qua tunnel/local domain khác, sửa URL gốc rồi bấm Sync lại.

Chưa đồng bộ.

Logic đối soát

Nếu tiền thực nhận lệch ≤ giá trị này so với đơn, hệ thống vẫn coi là khớp.

Kết nối Gmail · Đối soát TIMO tự động

Hệ thống sẽ tự đọc email thông báo giao dịch từ TIMO trong Gmail của bạn mỗi 2 phút, tự parse và đối soát đơn hàng.

Đang kiểm tra…

Cách hoạt động

  1. Bấm Kết nối Gmail → đăng nhập Google, cho phép đọc email
  2. Hệ thống tự quét email TIMO mỗi 2 phút (from:timo.vn)
  3. Parse số tiền, mã giao dịch, nội dung chuyển khoản
  4. Tự động khớp đơn hàng → giao mã → thông báo Telegram

API Keys cho shop

Tạo API key để tích hợp thanh toán VietQR vào website/app của bạn.
TênTrạng tháiLần dùng cuốiNgày tạo
Đang tải…

Tích hợp nhanh

Tạo đơn + nhận VietQR bằng API:

curl -X POST https://bank.atech.io.vn/api/v1/checkout \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: atk_YOUR_KEY" \
  -d '{
    "product_sku": "DIAMOND-100",
    "quantity": 1,
    "customer_ref": "user123"
  }'

Response trả về checkout_url + qr.image_url + status_url — redirect khách đến checkout_url hoặc embed QR trực tiếp.

Kiểm tra trạng thái: GET /api/v1/checkout/ODR-YYMMDD-XXXXXX — poll mỗi 3s cho đến khi statuspending

VPBank Direct BillGate-style

Kết nối trực tiếp VPBank API — tự quét giao dịch mỗi 2 phút.
Tài khoảnTrạng tháiLần quét cuốiLỗi
Đang tải…

Giao dịch gần đây

Thời gianSố tiềnNội dungTK
Chưa có giao dịch

Cách lấy KeyShare / PinShare

  1. Clone BillGate và chạy server
  2. Đăng ký tài khoản VPBank trên BillGate → lấy KeyShare + PinShare
  3. Nhập vào đây — hệ thống tự validate với VPBank API và lấy JWT
  4. Mỗi 2 phút hệ thống sẽ poll giao dịch mới → tự khớp đơn hàng

Kết nối MBBank · Đối soát tự động

Hệ thống tự đăng nhập MBBank API, quét giao dịch mỗi phút, tự khớp đơn hàng. Mật khẩu được mã hóa AES-256 trước khi lưu.

Đang kiểm tra…

Cách hoạt động

  1. Nhập tên đăng nhập + mật khẩu MBBank (mã hóa AES-256 trước khi lưu)
  2. Hệ thống tự giải captcha, đăng nhập, lấy session
  3. Mỗi phút tự quét giao dịch mới → tự khớp đơn hàng
  4. Không cần cài app hay giữ trình duyệt mở

Đổi mật khẩu

Tối thiểu 10 ký tự, nên có chữ hoa, số, ký tự đặc biệt.

Xác thực 2 bước (TOTP)

Dùng Google Authenticator, Authy hoặc 1Password.
Đang tải…

Passkey (FIDO2 / Vân tay / Face ID)

Đăng nhập nhanh, không cần mật khẩu — bảo mật cao nhất.
Đang tải…

Bank webhook endpoint

Dịch vụ biến động số dư (VD: Sacombank-webhook, Casso, vietcombank-webhook) sẽ POST JSON tới URL dưới. Token bảo mật đọc từ biến môi trường BANK_WEBHOOK_TOKEN.

Body JSON (mẫu)

{
  "bank_account_id": 1,
  "bank_tx_id": "FT2504240001",
  "amount": 95000,
  "content": "KHACH CK DON HANG ODR-260425-KSEEDZ",
  "direction": "credit"
}

Hoặc có thể gửi nguyên email biến động số dư qua trường email_raw — hệ thống sẽ tự parse số tiền, nội dung, mã giao dịch.