Bỏ qua để đến nội dung
Tài liệu

Sandbox và khoá dt_test_

~2 phút đọc

Sandbox cho phép bạn thử phần tích hợp mà không chạm vào tài khoản ngân hàng thật. Khoá có tiền tố dt_test_ chỉ thấy dữ liệu sandbox; khoá dt_live_ chỉ thấy dữ liệu thật.

Sandbox khác gì dữ liệu thật

Phần tiêu đề “Sandbox khác gì dữ liệu thật”
  • Sự kiện sandbox được đánh dấu riêng và đi qua cùng đường xử lý như sự kiện thật, nên webhook, bộ lọc và tích hợp của bạn chạy đúng như khi hoạt động.
  • Giao dịch và sự kiện sandbox không tính vào hạn mức và không xuất hiện trong báo cáo, đối soát hay chứng từ kế toán của dữ liệu thật.
  • Dữ liệu mẫu hoàn toàn giả: không có tài khoản, mã số thuế hay tên người thật.

Tạo khoá thử

Phần tiêu đề “Tạo khoá thử”

  1. Mở Nhà phát triển rồi chọn tab API keys.

  2. Tạo khoá mới, chọn môi trường thử để nhận khoá bắt đầu bằng dt_test_. Người tạo khoá cần vai trò Chủ sở hữu, Quản trị hoặc Nhà phát triển, và phải xác thực lại bằng passkey hoặc TOTP.

  3. Sao chép khoá ngay vì chỉ hiện đầy đủ một lần; sau đó giao diện chỉ còn bốn số cuối. Lưu khoá vào biến môi trường DT_API_KEY, không dán vào mã nguồn.

  4. Gọi thử GET /v1/me bằng khoá này; phản hồi có trường mode cho biết bạn đang ở sandbox. Ví dụ đầy đủ bằng curl, dtp, SDK và MCP nằm ở quickstart.

Phát giao dịch giả lập

Phần tiêu đề “Phát giao dịch giả lập”

Công cụ dòng lệnh dtp tạo sự kiện sandbox và đưa nó qua đường xử lý thật tới endpoint của bạn:

Terminal window
dtp trigger transaction.confirmed --amount 250000

Để nhận sự kiện về máy đang phát triển, dùng dtp listen; mặc định lệnh này chỉ nhận sự kiện sandbox và ký bằng một secret whsec_… mới cho mỗi phiên, hiện khi khởi động cùng dòng "Chế độ SANDBOX":

Terminal window
dtp listen --forward-to localhost:3000/hook --events "transaction.*"

Nhận webhook bằng chuẩn Standard Webhooks (các header webhook-id, webhook-timestamp, webhook-signature); cách kiểm tra chữ ký ở webhook. Danh sách lệnh đầy đủ ở CLI.

Giới hạn của sandbox

Phần tiêu đề “Giới hạn của sandbox”
  • Sandbox không có dữ liệu ngân hàng thật: để thử kênh Android, email hay sao kê bạn dùng chính tài khoản của mình theo thiết lập 10 phút và dùng Gửi thử ở từng kênh.
  • Khi đưa tích hợp vào chạy thật, bạn đổi sang khoá dt_live_ và endpoint thật; khoá dt_live_ có thể giới hạn theo công ty, tài khoản và dải IP, xem xác thực.