Môi trường tách biệt
API endpoint, access key, database, queue, notification endpoint và giới hạn access riêng.
Documentation / Testing
Kiểm thử tích hợp trước launch
Môi trường tách biệt để kiểm tra API, access, test data, notification, lỗi, giao dịch lặp lại, report và tiêu chí sẵn sàng mà không ảnh hưởng đến production system.
Môi trường
test environment riêng
Dữ liệu
player và giao dịch
Scenario
trường hợp thành công và lỗi
Nghiệm thu
xác nhận sẵn sàng
Chu trình testing
Từ cấp access đến nghiệm thu
01
Chuẩn bị test environment
Endpoint riêng, access key, notification, IP rule và test configuration.
02
Tạo test data
Player, currency, balance, provider, method và status được định trước.
03
Chạy scenario
Kiểm tra trường hợp thành công, lỗi, lặp lại, trì hoãn và failure mode.
04
Xác nhận sẵn sàng
Log, report, tiêu chí nghiệm thu, owner và kế hoạch chuyển sang production.
Tổng quan
Test environment phải tái hiện hành vi API thực tế
Một test environment hữu ích cho phép lặp lại business scenario thực, kiểm soát kết quả, điều tra từng request và kiểm tra lỗi an toàn mà không ảnh hưởng đến production data hoặc giao dịch tài chính.
Dữ liệu có kiểm soát
Player, balance, method, provider và status có thể dự đoán để tạo scenario lặp lại.
Nghiệm thu chính thức
Scenario đã thống nhất, kết quả dự kiến, report và owner chịu trách nhiệm xác nhận sẵn sàng.
Environment và access
Tách test environment và production environment
Test và production sử dụng endpoint khác nhau, không dùng chung key, user, notification hoặc dữ liệu tài chính.
01
Cấp access key riêng
API key, OAuth client, signing secret và service account chỉ được tạo cho test environment.
02
Cấu hình test endpoint
API endpoint chính, notification endpoint và return endpoint, allowed IP và TLS setting được ghi nhận riêng.
03
Hạn chế hành động thực tế
Test environment không gửi payout thật, email, SMS, KYC request thật hoặc các giao dịch tài chính bên ngoài khác.
04
Ghi rõ các điểm khác biệt
Sự khác biệt về limit, provider, data, processing time và scenario khả dụng được mô tả rõ.
Test data
Test data và trạng thái có kiểm soát
Team biết trước input data nào tạo ra kết quả cần thiết và cách đưa environment về trạng thái ban đầu.
Test player
Profile active, blocked, unverified, self-excluded và các profile khác với status cố định.
Số dư
Số tiền khả dụng, bằng không, không đủ, bonus và reserved.
Currency và độ chính xác
Fiat và digital currency, các đơn vị amount khác nhau, rounding và tổ hợp không được hỗ trợ.
Provider
Các kết nối khả dụng, tạm tắt, lỗi và bị giới hạn theo market.
Game và sản phẩm
Chơi bằng tiền thật, demo mode, giới hạn theo quốc gia, sản phẩm bị tắt và các scenario số dư khác nhau.
Payment method
Giao dịch thành công, decline, pending, 3-D Secure, delay, refund và payout.
Xác minh khách hàng và rủi ro
Approved, pending, rejected, manual review, high risk và blocked.
Reset dữ liệu
Đưa về trạng thái ban đầu có thể lặp lại, tạo entity mới và xóa giao dịch mà không cần thao tác thủ công.
Test scenario
Test scenario bắt buộc
Kế hoạch phải kiểm tra toàn bộ business process, bao gồm network error, redelivery và state recovery, thay vì chỉ kiểm tra từng API method riêng lẻ.
Scenario thành công
Toàn bộ quy trình từ request đầu tiên đến status cuối, bản ghi tài chính và reporting.
Scenario lỗi
Dữ liệu không hợp lệ, hành động bị cấm, không đủ số dư, bị từ chối, không khả dụng và validation failure.
Retry và bảo vệ duplicate
Cùng operation ID, event ID lặp lại và trả về an toàn kết quả đã được tạo trước đó.
Delay và lỗi kết nối
Response chậm, mất kết nối, notification bị trễ và kết quả giao dịch chưa xác định.
Xử lý sai thứ tự
Event đến muộn, status cuối đến trước status trung gian và object update đã lỗi thời.
Hệ thống không khả dụng
Lỗi HTTP 5xx, bảo trì, provider không khả dụng, queue quá tải và khôi phục sau đó.
Testing phải có thể lặp lại
Cùng input data và mode đã chọn phải tạo ra cùng kết quả để team có thể kiểm tra lại bản sửa.
Log và kiểm soát
Chẩn đoán và quản lý test environment
Mỗi scenario phải có thể truy vết bằng request ID, event ID, operation ID hoặc một mã định danh ổn định khác.
Log và tracing
Request ID và correlation ID được truyền qua tất cả các hệ thống tham gia.
Thời gian, endpoint, status, error code và kết quả xử lý được ghi lại.
Có thể tìm kiếm theo player ID, payment ID, round ID, application ID hoặc event ID.
Các field nhạy cảm được che mà không làm mất thông tin hữu ích cho chẩn đoán.
Kiểm soát scenario
Có thể chọn trước kết quả thành công hoặc lỗi.
Có thể tạo delay, notification lặp lại, duplicate hoặc lỗi provider.
Có thể reset, redelivery và chạy lại scenario đã chọn.
Sự khác biệt giữa mô phỏng và test environment của provider thực được nêu rõ.
Nghiệm thu và launch
Nghiệm thu và chuyển sang launch
Tích hợp được xem là sẵn sàng sau khi API, security, business scenario, diagnostics và reporting tài chính hoặc vận hành đã được xác nhận.
API đã thống nhất
Endpoint, cấu trúc dữ liệu, status, lỗi và quy tắc versioning khớp với documentation.
Security
Access key, signature, role, IP rule và bảo vệ dữ liệu đã được kiểm tra.
Độ tin cậy
Retry, delay, notification, cancellation và recovery được xử lý an toàn.
Kiểm soát vận hành
Log, metric, error alert và diagnostics khả dụng cho các team phụ trách.
Reporting và đối soát
Giao dịch, status, balance, provider report và internal report cho kết quả nhất quán.
Xác nhận sẵn sàng
Product owner, development, testing, security và operations team đã xác nhận sẵn sàng launch.
Checklist trước launch
Production access key được cấp sau khi hoàn tất nghiệm thu và chuẩn bị kế hoạch launch có kiểm soát.
Test và production environment được tách biệt hoàn toàn theo endpoint, key, data và notification.
Đã hoàn tất các scenario thành công, lỗi, lặp lại và failure.
ID, log và kết quả xử lý khả dụng cho mọi request.
Đã xác nhận bảo vệ duplicate, delay và recovery.
Reporting, bản ghi tài chính và control total khớp nhau.
Đã thống nhất production access, monitoring, hủy giao dịch và contact support.
Cần chuẩn bị test environment?
Gửi cho chúng tôi documentation, danh sách business scenario, các environment hiện có và yêu cầu test data. APIACE sẽ giúp xác định cấu trúc validation, tiêu chí nghiệm thu và kế hoạch chuyển sang launch.