Nếu bạn muốn đưa dữ liệu giao dịch vào hệ thống của mình, Dòng Tiền Pro có ba đường: REST API, dòng lệnh dtp và máy chủ MCP cho trợ lý AI.
Gọi API đầu tiên
Dùng khoá thử nghiệm bắt đầu bằng dt_test_ trên môi trường sandbox. Đặt khoá vào biến môi trường, không dán vào mã nguồn.
export DT_API_KEY="dt_test_…"
curl "https://api.dongtien.pro/v1/transactions?status=confirmed&limit=20" \
-H "Authorization: Bearer $DT_API_KEY"
Các điểm cuối dùng trong ví dụ: GET /v1/transactions, GET /v1/transactions/{id} và GET /v1/bank-accounts. Danh sách đầy đủ nằm trong OpenAPI công khai.
Dòng lệnh dtp
dtp login
dtp tx list --since 2026-10-01
dtp listen --forward-to http://localhost:3000/webhooks
dtp listen nhận sự kiện và chuyển tới máy của bạn khi đang phát triển.
MCP
Máy chủ MCP có địa chỉ 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 nằm trong chế độ bạn đã chọn.
Webhook
Webhook theo Standard Webhooks, với ba header webhook-id, webhook-timestamp và webhook-signature. Bạn xem được nhật ký giao hàng và gửi lại từng sự kiện.
SDK
Có hai SDK chính thức: TypeScript (@dongtien/sdk) và Python (dongtien). Với ngôn ngữ khác, bạn dùng OpenAPI công khai để tự sinh client.
Tính năng không làm
- Khoá API chỉ cấp quyền theo phạm vi bạn chọn; khoá thử nghiệm không chạm dữ liệu thật.
- Không có SDK cho các ngôn ngữ ngoài hai ngôn ngữ trên.
Tài liệu đầy đủ ở docs.dongtien.pro.
Câu hỏi thường gặp
Tôi dùng khoá nào để thử?
Khoá dt_test_ trên sandbox. Khoá này không đọc được dữ liệu thật.
Webhook bị 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?
Giá theo quy tắc đếm giao dịch chung, nêu trên bảng giá.