Với quan điểm công khai, minh bạch, lấy người dân, doanh nghiệp làm trung tâm phục vụ, Cổng Dịch vụ công Quốc gia kết nối, cung cấp thông tin về thủ tục hành chính và dịch vụ công trực tuyến; hỗ trợ thực hiện, giám sát, đánh giá việc giải quyết thủ tục hành chính, dịch vụ công trực tuyến và tiếp nhận, xử lý phản ánh, kiến nghị của cá nhân, tổ chức trên toàn quốc. Cá nhân, tổ chức dễ dàng truy cập Cổng Dịch vụ công Quốc gia tại địa chỉ duy nhất www.dichvucong.gov.vn theo nhu cầu người dùng từ máy tính, máy tính bảng hoặc điện thoại di động được kết nối internet để hưởng nhiều lợi ích từ Cổng Dịch vụ công Quốc gia
VĂN PHỊNG CHÍNH PHỦ TÀI LIỆU HƢỚNG DẪN KẾT NỐI, TÍCH HỢP, CHIA SẺ DỮ LIỆU VỚI CỔNG DỊCH VỤ CƠNG QUỐC GIA MỤC LỤC I Nhiệm vụ, cơng việc bộ, ngành, địa phƣơng II Hƣớng dẫn kỹ thuật Mơ hình tích hợp chia sẻ liệu Các dịch vụ chia sẻ, tích hợp 13 2.1 Các dịch vụ chia sẻ 14 2.2 Các dịch vụ tích hợp 17 Yêu cầu chi tiết liệu chia sẻ, tích hợp 19 3.1 Dịch vụ chia sẻ 22 3.2 Dịch vụ tích hợp 58 Hƣớng dẫn chi tiết việc hiệu chỉnh Cổng DVC, Hệ thống thông tin cửa điện tử BNĐP để kết nối, tích hợp, chia sẻ với Cổng DVC Quốc gia 98 4.1 Các công việc cần thực 98 4.2 Hiệu chỉnh hệ thống DVC 99 4.3 Cung cấp thông tin 101 PHỤ LỤC 103 PHỤ LỤC 104 PHỤ LỤC 104 DANH MỤC CÁC TỪ VIẾT TẮT STT VIẾT TẮT Ý NGHĨA ADAPTER_URL Địa adapter tích hợp API Giao diện lập trình ứng dụng BNĐP Bộ, ngành, địa phƣơng CSDL Cơ sở liệu Code Kiểu liệu quy định giá trị cần phải lấy từ danh mục quy định từ trƣớc DVC Dịch vụ công DVCQG Dịch vụ công quốc gia IP-PORTSERVER Thông tin IP cổng server deploy API đƣợc cung cấp sau PAKN Phản ánh, kiến nghị 10 TTHC Thủ tục hành 11 = Ký tự „=‟ đƣợc thay cho kí tự „ :‟ chuối JSON để thể trực quan dễ hiểu Chú ý lập trình sử dụng ký tự „ :‟ 12 VDXP Nền tảng tích hợp, chia sẻ liệu (Vietnam Data Exchange Platform) I Nhiệm vụ, công việc bộ, ngành, địa phƣơng Thiết lập, hồn thiện Cổng Dịch vụ cơng, Hệ thống thông tin cửa điện tử thống nhất, tập trung để tiếp nhận, giải thủ tục hành chính, cung cấp dịch vụ công trực tuyến thuộc thẩm quyền giải Bộ, ngành, địa phƣơng (gồm quan, đơn vị trực thuộc) Cổng dịch vụ công, Hệ thống thông tin cửa điện tử cấp bộ, cấp tỉnh tuân thủ chức quy định Thông tƣ 01/2018/TT-VPCP ngày 23/11/2018 Bộ trƣởng, Chủ nhiệm Văn phịng Chính phủ hƣớng dẫn thi hành số quy định Nghị định số 61/2018/NĐ-CP ngày 23/4/2018 Chính phủ thực chế cửa, cửa liên thơng giải thủ tục hành chính, Quyết định số 274/QĐTTg ngày 12/3/2019 Thủ tƣớng Chính phủ phê duyệt Đề án Cổng dịch vụ công quốc gia: + Danh mục thủ tục hành chính, dịch vụ cơng trực tuyến: đồng với CSDL quốc gia TTHC thông tin khác Tổng hợp số lƣợng thủ tục hành chính, dịch vụ cơng theo mức độ + Đăng nhập lần từ Cổng Dịch vụ công quốc gia + Xây dựng Bộ câu hỏi – trả lời mẫu + Tiếp nhận phản ánh, kiến nghị ngƣời dân, doanh nghiệp giải thủ tục hành kết nối với Hệ thống tiếp nhận, trả lời phản ánh, kiến nghị ngƣời dân, doanh nghiệp + Đánh giá việc giải thủ tục hành chính, việc giải phản ánh, kiến nghị quan nhà nƣớc + Tự động sinh mã hồ sơ theo quy định Điều 19 + Cung cấp tình trạng giải thủ tục hành cho Cổng Dịch vụ cơng quốc gia Thời hạn hồn thành: Q IV năm 2019 Chủ trì, phối hợp với Văn phịng Chính phủ triển khai biện pháp kỹ thuật để kết nối, chia sẻ liệu Cổng thông tin cửa quốc gia, Cổng Dịch vụ công Hệ thống thông tin cửa Bộ, ngành, địa phƣơng với Cổng Dịch vụ công quốc gia Quý III năm 2020 Chuẩn hóa, hồn thiện triển khai tích hợp dịch vụ công trực tuyến mức độ 3, theo danh sách năm 2019 thực hàng năm theo danh mục đƣợc Thủ tƣớng Chính phủ phê duyệt Danh sách thủ tục hành ƣu tiên kết nối theo Quyết định số 274/QĐ-TTg ngày 12/3/2019 gồm: (1) Tích hợp dịch vụ cơng trực tuyến mức độ 3, có đối tƣợng thực hiện, số lƣợng hồ sơ lớn, liên quan tới cá nhân, tổ chức, gồm: - Dịch vụ công Bảo hiểm xã hội: Đăng ký, điều chỉnh đóng Bảo hiểm xã hội bắt buộc, Bảo hiểm y tế, Bảo hiểm thất nghiệp, Bảo hiểm tai nạn lao động - Bệnh nghề nghiệp; cấp sổ Bảo hiểm xã hội, thẻ Bảo hiểm y tế - Dịch vụ cơng Tài (Lĩnh vực thuế, hải quan): Kê khai hóa đơn qua mạng; Khai thuế qua mạng - Dịch vụ công Kế hoạch đầu tƣ: Đăng ký doanh nghiệp - Dịch vụ công Giao thơng vận tải: + Nhóm dịch vụ cơng lĩnh vực vận tải đƣờng bộ: nƣớc; quốc tế; + Dịch vụ Đổi Giấy phép lái xe; cấp giấy phép lái xe quốc tế; - Dịch vụ công Y tế: + Nhóm dịch vụ An tồn thực phẩm; + Nhóm dịch vụ Quản lý trang thiết bị y tế - Dịch vụ công Tƣ pháp: Nhóm dịch vụ cơng lĩnh vực hộ tịch - Dịch vụ cơng Cơng Thƣơng: Nhóm dịch vụ cơng cấp giấy chứng nhận xuất xứ hàng hóa; dịch vụ xác nhận khai báo hóa chất nhập - Dịch vụ công Tài nguyên môi trƣờng: Đăng ký biến động quyền sử dụng đất quyền sở hữu tài sản gắn liền với đất - Nhóm dịch vụ cơng số tổ chức cung ứng dịch vụ công cung cấp: cấp điện; cấp nƣớc (2) Lựa chọn Bộ, ngành, địa phƣơng số tổ chức cung ứng dịch vụ cơng thực tích hợp cung cấp dịch vụ công trực tuyến Cổng dịch vụ công quốc gia theo nội dung Đề án, gồm: - Tất Bộ, quan ngang Bộ - 03 quan: Bảo hiểm xã hội Việt Nam, Ngân hàng Chính sách xã hội, Ngân hàng Phát triển Việt Nam - 03 tỉnh, thành phố trực thuộc Trung ƣơng: Hà Nội, Quảng Ninh, Thành phố Hồ Chí Minh năm 2019 triển khai toàn quốc năm 2020 - Các cơng ty, Tổng cơng ty: Tập Đồn điện lực Việt Nam; Công ty nƣớc Hà Nội; Tổng công ty cấp nƣớc Sài Gòn Hiệu chỉnh Cổng dịch vụ công, Hệ thống thông tin cửa điện tử cấp bộ, cấp tỉnh để sử dụng chung Hệ thống xác thực Cổng Dịch vụ công quốc gia Thời hạn hoàn thành: Quý II năm 2020 Hạn chế thiết lập tính năng, hệ thống xác thực với Cổng dịch vụ công, Hệ thống thông tin cửa cấp Bộ, cấp tỉnh, trừ trƣờng hợp kết nối với Hệ thống xác thực Cổng dịch vụ công quốc gia Xây dựng Bộ câu hỏi/trả lời vấn đề thƣờng gặp trình giải thủ tục hành cơng khai Cổng Dịch vụ công Bộ, ngành, địa phƣơng tích hợp Cổng Dịch vụ cơng quốc gia Quý IV năm 2019 Bộ câu hỏi/trả lời Bộ, ngành gồm tối thiểu 500 câu hỏi/trả lời Tiếp nhận trả lời ý kiến Hệ thống thông tin tiếp nhận, xử lý phản ánh, kiến nghị cá nhân, tổ chức đăng tải công khai Cổng Dịch vụ công quốc gia II Hƣớng dẫn kỹ thuật Mơ hình tích hợp chia sẻ liệu Hình 1: Mơ hình tích hợp, chia sẻ liệu Để kết nối, chia sẻ, tích hợp liệu Cổng dịch vụ công, Hệ thống thông tin cửa điện tử cấp bộ, cấp tỉnh qua Nền tảng tích hợp, chia sẻ liệu (VDXP) đƣợc phát triển từ Trục liên thông văn quốc gia, bộ, ngành, địa phƣơng cần thực nội dung kỹ thuật bao gồm: - Nâng cấp, hoàn thiện chức Cổng dịch vụ cơng quốc gia, HTTT cửa điện tử gồm: danh mục dịch vụ công, xác thực, hồ sơ dịch vụ công, tra cứu, đánh giá kết giải thủ tục hành chính, phản ánh, kiến nghị, toán điện tử - Thiết lập, cài đặt máy chủ bảo mật kết nối (khuyến nghị sử dụng máy chủ bảo mật kết nối hệ thống gửi/nhận văn điện tử giai đoạn đầu) để kết nối với Cổng Dịch vụ công quốc gia thiết lập máy chủ bảo mật theo tài liệu hƣớng dẫn support.chinhphu.vn - Cấu hình máy chủ bảo mật kết nối với Cổng dịch vụ công quốc gia theo hƣớng dẫn Văn phịng Chính phủ - Phát triển Bộ chuyển đổi (Adapter Server - AS) dịch vụ chia sẻ, tích hợp với Cổng Dịch vụ cơng quốc gia theo thƣ viện lập trình mẫu hƣớng dẫn Văn phịng Chính phủ Tn thủ kỹ thuật định dạng liệu gói tin để phục vụ kết nối, tích hợp, chia sẻ thơng tin lẫn với Cổng DVC Quốc gia Mơ hình, hƣớng dẫn kỹ thuật việc kết nối qua Nền tảng tích hợp, chia sẻ liệu quốc gia VDXP tài liệu kèm theo Trong giai đoạn thử nghiệm, việc kết nối, tích hợp, chia sẻ liệu đƣợc thực môi trƣờng Internet, thông tin kết nối chi tiết mục II.3 Tài liệu đƣa API, BNĐP cần cung cấp theo chuẩn để tích hợp, chia sẻ với Cổng Dịch vụ công quốc gia Thông tin hƣớng dẫn kết nối MSLCD qua VDXP Để kết nối liên thông liệu Cổng DVC Quốc Gia qua VDXP, Bộ ngành, địa Phƣơng thực phƣơng án kết nối nhƣ dƣới (lựa chọn Phƣơng án ph hợp để đảm bảo tiến độ triển khai kết nối) 2.1 Trƣ ng hợp N- P chƣa tri n khai m y chủ b o mật d ng ri ng Danh s ch c c N- P đ tri n khai m y chủ d ng ri ng t i mục 2.4) C c Nội dung bƣớc ƣớc ƣớc Cài đặt hệ điều hành Unbutu 18.04.01 - File ISO: http://mirrors.nhanhoa.com/ubu ntu-releases/bionic/ubuntu18.04.3-live-server-amd64.iso Gửi văn đề nghị cấp chứng thƣ số cho máy chủ bảo mật: https://support.vpcp.vn/docume nt/chungthuso/ Ngƣ i Ngƣ i phối thực hợp VPCP BN-ĐP BN-ĐP Nguyễn Công Thành (Mobile: 098932682 6,Email: nguyencon gthanh@ch inhphu.vn) ầu mối VNPT Nguyễn Quyền Anh (Mobile: 0918572882) Nguyễn Minh Đức (Mobile: 0888541011, Email: ducnm@vnpt.vn Nguyễn Việt Trung (Mobile: ƣớc Cài đặt máy chủ bảo mật: BN-ĐP - File hƣớng dẫn: https://support.vpcp.vn/docume nt/securityserver/001_HSCD_M aychuBaoMat_SecurityServerIn stallationGuide.pdf - Video hƣớng dẫn: https://support.vpcp.vn/docume nt/taphuan/SetupSS.mp4 ƣớc Đăng ký Security Server tham gia liên thông: https://support.vpcp.vn/docume nt/securityserver/001_HSCD_M aychuBaoMat_SecurityServerIn stallationGuide.pdf Cài đặt adapter Video Hƣớng dẫn: https://support.vpcp.vn/docume nt/taphuan/SetupAdapter.mp4 ƣớc ƣớc Bƣớc ƣớc Cấu hình phân quyền SS để cung cấp dịch vụ Tài liệu hƣớng dẫn: https://support.vpcp.vn/docume nt/securityserver/ Huongdan_ADD_DV.pdf BN-ĐP mở firewall để sử dụng dịch vụ hệ thống Một cửa điện tử: Mở cổng firewall máy chủ SS để nhìn thấy cổng 5500 5577 địa 10.0.24.16 10.0.24.17 BN-ĐP mở firewall để cung cấp dịch vụ: Mở firewall để SS AS nhìn thấy dịch vụ đơn vị muốn cung cấp Public cổng 5500 5577 SS cho SS đơn vị muốn sử dụng dịch vụ Ví dụ Cổng dịch vụ Công muốn sử dụng dịch vụ 0888524498, Email: trungnv@vnpt.vn) BN-ĐP BN-ĐP BN-ĐP BN-ĐP BN-ĐP Trần Ngọc Huấn (Mobile: 0888189106, Email: huantn@vnpt.vn) Nguyễn Quyền Anh (Mobile: 0918572882) Trần Ngọc Huấn (Mobile: 0888189106, Email: huantn@vnpt.vn) Nguyễn Quyền Anh (Mobile: 0918572882) Comment [d1]: Anh Trung update link hƣớng dẫn DVC, Endpoint gửi nhận liệu DVC Comment [d2]: Anh Trung update link hƣớng dẫn DVC, Endpoint gửi nhận liệu DVC public cổng 5500 5577 cho địa 10.0.24.16 10.0.24.17 2.2 N P đ c m y chủ b o mật d ng ri ng TLTV QG ho c đ cài đ t SS d ng ri ng C c Nội dung bƣớc Ngƣ i Ngƣ i phối thực hợp VPCP ầu mối VNPT ƣớc Tải Adapter để liên thông DVC Quốc gia cần nâng cấp địa chỉ: https://support.vpcp.vn/packages/ XrdAdapter.war ƣớc Copy file XrdAdapter.war vào thƣc mục /opt/vxp/webapps máy chủ cài đặt Adapter Sau restart lại server tomcat Xem hƣớng dẫn restart server tomcat tài liệu: https://support.vpcp.vn/document /securityserver/Huongdan_XLSC _SS_BNDP.pdf ƣớc Cấu hình phân quyền SS để cung cấp dịch vụ Tài liệu hƣớng dẫn: https://support.vpcp.vn/document /securityserver/ Huongdan_ADD_DV.pdf BN-ĐP BN-ĐP BN-ĐP Nguyễn Quyền Anh (Mobile: 0918572882) Nguyễn Quyền Anh (Mobile: 0918572882) Nguyễn Minh Đức (Mobile: 0888541011, Email: ducnm@vnpt.vn Nguyễn Việt Trung (Mobile: 0888524498, Email: trungnv@vnpt.vn) Comment [d3]: Anh Trung đẩy Adapter lên link public Bƣớc ƣớc BN-ĐP mở firewall để sử dụng dịch vụ hệ thống Một cửa điện tử: Mở cổng firewall máy chủ SS để nhìn thấy cổng 5500 5577 địa 10.0.24.16 10.0.24.17 BN-ĐP mở firewall để cung cấp dịch vụ: Mở firewall để SS AS nhìn thấy dịch vụ đơn vị muốn cung cấp Public cổng 5500 5577 SS cho SS đơn vị muốn sử dụng dịch vụ Ví dụ Cổng dịch vụ Cơng muốn sử dụng dịch vụ public cổng 5500 5577 cho địa 10.0.24.16 10.0.24.17 Trần Ngọc Huấn (Mobile: 0888189106, Email: huantn@vnpt.vn) Nguyễn Quyền Anh (Mobile: 0918572882) BN-ĐP Trần Ngọc Huấn (Mobile: 0888189106, Email: huantn@vnpt.vn) Nguyễn Quyền Anh (Mobile: 0918572882) BN-ĐP Nội dung bƣớc Bƣớc BN-ĐP mở firewall để thực kết nối hệ thống Một cửa điện tử, Dịch vụ công đến Adapter d ng chung Cổng DVC Quốc gia qua ADAPTER URL http://IP-SS:8080 Để gửi nhận liệu với DVC theo tài liệu mô tả API Ngƣ i Ngƣ i phối thực hợp VPCP BN-ĐP ầu mối VNPT Trần Ngọc Huấn (Mobile: 0888189106, Email: huantn@vnpt.vn) Nguyễn Quyền Anh (Mobile: 0918572882) 2.4 Mô t m y chủ b o mật d ng chung, ri ng N P Danh sách máy chủ bảo mật d ng riêng triển khai để gửi nhận văn điện tử qua VDXP STT M định danh 000.00.00.H27 Comment [d5]: Anh Trung update link hƣớng dẫn DVC, Endpoint gửi nhận liệu DVC Comment [d6]: Anh Trung update link hƣớng dẫn DVC, Endpoint gửi nhận liệu DVC Comment [d7]: Anh Trung update link hƣớng dẫn DVC, Endpoint gửi nhận liệu DVC 2.3 N P sử dụng m y chủ b o mật d ng chung đ kết nối API DVCQG C c Comment [d4]: Anh Trung update link hƣớng dẫn DVC, Endpoint gửi nhận liệu DVC T n tỉnh Hà Tỉnh - Method: GET Input: Request Param o response_type=code : (Required) Mô tả loại ủy quyền authorization code Hoặc token implicit o client_id : (Required)định danh cho ứng dụng o redirect_uri : (Required) url callback sau ngƣời dùng chấp nhận ủy quyền thành công o scope : (Required) Danh sách quyền mà ứng dụng yêu cầu o state : (optional) ứng dụng gửi lên đoạn mã json nhƣ sau {"mã ngẫu nhiên server SP tự sinh":{ 'redirectUrl': '/protectedResource', 'expiresOn': 'thời gian mã ngẫu nhiên hết hiệu lực SP quy định'}} Note: Với grant type authorization code d ng cho trƣờng hợp web native app Implicit d ng cho trƣờng hợp ứng dụng viết client nhƣ hybrid app 9.2 Lấy access token 9.2.1 Lấy qua grant type authorization code ƣ ng dẫn: https://xacthuc.dichvucong.gov.vn/oauth2/token Method: POST Header: o Content-Type: application/x-www-form-urlencoded - Input: Query Params o grant_type=authorization_code o code : Mã authorization code o redirect_uri : o client_id: client id ứng dụng o client_secret : key bí mật ứng dụng Giá trị đƣợc gửi lên để server xác thực có xác ứng dụng hay khơng hay Phịng tránh kẻ cơng có đƣợc authorization code bƣớc trƣớc - - Output: nhƣ output mục 7.3 9.2.2 Lấy qua grant type password - ƣ ng dẫn: https://xacthuc.dichvucong.gov.vn/oauth2/token Method: POST - Header: o Content-Type: application/x-www-form-urlencoded - Input: Query Params o grant_type=password o username = xxx o password = xxx o client_id: client id ứng dụng o client_secret : key bí mật ứng dụng Giá trị đƣợc gửi lên để server xác thực có xác ứng dụng hay khơng hay Phịng tránh kẻ cơng có đƣợc authorization code bƣớc trƣớc o scope : (Required) Danh sách quyền mà ứng dụng yêu cầu - Output: nhƣ output mục 7.3 9.2.3 Grant type Client Credentials ƣ ng dẫn: https://xacthuc.dichvucong.gov.vn/oauth2/token Method: POST Header: o Content-Type: application/x-www-form-urlencoded - Input: Query Params o grant_type=client_credentials o client_id: client id ứng dụng o client_secret : key bí mật ứng dụng Giá trị đƣợc gửi lên để server xác thực có xác ứng dụng hay khơng hay Phịng tránh kẻ cơng có đƣợc authorization code bƣớc trƣớc - - Output: nhƣ output mục 7.3 9.2.4 Refresh token ƣ ng dẫn: https://xacthuc.dichvucong.gov.vn/oauth2/token Method: POST Header: o Content-Type: application/x-www-form-urlencoded - Input: Query Params o Grant_type = refresh_token o Refresh_token = xxxxx: đc trả gọi api access token - o Client_id: client id ứng dụng o Client_secret: key bí mật ứng dụng - Output: nhƣ output mục 7.3 9.3 Lấy Thông tin b n tài kho n - ƣ ng dẫn: https://xacthuc.dichvucong.gov.vn/oauth2/userinfo Method: GET Header: o Authorization: Bearer - Output: nhƣ output mục 7.4 9.4 Lấy thông tin mở rộng tài kho n ƣ ng dẫn: (dự kiến) https://dulieu.dichvucong.gov.vn/oauth2/userinfo/ext Method: GET Header: o Authorization: Bearer Input: Request param - o dp: (Required) : mã nhà cung cấp liệu M nhà cung cấp T n nhà cung cấp dvc Dịch vụ công quốc gia khdt Bộ kế hoạch đầu tƣ thue Thuế BHXH Bảo hiểm xã hội … Output: nhƣ output mục 7.5 - 9.5 Logout - ƣ ng dẫn: https://xacthuc.dichvucong.gov.vn/oidc/logout - Method: POST Header: Input: Query Params o id_token_hint: (required) id_token đƣợc trả lại identity provider o post_logout_redirect_uri: (required) redirect URL đƣợc chuyển tới logout thành công o state: (optional) - Output: redirect uri redirect 9.6 Revoke - ƣ ng dẫn: https://xacthuc.dichvucong.gov.vn/oauth2/revoke Method: POST Header: o Content-Type: application/x-www-form-urlencoded Input: Query Params o token: token muốn hủy o token_type_hint = access_token o client_id: client id ứng dụng o client_secret : key bí mật ứng dụng - Output: - 9.7 Check valid token - - ƣ ng dẫn: https://xacthuc.dichvucong.gov.vn/oauth2/introspect Method: POST Header: o Content-Type: application/x-www-form-urlencoded o Authorization: Bearer Input: Query Params o Access token: Nhận sau gọi api lấy access token Output: { "nbf": 1562922887, "scope": "openid", "active": true, "token_type": "Bearer", "exp": 1562926487, "iat": 1562922887, "client_id": "zuH9jErmeVfj9qKJurhV1_WRh8ca", "username": "admin@carbon.super" } 9.8 Lấy thông tin JWT key - ƣ ng dẫn: https://xacthuc.dichvucong.gov.vn/oauth2/jwks Method: GET 9.9 Lấy thơng tin cấu hình oauth2, OIDC - ƣ ng dẫn: https://xacthuc.dichvucong.gov.vn/oauth2/oidcdiscovery/.well -known/openid-configuration - Method: GET 9.10 Ki m tra session - ƣ ng dẫn: https://xacthuc.dichvucong.gov.vn/oidc/checksession Method: GET Input: Request Params o Client_id: client id ứng dụng PHỤ LỤC DANH MỤC TRẠNG THÁI HỒ SƠ Ghi chi tiết Sử dụng cho trƣờng hợp nộp trực tuyến, sau công dân/doanh nghiệp nộp hồ sơ thành công cổng DVC Bộ ngành, địa phƣơng Đƣợc tiếp nhận Hồ sơ đƣợc phận cửa hệ thống cổng DVC, MCĐT Bộ ngành địa phƣơng tiếp nhận để thụ lý Không đƣợc tiếp nhận Hồ sơ phận cửa từ chối tiếp nhận Đang xử lý Hồ sơ đƣợc chuyển đến phòng ban chuyên môn quan thẩm quyền thẩm định xử lý Yêu cầu bổ sung giấy tờ Hồ sơ cán yêu cầu bổ sung giấy tờ, thông tin để đủ điều kiện xử lý Yêu cầu thực nghĩa vụ tài Hồ sơ u cầu cơng dân/doanh nghiệp thực nghĩa vụ tài chính: thuế, phí, lệ phí … Cơng dân u cầu rút hồ sơ Hồ sơ sau đƣợc tiếp nhận xử lý, công dân/doanh nghiệp yêu cầu rút, hủy hồ sơ Dừng xử lý Hồ sơ cán xử lý thẩm định không đủ điều kiện dừng xử lý Đã xử lý xong Hồ sơ đƣợc xử lý xong quan chuyên môn chuyển trả lại kết xử lý cho phận cửa Đã trả kết Hồ sơ đƣợc phận cửa thực trả kết cho công dân/doanh nghiệp Mã Mới đăng ký 10 Mơ t PHỤ LỤC HƢỚNG DẪN TÍCH HỢP HỆ THỐNG THANH TOÁN TRỰC TUYẾN VÀ CÁC API SỬ DỤNG Thơng tin tích hợp API_BASE_URL MERCHANT_SERVICE_ ID SECRET KEY API_KEY Cung cấp tích hợp Cung cấp tích hợp Cung cấp tích hợp Cung cấp tích hợp Quy trình giao dịch Khách hàng truy cập website cung cấp dịch vụ để sử dụng dịch vụ chọn Thanh toán Cổng dịch vụ công, HTTT cửa điện tử, nhà cung cấp dịch vụ khác (điện, nƣớc,…) gửi yêu cầu khởi tạo tốn sang Payment Connect thơng qua API Payment Connect trả URL để website chuyển hƣớng khách hàng tới Payment Connect để tiếp tục toán Khách hàng chọn ngân hàng để toán tiến hành xác thực thông tin tài khoản ngân hàng Sau tốn xong, Payment Connect thơng báo kết giao dịch cho Website qua API, sau chuyển hƣớng khách hàng Website để thông báo kết giao dịch Hƣớng dẫn tích hợp Các API đƣợc cung cấp dƣới dạng RESTful, thực truy cập vào API đối tác cần thiết lập header Authorization với giá trị Bearer API_KEY đƣợc cấp đăng ký tài khoản đối tác Hệ thống cung cấp API sau: - API khởi tạo dịch API toán sử dụng Token Đối tác cần cung cấp API return_url để nhận kết giao dịch từ Payment Connect: - API xác nhận giao dịch (confirm) Return URL để redirect KH sau toán xong 3.1 API Khởi t o giao dịch URL: {api_base_url}/init Request method: POST Tham số đầu vào đầu object JSON với thuộc tính dƣới đây: Thuộc tính đầu vào Mandatory Name Type Length Comments /optional ACTION String 1,50 M INIT VERSION String 1,50 M 1.0.6 MERCHANT_SERVICE _ID Number 1,12 M Mã định danh đối tác MERCHANT_ORDER _ID AMOUNT String 1,255 M Mã giao dịch phía đối tác String 1,50 M Số tiền tốn PAY: Thanh tốn thơng thƣờng không trả Token PAYMENT_ACTION String 1,50 M CREATE_TOKEN: Tạo Token TOKEN: Thanh tốn có trả Token Kênh toán CHANNEL_ID String 0,255 M 1: WebApp - 2: MobileApp Number 0,12 M Mã thiết bị, mặc định truyền String 1,10 M Ngôn ngữ: vi-VN/en-US; mặc định vi-VN CURRENCY_CODE String 1,50 M Đơn vị tiền tệ VND USD PAYMENT_METHO D DESCRIPTION String 1,50 M Phƣơng thức tốn String 1,255 M Mơ tả giao dịch String 1,255 M Phƣơng thức xác thực: ATM/tài khoản/CIF ADDITIONAL_INFO String 1,4000 M Thông tin thêm CUSTOMER_INFO String 1,4000 M Thông tin KH DEVICE LOCALE AUTHEN_TYPE Thời gian giao dịch, định dạng CREATE_DATE String 1,50 M yyyyMMddHHmmss CLIENT_IP String 1,50 M IP khách hàng SECURE_CODE String 1,255 M Chuỗi mã hóa tin Thuộc tính đầu Name Type Length Mandatory /optional Comments RESPONSE_CO DE DESCRIPTION String 1,10 M Mã lỗi String 1,255 M Mô tả lỗi REDIRECT_UR L SECURE_CODE String 1,255 M URL để chuyển hƣớng khách hàng String 1,255 M Chuỗi mã hóa tin Các thơng tin chi tiết trƣờng ADDITIONAL_INFO: Tham số Ki u Mô t Required TenNguoiNop String Họ tên ngƣời nộp Required TKThuHuong String Tài khoản ngân hàng thụ hƣởng Required MaNHThuHuong String Mã ngân hàng thụ hƣởng Required TenTKThuHuong String Tên chủ tài khoản ngân hàng thụ hƣởng Required MSTNguoiNop String Mã số thuế ngƣời nộp Required DiaChiNguoiNop String Địa ngƣời nộp bao gồm Required tỉnh/thành phố, quận huyện, làng xã đƣờng đặt cách “|” DiaChiNguoiNopThay String TenNguoiNopThay String Địa ngƣời nộp bao gồm tỉnh/thành phố, quận huyện, làng xã đƣờng đặt cách “|” Họ tên ngƣời nộp thay Required Required TenKBNN String Tên Kho bạc Nhà nƣớc nơi nhận khoản thu ngân sách nhà nƣớc TaiKhoanKBNN String Tài khoản Kho bạc Nhà nƣớc Required TenNHHuongKBNN String Tên ngân hàng hƣởng KBNN Required LoaiTKNopNSNN String Loại tài khoản nộp ngân sách nhà nƣớc Required TenCoQuanYeuCauNop String Tên qauan quản lý thu Required ThongTinLienQuan String Các thông tin liên quan Required MaGDKhoanNopNSNN String Mã giao dịch khoản nộp ngân sách nhà nƣớc Optional MaHoSo String Mã hồ sơ Required LoaiPhiTTHC String Loại phí thủ tục hành Required Required Các thông tin chi tiết trƣờng CUSTOMER_INFO Name Type Length Mandatory /optional Comments CUSTOMER_ID String 1,255 M Số CMND/Hộ chiếu CUSTOMER_NAME String 1,255 M Họ tên KH CUSTOMER_DOB String 1,255 M Ngày sinh KH CUSTOMER_ACCOUN T_NO CUSTOMER_CARD_ NO CUSTOMER_CARD_D ATE CUSTOMER_MOBIL E String 1,255 M Số TK khách hàng String 1,255 M Số thẻ ATM KH String 1,255 M Ngày hết hạn thẻ String 1,255 M SĐT đăng ký SMS ngân hàng 3.2 API Thanh to n sử dụng Token URL: {api_base_url}/init_with_token Request method: POST Tham số đầu vào đầu object JSON với thuộc tính dƣới đây: Thuộc tính đầu vào Name Type Length Mandatory /optional Comments ACTION String 1,50 M INIT_WITH_TOKEN VERSION String 1,50 M 1.0.6 MERCHANT_SERVICE _ID MERCHANT_ORDER _ID AMOUNT Number 1,12 M Mã định danh đối tác String 1,255 M Mã giao dịch phía đối tác String 1,50 M Số tiền toán CURRENCY_CODE String 1,50 M Đơn vị tiền tệ VND USD PAYMENT_METHO D String 1,50 M Phƣơng thức tốn DESCRIPTION String 1,255 M Mơ tả giao dịch TOKEN String 1,50 M Token toán Khách hàng CARD_EXPIRY_MON TH CARD_EXPIRY_YEA R String 1,50 M Thangs hết hạn thẻ, VD: 07 String 1,50 M Năm hết hạn thẻ, VD: 18 CREATE_DATE String 1,50 M Thời gian giao dịch, định dạng yyyyMMddHHmmss String SECURE_CODE 1,255 M Chuỗi mã hóa tin Thuộc tính đầu Name Type Length Mandatory /optional Comments RESPONSE_CO DE DESCRIPTION String 1,10 M Mã lỗi String 1,255 M Mô tả lỗi REDIRECT_UR L SECURE_CODE String 1,255 M URL để chuyển hƣớng khách hàng String 1,255 M Chuỗi mã hóa tin 3.3 API Confirm giao dịch Đối tác cung cấp cho Payment Connect Request method: POST Content-type: application/x-www-form-urlencoded Parameter name: data Bản tin confirm có dạng nhƣ sau: POST /merchant/confirm HTTP/1.1 HOST: example.com Content-type: application/x-www-form-urlencoded Content-length: data={“ACTION”:”CONFIRM”,“RESPONSE_CODE”:”00”,….} Tham số đầu vào đầu object JSON với thuộc tính dƣới đây: Thuộc tính đầu vào Mandatory Name Type Length Comments /optional ACTION String 1,50 M CONFIRM RESPONSE_CODE String 1,10 M Kết thực giao dịch 1,12 M Mã định danh đối tác 1,255 M Mã giao dịch phía đối tác 1,8 M Số tiền MERCHANT_SERVI Number CE_ID MERCHANT_ORDER String _ID Number AMOUNT CURRENCY_CODE String 1,50 M Đơn vị tiền tệ VND USD TRANSACTION_I D PAYMENT_METH OD String 1,255 M Mã giao dịch Payment Connect String 1,50 M Phƣơng thức toán PAY_DATE String 1,50 M Ngày giao dịch, định dạng (yyyyMMddHHmmss) ADDITIONAL_INF O TOKEN String 1,255 M Thông tin mô tả đơn hàng String 1,255 M Token ACCOUNT_ID String 1,255 M Số thẻ CARD_EXPIRY_MO NTH CARD_EXPIRY_YEA R SECURE_CODE String 1,50 M Tháng hết hạn thẻ String 1,50 M Năm hết hạn thẻ String 1,255 M Chuỗi mã hóa tin Type Length Mandatory /optional Comments Thuộc tính đầu Name RESPONSE_CODE String 1,10 M Mã lỗi DESCRIPTION String 1,255 M Mô tả lỗi 1,12 M Mã định danh đối tác 1,255 M Mã giao dịch phía đối tác 1,50 M MERCHANT_SERVI Number CE_ID MERCHANT_ORDER String _ID 3.4 CREATE_DATE String SECURE_CODE String Thời gian phía đối tác (yyyyMMddHHmmss) 1,255 M Chuỗi mã hóa tin ng m lỗi đối t c tr cho Payment Connect No RESPONSE_CODE DESCRIPTION ACTION = CONFIRM 3.5 00 Thành cơng 01 Khơng tìm thấy giao dịch 02 Giao dịch confirm 08 Hệ thống bận timeout 97 Chữ ký không hợp lệ 99 Các lỗi khác ng m lỗi cho Payment Connect tr cho đối t c No RESPONSE_CODE DESCRIPTION 00 Thành công 01 Giao dịch thất bại 02 Dữ liệu không định dạng 03 Mã giao dịch tồn 04 Timeout 05 Khơng tìm thấy liệu 06 Lỗi hệ thống 07 Chữ ký không 08 Tài khoản đối tác bị khóa 10 09 Tài khoản đối tác không tồn 11 96 Hệ thống bảo trì 12 99 Lỗi khơng xác định Hƣớng dẫn t o secure code Secure code đƣợc tính toán dựa thuật toán SHA-256, giá trị đƣợc tính tốn dựa chuỗi gồm trƣờng thơng tin tin gửi sang Payment Connect, nguyên tắc tạo chuỗi nhƣ sau: - Thứ tự trƣờng thứ tự từ xuống dƣới bảng mô tả thông tin đầu vào Các trƣờng đƣợc phân tách ký tự “|” Các trƣờng đƣợc định nghĩa khơng bắt buộc (Optional) giá trị rỗng Secret key đứng cuối 137