Tổng quan SePay CLI

Thử tích hợp SePay ngay trên máy: SePay CLI đưa webhook về localhost mà không cần URL công khai, và giả lập giao dịch trên sandbox để kiểm tra code.

||

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:

Terminal 1: nhận webhook
$ 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
Terminal 2: giả lập giao dịch
$ sepay sandbox simulate payment_in --bank-account 832529c1-xxxx-xxxx-xxxx-fa163e2f7c98 --amount 50000 --code DH1709env: sandboxSimulated payment_in event.a41c9e02-xxxx-xxxx-xxxx-fa163e2f7c98

Terminal 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àmNhóm lệnhMôi trườngTài liệu
Tạo dữ liệu, giả lập giao dịchsandboxSandboxSandbox
Nhận webhook trên máy bạn, kiểm tra handlerwebhookSandbox & production*Webhook
Xem và đối soát giao dịchtransactionSandbox & productionGiao dịch
Mã thanh toánpaycodeSandbox & productionMã thanh toán
Tài khoản ảo (VA)vaSandbox & production*Tài khoản ảo (VA)
Cổng thanh toánpgSandbox & production**Cổng thanh toán
Hóa đơn điện tửeinvoiceSandbox & production**Hóa đơn điện tử
Bank HubbankhubSandboxBank 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.

Cảnh báo

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.