Hướng dẫn tích hợp cổng thanh toán VN-QR, ví VNPAY vào website

Các bước tích hợp VNPAY vào website

Tích hợp cổng thanh toán VNPAY vào website của bạn là bước quan trọng để nâng cao trải nghiệm mua sắm của khách hàng và tăng doanh thu. Dưới đây là hướng dẫn chi tiết các bước thực hiện:

Bước 1: Đăng ký Tài Khoản VNPAY

• Truy cập trang web VNPAY: Đăng ký tài khoản và cung cấp các thông tin cần thiết như tên doanh nghiệp, thông tin liên hệ, tài khoản ngân hàng,...
• Ký hợp đồng: Sau khi đăng ký, bạn sẽ được VNPAY liên hệ để ký kết hợp đồng và hoàn tất thủ tục.

Bạn đăng ký tài khoản tại địa chỉ: https://sandbox.vnpayment.vn/devreg/

Bước 2: Lấy thông tin cấu hình

Sau khi kích hoạt tài khoản, bạn sẽ nhận được một số thông tin cần thiết để cài đặt ở phần sau.

• Terminal ID: Mã nhận dạng duy nhất của website trên hệ thống VNPAY.
• Secret Key: Khóa bí mật dùng để mã hóa dữ liệu, đảm bảo an toàn giao dịch.
• URL Pay: Đường dẫn để khởi tạo giao dịch thanh toán.
• URL IPN: Đường dẫn mà VNPAY gửi thông báo kết quả giao dịch về cho website của bạn.

Bước 3: Tích hợp code

• Chọn phương thức tích hợp: Có hai phương thức chính là tích hợp bằng API hoặc sử dụng plugin/module có sẵn.
• Tích hợp API:
  • Build URL thanh toán: Tạo một URL chứa thông tin đơn hàng, khách hàng và các thông số khác theo định dạng của VNPAY.
  • Chuyển hướng khách hàng: Khi khách hàng nhấn nút "Thanh toán", hệ thống sẽ chuyển hướng khách hàng đến trang thanh toán của VNPAY thông qua URL vừa tạo.
• Sử dụng plugin/module:
  • Cài đặt plugin: Tìm và cài đặt plugin VNPAY tương thích với nền tảng website của bạn (ví dụ: WooCommerce, Magento, Zozo,...)
  • Cấu hình plugin: Nhập các thông tin cấu hình đã nhận được từ VNPAY vào plugin.

Bước 4: Kiểm tra và điều chỉnh

• Kiểm tra chức năng thanh toán: Thực hiện một giao dịch thử nghiệm để kiểm tra xem quá trình thanh toán diễn ra trơn tru hay không.
• Điều chỉnh giao diện: Điều chỉnh giao diện thanh toán sao cho phù hợp với giao diện tổng thể của website.

Ví dụ về cách build URL thanh toán (API):

https://sandbox.vnpayment.vn/paymentv2/vpcpay.html?
vnp_Version=2.1.0&
vnp_Command=pay&
vnp_TmnCode=YOUR_TERMINAL_ID&
vnp_Amount=100000&
vnp_CurrCode=VND&
vnp_BankCode=VNB&
vnp_TxnRef=21tx3454333&
vnp_IpAddr=123.123.123.123&
vnp_TmnUrl=http://your_website/return_url&
vnp_ReturnUrl=http://your_website/return_url&
vnp_Notiurl=http://your_website/ipn_url&
vnp_Locale=vn&
vnp_CreateDate=2011-08-11+12:12:12

Lưu ý:

• Các thông số: Mỗi thông số trong URL có ý nghĩa khác nhau, bạn cần tham khảo tài liệu kỹ thuật của VNPAY để hiểu rõ.
• Mã hóa: Dữ liệu nhạy cảm như vnp_Amount, vnp_TxnRef cần được mã hóa trước khi gửi lên VNPAY.
• Kiểm tra bảo mật: Đảm bảo website của bạn được bảo mật tốt để tránh rò rỉ thông tin khách hàng.

Tài liệu tham khảo:

• Hướng dẫn tích hợp VNPAY: https://sandbox.vnpayment.vn/apis/docs/thanh-toan-pay/pay.html
• Tích hợp VNPAY vào WooCommerce: https://sandbox.vnpayment.vn/apis/docs/open/woocommerce/

Lưu ý: Đây là hướng dẫn chung, các bước cụ thể có thể thay đổi tùy thuộc vào từng nền tảng website và phiên bản VNPAY. Bạn nên tham khảo tài liệu chính thức của VNPAY để có thông tin chính xác nhất.

Bạn có muốn tôi cung cấp thêm thông tin chi tiết về một bước nào đó không? Hoặc bạn có thể hỏi về các vấn đề cụ thể như:

• Tích hợp VNPAY vào nền tảng nào đó: WordPress, Magento, Laravel,...
• Cách xử lý thông báo IPN: Làm thế nào để cập nhật trạng thái đơn hàng sau khi nhận được thông báo từ VNPAY.
• Các vấn đề thường gặp: Lỗi không thanh toán được, lỗi chuyển hướng,...

Chúc quý khách lựa chọn được cổng thanh toán phù hợp cùng việc tích hợp cổng thanh toán VNPAY lên website thành công.