Nếu sản phẩm của bạn cần biết "khoản tiền này đã về chưa", Dòng Tiền Pro cho bạn một nguồn giao dịch ngân hàng có trạng thái rõ ràng qua REST API, webhook theo Standard Webhooks, dòng lệnh dtp và máy chủ MCP cho trợ lý AI. Bạn bắt đầu trên sandbox với khoá dt_test_…, không chạm dữ liệu thật.
Bài toán khi tự đọc biến động số dư
Tự viết trình đọc SMS hay email ngân hàng nghe đơn giản, nhưng nhanh chóng phát sinh việc: mỗi ngân hàng một mẫu tin, mẫu tin đổi không báo trước, cùng một khoản tiền đến từ hai kênh, và tin giả mạo từ số điện thoại thường. Dòng Tiền Pro làm phần đó và trả về giao dịch đã chuẩn hoá.
Bạn nhận được gì
Giao dịch có trạng thái
Mỗi giao dịch có trạng thái tạm tính, đã xác thực hoặc cách ly. Hệ thống nối sau, ví dụ hệ thống giao hàng của bạn, nên chỉ hành động trên giao dịch đã xác thực. Cùng một giao dịch đến từ nhiều kênh được gộp thành một dòng.
“Đã xác thực”: xác thực nguồn, không phải ngân hàng xác nhận quyết toán.
REST API
API có OpenAPI công khai, phân trang theo cursor. Ví dụ đọc giao dịch đã xác thực:
export DT_API_KEY="dt_test_…"
curl "https://api.dongtien.pro/v1/transactions?status=confirmed&limit=20" \
-H "Authorization: Bearer $DT_API_KEY"
Webhook theo Standard Webhooks
Sự kiện được gửi với ba header webhook-id, webhook-timestamp và webhook-signature, nên mọi thư viện kiểm chữ ký Standard Webhooks đều dùng được. Bạn xem nhật ký giao hàng và gửi lại từng sự kiện. Dùng webhook-id để xử lý mỗi sự kiện đúng một lần.
Dòng lệnh dtp
dtp login
dtp tx list --since 2026-10-01
dtp listen --forward-to http://localhost:3000/webhooks
dtp listen chuyển sự kiện tới máy của bạn khi đang phát triển.
MCP cho trợ lý AI
Máy chủ MCP ở https://mcp.dongtien.pro/mcp. Khi cấp quyền, bạn chọn chế độ truy cập trong màn đồng ý; trợ lý AI chỉ làm được những việc trong chế độ đó.
SDK
Có hai SDK chính thức: TypeScript (@dongtien/sdk) và Python (dongtien). Với ngôn ngữ khác, bạn sinh client từ OpenAPI công khai.
Tích hợp trong một buổi chiều
- Tạo khoá thử nghiệm
dt_test_…và đặt vào biến môi trường. - Gọi
GET /v1/transactionstrên sandbox để xem dữ liệu mẫu. - Tạo endpoint webhook và kiểm chữ ký theo Standard Webhooks.
- Chạy
dtp listenđể nhận sự kiện thử trên máy của bạn. - Chuyển sang khoá thật khi luồng xử lý đã ổn định.
Điều API không làm
- Không có API chuyển tiền hay chi hộ; Dòng Tiền Pro chỉ đọc biến động số dư.
- Khoá thử nghiệm không đọc được dữ liệu thật.
- Không có SDK cho ngôn ngữ ngoài TypeScript và Python.
Câu hỏi thường gặp
Tôi nên dùng webhook hay gọi API định kỳ?
Dùng webhook để nhận sự kiện ngay, và gọi API để đồng bộ lại khi máy chủ của bạn ngừng một thời gian. Hai cách dùng chung một mã giao dịch nên không tạo bản ghi trùng.
Webhook gửi lỗi thì sao?
Bạn mở nhật ký giao hàng, xem phản hồi từ máy chủ của bạn và gửi lại sự kiện.
Giá của API là bao nhiêu?
API dùng chung quy tắc đếm giao dịch đã xác thực, nêu ở bảng giá. Tài liệu đầy đủ ở docs.dongtien.pro.
