Giao dịch trong SePay CLI

Tra cứu giao dịch bằng SePay CLI, tìm giao dịch có webhook chưa gửi thành công để đối soát với hệ thống của bạn và xem chi tiết từng giao dịch.

||

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ố

FlagKiểuMô tả
--fromstringTừ 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
--tostringĐế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-typestringin | out
--webhook-successstring0: webhook chưa gửi thành công; 1: đã thành công
--bank-accountstringXid tài khoản ngân hàng
--va-xidstringXid VA
--reference-numberstringMã tham chiếu, khớp chính xác
--searchstringTìm theo mã tham chiếu, nội dung hoặc mã thanh toán
--transaction-date-sortstringasc | desc. Mặc định mới nhất trước
--since-idstringChỉ giao dịch sau xid này; đi kèm --transaction-date-sort asc
--page, --per-pageintPhân trang; mặc định 20 dòng, tối đa 100
--fieldsstringCá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ộtMô tả
IDxid của giao dịch
AMOUNT+ tiền vào, - tiền ra
CODEMã thanh toán SePay đọc được từ nội dung chuyển khoản
WHKế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ú

  • fail không phân biệt webhook gửi lỗi với tài khoản chưa có webhook, nên --webhook-success 0 liệt kê cả giao dịch của tài khoản không có webhook nào áp dụng.
  • WH phả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, stderr in thêm một dòng kết thúc bằng more rows remain; page through with --page/--per-page; script lặp --page tới khi số dòng nhận về ít hơn --per-page.
  • --since-id vớ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      fail

Trườ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