HỆ THỐNG THANH TOÁN ĐỊNH KỲ TÀI LIỆU ĐẶC TẢ KẾT NỐI MERCHANT TMĐT

CƠNG TY CỔ PHẦN GIẢI PHÁP THANH TỐN VIỆT NAM HỆ THỐNG THANH TOÁN ĐỊNH KỲ TÀI LIỆU ĐẶC TẢ KẾT NỐI MERCHANT TMĐT Mã hiệu dự án: Mã hiệu tài liệu: Phiên bản: 2.1.0 Hà Nội, tháng 12 năm 2021 Tài liệu đặc tả kỹ thuật kết nối Merchant TMĐT – Hệ thống Thanh tốn trả góp VNPAY v2.1.0 HỆ THỐNG THANH TOÁN ĐỊNH KỲ TÀI LIỆU ĐẶC TẢ KẾT NỐI MERCHANT TMĐT Mã hiệu dự án: Mã hiệu tài liệu: Phiên bản: 2.1.0 Cơng ty cổ phần Giải pháp tốn Việt nam 2/60 Tài liệu đặc tả kỹ thuật kết nối Merchant TMĐT – Hệ thống Thanh toán định kỳ VNPAY v2.1.0 BẢNG GHI NHẬN THAY ĐỔI *A – Tạo mới, M – Sửa đổi, D – Xóa bỏ Ngày thay đổi Vị trí A* Nguồn gốc thay đổi M, D Phiên Mô tả thay đổi cũ Phiên 06/12/2021 A Tạo v1.0.0 04/03/2022 M Cập nhật version v2.1.0 07/07/2022 M Cập nhật Thông tin nhận từ VNPAY Công ty cổ phần Giải pháp toán Việt nam 3/60 Tài liệu đặc tả kỹ thuật kết nối Merchant TMĐT – Hệ thống Thanh toán định kỳ VNPAY v2.1.0 Mục lục GIỚI THIỆU 1.1 Mục đích tài liệu 1.2 Phạm vi tài liệu 1.3 Định nghĩa thuật ngữ từ viết tắt MƠ HÌNH KẾT NỐI VÀ ĐẶC TẢ DỮ LIỆU TRAO ĐỔI CÁC API 2.1 Mơ hình kết nối 2.1.1 Mơ tả quy trình toán định kỳ 2.2 Sơ đồ 2.3 Đặc tả liệu trao đổi 11 2.3.1 Kiểu liệu 11 2.3.2 Các trường thông tin trao đổi 11 2.4 Yêu cầu xác thực 11 2.4.1 Định dạng liệu 11 2.4.2 Sơ đồ 12 2.4.3 Yêu cầu xác thực 12 2.5 Khởi tạo đăng ký toán định kỳ 14 2.5.1 Định dạng liệu 14 2.5.2 Sơ đồ 15 2.5.3 Khởi tạo đăng ký toán định kỳ 15 2.6 Xác thực thông tin thẻ KH 24 2.6.1 Định dạng liệu 24 2.6.2 Sơ đồ 25 2.6.3 Xác thực thông tin thẻ KH 25 2.7 Thanh toán định kỳ 26 Cơng ty cổ phần Giải pháp tốn Việt nam 4/60 Tài liệu đặc tả kỹ thuật kết nối Merchant TMĐT – Hệ thống Thanh toán định kỳ VNPAY 2.7.1 Định dạng liệu 26 2.7.2 Sơ đồ 26 2.7.3 Yêu cầu toán định kỳ 26 2.8 Cập nhật thông tin thẻ 32 2.8.1 Định dạng liệu 32 2.8.2 Sơ đồ 33 2.8.3 Yêu cầu cập nhật thông tin thẻ 33 2.9 Cập nhật số kỳ đăng ký 39 2.9.1 Định dạng liệu 39 2.9.2 Sơ đồ 39 2.9.3 Yêu cầu cập nhật số kỳ đăng ký 39 2.10 Hủy đăng ký 44 2.10.1 Định dạng liệu 44 2.10.2 Sơ đồ 45 2.10.3 Yêu cầu hủy đăng ký 45 2.11 URL IPN 49 2.11.1 Lưu ý 49 2.11.2 Sơ đồ 50 2.11.3 URL IPN 50 2.12 v2.1.0 URL Return 54 2.12.1 Lưu ý 54 2.12.2 Sơ đồ 54 2.12.3 URL Return 54 PHỤ LỤC 58 3.1 Bảng mã lỗi 58 Công ty cổ phần Giải pháp toán Việt nam 5/60 Tài liệu đặc tả kỹ thuật kết nối Merchant TMĐT – Hệ thống Thanh toán định kỳ VNPAY v2.1.0 Công ty cổ phần Giải pháp toán Việt nam 6/60 Tài liệu đặc tả kỹ thuật kết nối Merchant TMĐT – Hệ thống Thanh toán định kỳ VNPAY v2.1.0 GIỚI THIỆU Mục đích tài liệu 1.1 Tài liệu cung cấp đặc tả kỹ thuật kết nối hệ thống Thanh toán định kỳ VNPAY dành cho Merchant TMĐT 1.2 Phạm vi tài liệu Mơ tả ngắn gọn Mơ hình kết nối, sơ đồ tuần tự, hàm API nghiệp vụ liên quan tới việc kết nối hai hệ thống Định nghĩa thuật ngữ từ viết tắt 1.3 Thuật ngữ Định nghĩa TMĐT Thương mại điện tử Recurring Payment Hệ thống toán định kỳ VNPAY Merchant Đơn vị chấp nhận thẻ API Giao diện kết nối để merchant tương tác với hệ thống VNPAY Checksum Mã sử dụng để kiểm tra toàn vẹn liệu OTP Mật xác thực cho giao dịch (One Time Password) Ghi Bảng 1: Thuật ngữ định nghĩa Cơng ty cổ phần Giải pháp tốn Việt nam 7/60 Tài liệu đặc tả kỹ thuật kết nối Merchant TMĐT – Hệ thống Thanh toán định kỳ VNPAY v2.1.0 MƠ HÌNH KẾT NỐI VÀ ĐẶC TẢ DỮ LIỆU TRAO ĐỔI CÁC API 2.1 Mơ hình kết nối 2.1.1 Mơ tả quy trình tốn định kỳ - Khách hàng truy cập Website/App TMĐT chọn toán với tài khoản/thẻ tín dụng hoạt động Ngân hàng hỗ trợ - Website/App TMĐT gửi thông tin yêu cầu tốn sang VNPAY Thơng tin gửi sang theo đặc tả kỹ thuật tài liệu - Khách hàng xác nhận toán ngân hàng - Sau khách hàng xác nhận thông tin giao dịch, VNPAY xử lý trả lại kết cho Website/App TMĐT qua đường: o IPN Url (server call server) o Redirect trực tiếp kết đường dẫn mà Website/App TMĐT gửi request yêu cầu toán định kỳ - Website/App TMĐT thơng báo kết tốn tới khách hàng Công ty cổ phần Giải pháp toán Việt nam 8/60 Tài liệu đặc tả kỹ thuật kết nối Merchant TMĐT – Hệ thống Thanh toán định kỳ VNPAY 2.2 v2.1.0 Sơ đồ Mô tả sơ đồ: Bước 1: Khách hàng vào website TMĐT thực đăng ký dịch vụ chọn đăng ký Thanh toán định kỳ qua VNPAY Bước 2: Website TMĐT gửi thông tin yêu cầu khởi tạo đăng ký toán định kỳ khách hàng sang VNPAY theo đặc tả kết nối Bước 3: Website merchant chuyển hướng giao diện khách hàng sang VNPAY theo đặc tả kết nối Bước 4: Khách hàng nhập thông tin xác thực thẻ tốn VNPAY Thơng qua kết nối riêng VNPAY Ngân hàng, VNPAY gửi yêu cầu sang bên Ngân hàng để thực xác thực thông tin thẻ Bước 5: Khách hàng xác nhận đăng ký để hoàn tất giao dịch Xác nhận thành công, hệ thống Ngân hàng tiến hành tạo token cho KH Kết thúc bước xác nhận đăng ký hệ thống chuyển khách hàng sang bước Bước 6: VNPAY thông báo kết đăng ký Website TMĐT để website TMĐT tiến hành cập nhật trạng thái đăng ký, kèm theo mã token Website TMĐT lưu lại mã token để sử dụng cho việc toán kỳ toán Công ty cổ phần Giải pháp toán Việt nam 9/60 Tài liệu đặc tả kỹ thuật kết nối Merchant TMĐT – Hệ thống Thanh toán định kỳ VNPAY v2.1.0 Bước 7: Hàng kỳ, Website TMĐT tiền hành quét yêu cầu đăng ký toán định kỳ hợp lệ KH, gửi yêu cầu toán sang VNPAY Nếu giao dịch thành công, Merchant tiến hành xử lý đơn hàng Công ty cổ phần Giải pháp toán Việt nam 10/60