CLI dtp

~3 phút đọc

dtp là công cụ dòng lệnh của Dòng Tiền Pro cho người làm kỹ thuật: xem giao dịch từ terminal, thử webhook trên máy phát triển, chạy thử một bản xuất kế toán và cài máy chủ MCP vào trợ lý AI. Nó dùng cùng API công khai như SDK, và dùng chính SDK TypeScript bên trong.

Nhóm lệnh

Lệnh	Việc làm
`dtp login`, `dtp whoami`	Đăng nhập bằng trình duyệt, xem bạn đang dùng danh tính nào. Xem xác thực CLI.
`dtp tx list`, `dtp tx get`	Liệt kê giao dịch (lọc theo `--since`, `--account`, xuất `--json`) và xem một giao dịch.
`dtp listen --forward-to <url>`	Nhận sự kiện thử trên máy bạn và chuyển tiếp tới endpoint cục bộ, đã ký sẵn như webhook thật; không cần địa chỉ công khai.
`dtp trigger <sự kiện>`	Tạo một sự kiện sandbox, ví dụ `transaction.confirmed`, đi qua đường giao webhook thật.
`dtp webhooks replay`	Phát lại một sự kiện hoặc một lần giao webhook.
`dtp export run --dry-run`	Chạy thử một bản xuất kế toán, không ghi gì.
`dtp integrations list`, `test`, `logs`	Xem, thử và đọc nhật ký các tích hợp.
`dtp mcp install <client>`	Cài máy chủ MCP vào Claude Code, Cursor, Claude Desktop hoặc VS Code. Xem cài MCP.
`dtp completion`, `dtp docs`	Sinh script tự hoàn thành lệnh; mở tài liệu.

Đầu ra cho người và cho script

Dữ liệu ra stdout: bảng khi chạy trong terminal, mỗi dòng một JSON (NDJSON) khi nối qua pipe hoặc khi dùng --json.
Tiến trình và lỗi ra stderr; lỗi giữ nguyên dạng RFC 9457 của API, gồm code và request_id.
Số tài khoản trong đầu ra luôn bị che, chỉ còn bốn số cuối.
Hộp thoại tương tác chỉ xuất hiện khi chạy trong terminal; trong CI mọi lệnh chạy không cần hỏi.

Nhận webhook trên máy phát triển

dtp listen và dtp trigger dùng khoá thử (dt_test_…), nên không tính vào hạn mức. Mỗi sự kiện chuyển tiếp được ký bằng một secret whsec_… mới cho mỗi phiên, in ra khi lệnh khởi động cùng dòng chế độ (sandbox hoặc live). Secret có đúng dạng của endpoint thật (whsec_ cộng base64 chuẩn), nên thư viện standardwebhooks dùng được ngay để thử đúng đường xác minh chữ ký mà không cần endpoint công khai. Chế độ --live nhận cả sự kiện thật, cần scope webhooks:write, được ghi nhật ký kiểm toán và che dữ liệu nhạy cảm.

Mã thoát

Script nên kiểm tra mã thoát thay vì phân tích câu chữ của thông báo. Danh sách đầy đủ, kèm mã nào đáng thử lại, ở trang mã thoát; biến môi trường và tệp cấu hình ở trang cấu hình.

Tham chiếu lệnhTừng lệnh dtp: cờ, quyền cần có, ví dụ.

Cài đặtCài bằng npm và kiểm tra bản tải về.

Xác thựcĐăng nhập bằng trình duyệt, khoá API trong CI, token lưu ở đâu.