Hướng dẫn Go Live
Hãy làm theo các bước sau để chuyển đổi từ môi trường thử nghiệm sandbox sang sản xuất và bắt đầu chấp nhận thanh toán thực tế.
1. Hoàn tất kiểm thử Sandbox
Trước khi yêu cầu quyền truy cập sản xuất, hãy đảm bảo bạn đã:
- Xác thực tích hợp của mình bằng Interactive Playgrounds.
- Xử lý thành công các luồng thanh toán thành công, thất bại và bị hủy.
- Triển khai và xác minh Thuật toán Chữ ký cho cả yêu cầu và callback.
- Cấu hình
notificationUrlcủa bạn để xác nhận đúng IPN với{"returnCode":"100"}.
2. Xác minh tài khoản của bạn (KYC)
Đăng nhập vào Dashboard của người bán và đảm bảo hồ sơ doanh nghiệp của bạn đã hoàn tất:
- Tải lên các tài liệu đăng ký kinh doanh bắt buộc.
- Cung cấp chi tiết tài khoản ngân hàng để nhận thanh quyết toán.
- Hoàn tất quy trình xác minh tuân thủ.
3. Lấy API Keys Sản xuất
Sau khi tài khoản của bạn được xác minh cho môi trường sản xuất:
- Đăng nhập vào tài khoản sản xuất của bạn trong GLODIPAY Merchant Dashboard.
- Điều hướng đến PLATFORMS & APIS > API Keys trong Merchant Dashboard.
- Sao chép Merchant ID, Base Endpoint, RSA Public Key và RSA Private Key.
[!IMPORTANT] Giữ an toàn cho Khóa riêng (Private Key) Sản xuất của bạn. Tuyệt đối không đưa nó vào hệ thống quản lý phiên bản hoặc để lộ trong mã nguồn phía client.
4. Cập nhật cấu hình của bạn
Cập nhật cài đặt ứng dụng của bạn để sử dụng các giá trị sản xuất:
| Cài đặt | Giá trị Sandbox | Giá trị Sản xuất |
|---|---|---|
| Base URL | Được cung cấp trong tài liệu Sandbox | Được chỉ định trong Dashboard người bán |
| Merchant ID | ID sandbox của bạn | ID sản xuất của bạn |
| Private Key | Khóa riêng sandbox của bạn | Khóa riêng sản xuất của bạn |
| GLODIPAY Public Key | Khóa công khai sandbox của GLODIPAY | Khóa công khai sản xuất của GLODIPAY |
5. Danh sách kiểm tra bảo mật (Security Checklist)
- Xác minh chữ ký: Đảm bảo mã sản xuất của bạn kiểm tra nghiêm ngặt chữ ký của mọi IPN và callback nhận được từ GLODIPAY.
- Chỉ sử dụng HTTPS: Các URL
callbackUrl,notificationUrl,cancelUrl, vàerrorUrlbắt buộc phải sử dụng HTTPS trong môi trường sản xuất. - Whitelist địa chỉ IP: (Khuyến nghị) Giới hạn lưu lượng truy cập đến endpoint IPN của bạn chỉ từ các IP máy chủ sản xuất của GLODIPAY.
6. Thực hiện kiểm tra giao dịch thực tế nhỏ (Penny Test)
Chúng tôi khuyên bạn nên thực hiện ít nhất một giao dịch thực với số tiền nhỏ (ví dụ: $1.00) bằng thẻ tín dụng thật trong môi trường sản xuất để xác minh luồng xử lý và thanh quyết toán từ đầu đến cuối.