Webhook không tới được handler thì đơn hàng không được cập nhật. Để đối soát giao dịch bằng SePay CLI, sepay transaction list --webhook-success 0 liệt kê các giao dịch đó để bạn đối chiếu với dữ liệu hệ thống của mình.
CLI hợp cho tra cứu thủ công và script chạy trên máy bạn. Ứng dụng cần tự đối soát trên production thì gọi API danh sách giao dịch, xem Đối soát giao dịch qua API.
transaction list và transaction get chạy trên cả sandbox và production, chỉ đọc dữ liệu. Bạn cần đăng nhập. Production còn cần scope read (Môi trường).
transaction list
Liệt kê giao dịch, lọc theo ngày, loại, tài khoản hoặc trạng thái webhook.
Tham số
| Flag | Kiểu | Mô tả |
|---|---|---|
--from | string | Từ thời điểm này. YYYY-MM-DD, YYYY-MM-DD HH:MM:SS hoặc RFC3339, tính theo giờ Việt Nam |
--to | string | Đến thời điểm này, cùng định dạng. Chỉ ghi ngày thì lấy trọn ngày đó: --to 2026-09-22 gồm cả giao dịch lúc 23:59 |
--transfer-type | string | in | out |
--webhook-success | string | 0: webhook chưa gửi thành công; 1: đã thành công |
--bank-account | string | Xid tài khoản ngân hàng |
--va-xid | string | Xid VA |
--reference-number | string | Mã tham chiếu, khớp chính xác |
--search | string | Tìm theo mã tham chiếu, nội dung hoặc mã thanh toán |
--transaction-date-sort | string | asc | desc. Mặc định mới nhất trước |
--since-id | string | Chỉ giao dịch sau xid này; đi kèm --transaction-date-sort asc |
--page, --per-page | int | Phân trang; mặc định 20 dòng, tối đa 100 |
--fields | string | Các trường trả về, cách nhau bằng dấu phẩy |
Các flag khác (khoảng số tiền, --bank, --transaction-content) xem bằng sepay transaction list --help.
Khoảng lọc ngược thì lệnh dừng ngay với exit code 2, chưa gửi gì lên SePay. Ví dụ ngày bắt đầu sau ngày kết thúc:
$ sepay transaction list --from 2026-10-02 --to 2026-10-01Error: --from must not be after --toRun 'sepay transaction list --help' for usage.Số tiền tối thiểu lớn hơn tối đa cũng vậy:
$ sepay transaction list --amount-in-min 500000 --amount-in-max 100000Error: --amount-in-min must not be greater than --amount-in-maxRun 'sepay transaction list --help' for usage.Ví dụ
$ sepay transaction list --webhook-success 0 --from 2026-09-22ID DATE AMOUNT CONTENT CODE BANK WHb7d30f15-xxxx-xxxx-xxxx-fa163e2f7c98 2026-09-22 15:40:12 +120.000 DH1712 thanh toan don hang DH1712 ACB failpage 1/1 · 1 of 1| Cột | Mô tả |
|---|---|
ID | xid của giao dịch |
AMOUNT | + tiền vào, - tiền ra |
CODE | Mã thanh toán SePay đọc được từ nội dung chuyển khoản |
WH | Kết quả gửi webhook: ok đã gửi thành công, fail chưa gửi thành công hoặc không có webhook nào áp dụng cho tài khoản, - không có dữ liệu |
Ghi chú
failkhông phân biệt webhook gửi lỗi với tài khoản chưa có webhook, nên--webhook-success 0liệt kê cả giao dịch của tài khoản không có webhook nào áp dụng.WHphản ánh phản hồi của endpoint, không phản ánh việc hệ thống đã ghi nhận đơn: handler có thể trả thành công mà chưa xử lý được (ví dụ do lỗi code).- Với
--json, kết quả là một mảng; mỗi phần tử là một giao dịch (id,transaction_date,transfer_type,amount_in,amount_out,reference_number,code,webhook_success). Mảng không kèm thông tin phân trang. Khi còn trang sau,stderrin thêm một dòng kết thúc bằngmore rows remain; page through with --page/--per-page; script lặp--pagetới khi số dòng nhận về ít hơn--per-page. --since-idvới thứ tự mặc định (mới nhất trước) bỏ sót giao dịch, nên đi kèm--transaction-date-sort asc.
transaction get
Xem một giao dịch. Đối số là xid: cột ID, trường id trong kết quả --json, hoặc txn= của sepay webhook listen.
$ sepay transaction get 3c9a6e41-xxxx-xxxx-xxxx-a6006ab65acaFIELD VALUEID 3c9a6e41-xxxx-xxxx-xxxx-a6006ab65acaDate 2026-09-22 15:40:12Amount +150.000Accumulated 1.150.000Content DH00012 thanh toan don hangReference FT26092212345Code DH00012Bank ACBAccount 123456789VA -Webhook failTrường id trong payload webhook là số nguyên, không phải xid, nên transaction get không nhận. Muốn tìm giao dịch từ dữ liệu webhook, tra theo mã tham chiếu của ngân hàng: referenceCode trong payload webhook, reference_number trong kết quả --json và giá trị của --reference-number là cùng một mã.
$ sepay transaction list --reference-number FT26092212345