Thử SePay CLI bằng hai terminal. Terminal 1 nhận webhook sandbox và chuyển tới handler ở localhost:3000. Terminal 2 giả lập một giao dịch tiền vào 50.000 đ có mã đơn DH1709:
$ sepay webhook listen --forward localhost:3000env: sandbox Delivering for every bank account of this company.✓ Listening for sandbox events → http://localhost:3000/ (Ctrl+C to stop · retries+enter to manage)14:22:07 payment_in → http://localhost:3000/ 200 12ms txn=a41c9e02-xxxx-xxxx-xxxx-fa163e2f7c98 wh=5f0e2a7b-xxxx-xxxx-xxxx-3c9d81e04b6a$ sepay sandbox simulate payment_in --bank-account 832529c1-xxxx-xxxx-xxxx-fa163e2f7c98 --amount 50000 --code DH1709env: sandboxSimulated payment_in event.a41c9e02-xxxx-xxxx-xxxx-fa163e2f7c98Terminal 1 in một dòng cho webhook vừa gửi: 200 là HTTP status handler trả về, txn= là xid của giao dịch vừa tạo.
Lệnh theo việc cần làm
| Việc cần làm | Nhóm lệnh | Môi trường | Tài liệu |
|---|---|---|---|
| Tạo dữ liệu, giả lập giao dịch | sandbox | Sandbox | Sandbox |
| Nhận webhook trên máy bạn, kiểm tra handler | webhook | Sandbox & production* | Webhook |
| Xem và đối soát giao dịch | transaction | Sandbox & production | Giao dịch |
| Mã thanh toán | paycode | Sandbox & production | Mã thanh toán |
| Tài khoản ảo (VA) | va | Sandbox & production* | Tài khoản ảo (VA) |
| Cổng thanh toán | pg | Sandbox & production** | Cổng thanh toán |
| Hóa đơn điện tử | einvoice | Sandbox & production** | Hóa đơn điện tử |
| Bank Hub | bankhub | Sandbox | Bank Hub |
* Một số lệnh chỉ chạy trên sandbox, xem Môi trường.
** Trên production chỉ có lệnh xem: pg order list, pg order get, einvoice invoice list, einvoice invoice get. Các lệnh còn lại của hai nhóm chỉ chạy trên sandbox.
Sandbox và production
Mặc định lệnh chạy trên sandbox, với dữ liệu Test mode (chế độ thử nghiệm) và không có tiền thật. Thêm --env production để làm việc với giao dịch thật. Trên production, token cần đủ scope cho lệnh.
Mọi lệnh sửa dữ liệu trên production chỉ chạy khi bạn tự xác nhận trên terminal của mình. AI không tự xác nhận thay bạn: gặp lệnh này, AI đưa lệnh để bạn tự chạy. Lệnh có hiệu lực ngay sau khi bạn xác nhận; một số lệnh không hoàn tác được (luật xác nhận). Thêm --dry-run để xem trước lệnh sẽ gửi gì (Chạy thử).
Bắt đầu dùng SePay CLI
Bạn cần một tài khoản my.sepay.vn, và công ty đã bật Test mode (xem Test mode). Cài CLI, rồi làm theo Bắt đầu nhanh để đăng nhập bằng sepay login và nhận webhook đầu tiên trên máy của bạn.