Webhook cho lập trình viên
JSON POST tới URL của bạn ngay khi có giao dịch, xác thực bằng header ALLPAY-TOKEN hoặc Authorization: Apikey <token>.
- Lọc tiền vào / ra
- Lọc theo VA
- Bỏ qua giao dịch không có mã
- Tự gửi lại sau 5 phút
TinoPay kết nối Open API chính thức của BIDV và đẩy từng giao dịch tới webhook, Telegram, Lark hoặc Google Sheets ngay khi tiền về — kèm tài khoản định danh để mỗi đơn hàng tự đối soát.
Giao dịch mới
BIDV · 08:33:38
+150.000đ
ALLPAY-TOKEN: ••••••••••••
Content-Type: application/json
{
"transaction_id": "20251020083338000006",
"gateway": "BIDV",
"transactionDate": "2026-10-20 08:33:38",
"accountNumber": "96247100868",
"code": "DH12345",
"content": "DH12345 chuyen tien mua hang",
"transferType": "in",
"transferAmount": 150000,
"referenceCode": "0551dTCO-82LiomOss",
"virtualAccount": "9624QA01"
}
Qua Open API chính thức do ngân hàng cung cấp.
Đang hoạt động
Tính năng
Một kết nối BIDV, nhiều cách nhận dữ liệu: webhook cho dev, Telegram và Lark cho vận hành, Google Sheets cho kế toán.
JSON POST tới URL của bạn ngay khi có giao dịch, xác thực bằng header ALLPAY-TOKEN hoặc Authorization: Apikey <token>.
Nhận biến động số dư realtime từ tài khoản doanh nghiệp BIDV, không cần chia sẻ mật khẩu ngân hàng.
Trích mã đơn hàng từ nội dung chuyển khoản vào field code.
"DH12345 chuyen tien mua hang"
code → "DH12345"
Báo tiền vào, tiền ra tức thì vào nhóm chat của đội vận hành và kế toán.
Tự ghi từng giao dịch vào bảng tính, không cần code; tự dọn dữ liệu cũ để file luôn gọn.
Hướng dẫn đồng bộ Google SheetsTạo nhiều số VA dưới một tài khoản BIDV — mỗi đơn hàng, cửa hàng hay khách hàng một số riêng. Tiền vẫn về tài khoản chính, giao dịch tự khớp theo VA.
96247100868
Lịch sử giao dịch (lọc theo ngày, loại, từ khoá, phân trang), danh sách ngân hàng và tạo ảnh QR VietQR.
Tài liệu APIĐăng nhập bằng tài khoản Tino, quản lý dịch vụ ngay trong trang khách hàng Tino.
Cách hoạt động
Từ lúc đăng nhập tới giao dịch đầu tiên, mọi thao tác đều nằm trên dashboard TinoPay.
Dùng luôn tài khoản Tino hiện có. Dịch vụ TinoPay được quản lý ngay trong trang khách hàng Tino.
Kết nối qua Open API chính thức của BIDV dành cho doanh nghiệp — không nhập mật khẩu ngân hàng.
Tạo số định danh cho từng đơn hàng, cửa hàng hoặc khách; khai báo URL webhook, token và bộ lọc.
Mỗi khoản tiền vào/ra được đẩy tới webhook, Telegram, Lark hoặc Google Sheets ngay khi ngân hàng ghi nhận.
Dành cho Dev
Payload JSON gọn, đủ trường để khớp đơn: số tiền, mã thanh toán đã tách sẵn và VA nhận tiền.
{
"transaction_id": "20251020083338000006",
"gateway": "BIDV",
"transactionDate": "2026-10-20 08:33:38",
"accountNumber": "96247100868",
"code": "DH12345",
"content": "DH12345 chuyen tien mua hang",
"transferType": "in",
"transferAmount": 150000,
"referenceCode": "0551dTCO-82LiomOss",
"virtualAccount": "9624QA01"
}
<?php
// webhook.php — xác thực request từ TinoPay
$expected = (string) getenv('ALLPAY_WEBHOOK_TOKEN');
$auth = $_SERVER['HTTP_AUTHORIZATION'] ?? '';
$token = $_SERVER['HTTP_ALLPAY_TOKEN']
?? preg_replace('/^Apikey\s+/i', '', $auth);
if ($expected === '' || !hash_equals($expected, (string) $token)) {
http_response_code(401);
exit;
}
$tx = json_decode(file_get_contents('php://input'), true);
// Idempotent: transaction_id đã xử lý thì bỏ qua
// Việc nặng (cập nhật đơn theo $tx['code']) đẩy vào queue
if (!already_processed($tx['transaction_id'])) {
queue_payment($tx);
}
// Trả 200 thật nhanh
http_response_code(200);
header('Content-Type: application/json');
echo json_encode(['success' => true]);
import express from 'express';
import { timingSafeEqual } from 'node:crypto';
const app = express();
app.use(express.json());
const safeEqual = (a = '', b = '') => {
const x = Buffer.from(a), y = Buffer.from(b);
return x.length === y.length && timingSafeEqual(x, y);
};
app.post('/webhooks/allpay', (req, res) => {
const token = req.get('ALLPAY-TOKEN')
?? (req.get('Authorization') ?? '').replace(/^Apikey\s+/i, '');
if (!safeEqual(token, process.env.ALLPAY_WEBHOOK_TOKEN)) {
return res.sendStatus(401);
}
// Trả 200 ngay, xử lý bất đồng bộ & idempotent theo transaction_id
res.status(200).json({ success: true });
queue.add('allpay-transaction', req.body);
});
app.listen(3000);
# Lịch sử giao dịch: lọc theo ngày, loại, từ khoá, có phân trang
curl -G "https://ote.allpay.vn/api/transactions" \
-H "Authorization: Bearer $ALLPAY_API_TOKEN" \
-H "Accept: application/json" \
-d transaction_date_from=2026-10-01 \
-d transaction_date_to=2026-10-20 \
-d type=in \
-d q=DH12345 \
-d per_page=20
Endpoint chạy HTTPS
Token và dữ liệu giao dịch luôn được mã hoá trên đường truyền.
Idempotent theo transaction_id
Một giao dịch có thể được gửi lại — lưu ID đã xử lý để không cộng tiền hai lần.
Trả 200 nhanh, retry lo phần còn lại
Phản hồi ngay rồi xử lý trong queue. Nếu lỗi, TinoPay tự gửi lại sau 5 phút.
Đối chiếu log
Xem log từng lần gọi webhook trên dashboard và bấm gọi lại khi cần.
Ứng dụng
Website TMĐT
Khách chuyển khoản kèm mã đơn, TinoPay tách code và gọi webhook để đơn chuyển sang “Đã thanh toán”.
Hosting / SaaS
Mỗi hoá đơn một mã thanh toán; webhook kích hoạt hoặc gia hạn dịch vụ ngay khi tiền về, không chờ duyệt tay.
Chuỗi cửa hàng
Cấp VA riêng cho từng chi nhánh dưới cùng tài khoản BIDV, lọc webhook theo VA để biết tiền về điểm nào.
Kế toán
Mọi giao dịch tự ghi vào bảng tính; kế toán lọc, cộng tổng và đối chiếu mà không cần lập trình.
Bảo mật
Dữ liệu đi qua Open API do BIDV cung cấp cho doanh nghiệp — không đọc SMS, không đăng nhập hộ internet banking.
Kết nối qua Open API chính thức của BIDV, bạn không phải chia sẻ hay nhập mật khẩu internet banking cho TinoPay.
Mỗi request mang header ALLPAY-TOKEN hoặc Authorization: Apikey để endpoint xác minh đúng nguồn gửi.
Dashboard, REST API và webhook tới URL HTTPS của bạn đều được mã hoá trên đường truyền.
Từng lần gọi webhook đều được ghi lại cùng phản hồi của server, giúp truy vết và gọi lại khi cần.
Không. TinoPay kết nối qua Open API chính thức của BIDV dành cho doanh nghiệp, nên bạn không phải chia sẻ hay nhập mật khẩu internet banking.
Hiện TinoPay kết nối trực tiếp với BIDV (tài khoản doanh nghiệp). Ngân hàng mới sẽ được cập nhật tại trang này khi chính thức hỗ trợ.
TinoPay tự gửi lại sau 5 phút. Bạn xem được log từng lần gọi và bấm gọi lại thủ công trên dashboard. Nên xử lý idempotent theo transaction_id để tránh ghi nhận trùng.
VA là số tài khoản phụ tạo dưới tài khoản BIDV của bạn. Tiền chuyển vào VA vẫn về tài khoản chính, nhưng mỗi giao dịch có trường virtualAccount để biết thuộc đơn hàng, cửa hàng hay khách nào.
Có. Bạn tra cứu lịch sử giao dịch (lọc theo ngày, loại, từ khoá, phân trang), lấy danh sách ngân hàng và tạo ảnh QR VietQR. Xem API giao dịch và API VietQR.
Đăng nhập bằng tài khoản Tino, chọn gói và quản lý dịch vụ ngay trong trang khách hàng Tino. Sau đó liên kết tài khoản BIDV, tạo VA và cấu hình webhook trên dashboard TinoPay.
Đăng nhập bằng tài khoản Tino, liên kết BIDV và nhận webhook giao dịch đầu tiên chỉ sau vài bước cấu hình.