Môi trường sandbox
Sandbox để thử tích hợp. Hoá đơn không gửi cơ quan thuế. Live chỉ gọi được sau khi được duyệt.
Giới thiệu
Ứng dụng mới luôn ở Sandbox. Dùng Sandbox để lấy token, tạo mẫu, tạo hoá đơn và nhận webhook. Hoá đơn sandbox không được gửi cơ quan thuế.
Nút Thử API trên tài liệu chỉ gọi Sandbox. Gọi Live bằng client hoặc cURL với key Live.
Hai môi trường
Chọn host theo key đang giữ. Gửi key sandbox tới host Live, hoặc key Live tới host Sandbox, API trả 403.
| Môi trường | Host | Tiền tố API key |
|---|---|---|
| Sandbox | https://sandbox.api.hddt.dev | hddt_test_ |
| Live | https://api.hddt.dev | hddt_live_ |
Dữ liệu tách riêng
Sandbox và Live là hai sổ riêng: API key, hạn mức, hoá đơn và webhook. Key sandbox không đọc được hoá đơn hay webhook Live. Thêm webhook bằng key hddt_test_ và App ID của ứng dụng thì URL đó chỉ nhận sự kiện sandbox.
App ID dùng chung cho cả hai môi trường. Token thì không: token lấy trên host nào chỉ gọi lại host đó.
Hạn mức
Ứng dụng mới có 1.000 hoá đơn sandbox. Đây là tổng số được dùng, không làm mới theo tháng. Đây là sổ thử, không phải hoá đơn thật. Khi số còn lại về 0, API phát hành trả 402. Xem số đã dùng và còn lại bằng API Thông tin ứng dụng hoặc API Hạn mức hoá đơn.
Live có sổ hạn mức riêng. Hết hạn mức Live thì cần mua thêm. Sandbox không trừ vào sổ Live.
Dữ liệu mẫu
Tra cứu mã số thuế trên sandbox: 0312345678 và 0109876543 luôn trả dữ liệu mẫu. MST khác có thể không có kết quả mẫu.
Tài khoản nhà cung cấp để lấy token do đội hỗ trợ gắn với ứng dụng trên trang quản trị. Client không gửi username hay password khi gọi API Lấy token.
Chuyển sang Live
Live chưa được duyệt thì không gọi được host Live. Trên tab Tổng quan, khi ứng dụng còn Sandbox, mục Điều kiện chuyển sang Live gồm đã thử tích hợp trên sandbox và đã khai báo mã số thuế. Đủ điều kiện thì gửi yêu cầu chuyển sang Live. Đội hỗ trợ xác minh rồi bật Live.
Sau khi Live được bật, chọn Live trên đầu trang chi tiết để lấy API key hddt_live_ và Base URL https://api.hddt.dev. Vẫn có thể chọn lại Sandbox để thử. Hoá đơn Live được phát hành thật.
Đừng trộn key