HƯỚNG DẪN TÍCH HỢP NÂNG CAO CỔNG THANH TỐN TRỰC TUYẾN NGÂNLƯỢNG.VN VÀO WEBSITE SỬ DỤNG NGÔN NGỮ PHP BƯỚC Đăng ký ví điện tử NgânLượng Mục đích : tạo tài khoản email nhận tiền NgânLượng Đăng ký( xem hướng dẫn file đăng ký ví điện tử.doc) BƯỚC Đăng ký merchantsite( đăng ký tên miền) Mục đích: tích hợp nâng cao tên miền( website) có mã merchantsite riêng Vậy sau đăng ký merchantsite ta nhận được: Mã merchantsite Mật merchantsite Đăng ký: xem hướng dẫn file đăng ký merchantsite BƯỚC Tích hợp: Mục đích: việc tích hợp đoạn code NgânLượng vào website bán hàng nhằm mục đích tạo nên URL với tham số hoá đơn bán hàng chuyển sang trang NgânLượng để tốn Trong file nganluong.php có hàm xây dựng sẵn: Private function buildCheckoutUrlNew($return_url, $receiver, $transaction_info, $order_code, $price, $currency = 'vnd', $quantity = 1, $tax = 0, $discount = 0, $fee_cal = 0, $fee_shipping = 0, $order_description = '', $buyer_info = '', $affiliate_code = ''): Mục đích hàm : Tạo URL để gửi thông tin từ website bán hàng sang trang NgânLượng để toán Các tham số: CÁC THAM SỐ Ý NGHĨA $return_url Đường link dùng để cập nhật tự động hoá đơn bạn (được xử lý file complete.php ) Nếu website bạn có dạng http://www.banhang.com bạn nhập địa dùng để cập nhật hoá đơn $receiver là: http://www.banhang.com/complete.php Địa Email tài khoản NgânLượng.vn người bán $merchant_site_code Mã Merchant ( đăng ký merchantsite $secure_pass cung cấp mã merchantsite) Mật merchantsite( mật nhập vào $nganluong_url đăng ký merchantsite) Địa toán $transaction_info $order_code $price https://www.nganluong.vn/checkout.php Ghi Mã đơn hàng tên sản phẩm Tổng tiền cần tốn( số ngun khơng $currency chứa ký tự khác số) Đơn vị tiền tệ( mặc định vnd Đối với NgânLượng.vn website tốn tiền usd $currency $quantity $order_description $affiliate_code =usd) Số lượng sản phẩm Mô tả đơn hàng Mã affiliate ( mã cung cấp tham gia chương trình affiliate- áp dụng cho đơn vị thiết kế web forum rao vặt), website khơng thuộc đối tượng mã affiliate $buyer_info bỏ trống Thông tin người mua Nếu khách hàng chọn phương thức toán qua tài khoản ngân hàng mà không cần đăng ký tài khoản NgânLượng.vn, NgânLượng.vn yêu cầu người mua phải khai báo thông tin Do vậy, website bạn yêu cầu người mua đăng nhập mua hàng nhập thơng tin chuyển thông tin sang NgânLượng.vn để người mua nhập lại Cấu trúc sau (các tham số phân tách nhóm ký tự '*|*'): Họ tên người mua *|* Địa Email *|* Điện thoại *|* Địa nhận hàng Ví dụ: Nguyễn Văn A*|*nguyenvana@gmail.com*| *0912345678*|*Hải Châu - Đà Nẵng Lưu ý: Nếu có tham số thông tin người mâu khơng tồn để rỗng phải giữ ký tự '*|*' phân tách để hệ thống nhận biết xác Ví dụ website bán hàng khơng yêu cầu nhập số điện thoại, cấu trúc tham số là: Nguyễn Văn A*|*nguyenvana@gmail.com*|* *| *Hải Châu - Đà Nẵng Giảm giá Phí vận chuyển $discount $fee_shipping Thơng tin trả từ Ngân Lượng sau người mua tốn thành cơng: sau khách hàng tốn thành cơng bên NgânLượng trả tham số : ($transaction_info, $order_code, $price, $payment_id, $payment_type, $error_text, $secure_code )dưới dạng URL( Các tham số trả theo link biến $return_url) Chỉ cần Get tham số website merchant dùng hàm verifyPaymentUrl($transaction_info, $order_code, $price, $payment_id, $payment_type, $error_text, $secure_code) để kiểm tra xem tham số trả có so với đơn hang gửi sang Ngân lượng để tốn khơng Từ cập nhật tình trạng đơn hang tiến hành giao hang cho người mua Tham số: payment_id: Mã giao dịch tốn NgânLượng.vn payment_type: Hình thức giao dịch tốn, [ = Thanh toán ngay, = Thanh toán tạm giữ ] error_text: Thơng báo lỗi (nếu có): Nếu $error_text= rỗng tức tốn thành cơng secure_code: Chuỗi mã hóa kết toán BƯỚC 4: hướng dẫn toán: Để phục vụ mục đích tốn khách hàng nhanh hiệu nhất, NgânLượng đưa sách website tích hợp NgânLượng viết hướng dẫn toán riêng up website ngânlượng ln để đảm bảo cập nhật thay đổi bao gồm: Hướng dẫn mua hàng Hưỡng dẫn toán tài khoản NgânLượng chuyển khoản Ngân hàng Hướng dẫn nạp tiền vào tài khoản NgânLượng Logo NgânLượng link hướng dẫn file( logo.html) Sau tich hợp công ban treo logo chấp nhận toán qua nganluong.vn trang chủ Từ logo khách hàng xem hướng dẫn toán qua NgânLượng Trên nganluong.vn có số mẫu nút tốn logo chấp nhận tốn Bạn lựa chọn màu sắc kiểu dáng phù hợp qua link: http://developer.nganluong.vn/?portal=integration&page=button_style&itemId=3 Cảm ơn bạn! -o0o -Hỗ trợ kỹ thuật: Email : hotrokythuat@nganluong.vn Yahoo: nganluong_sup_tech Skype : nganluong_sup_tech Điện thoại: (04)6251 2484 ( số máy lẻ 102) ... Chuỗi mã hóa kết toán BƯỚC 4: hướng dẫn toán: Để phục vụ mục đích tốn khách hàng nhanh hiệu nhất, NgânLượng đưa sách website tích hợp NgânLượng viết hướng dẫn tốn riêng up website ngânlượng... bao gồm: Hướng dẫn mua hàng Hưỡng dẫn toán tài khoản NgânLượng chuyển khoản Ngân hàng Hướng dẫn nạp tiền vào tài khoản NgânLượng Logo NgânLượng link hướng dẫn file( logo.html) Sau tich hợp công... chấp nhận toán qua nganluong.vn trang chủ Từ logo khách hàng xem hướng dẫn tốn qua NgânLượng Trên nganluong.vn có số mẫu nút toán logo chấp nhận tốn Bạn lựa chọn màu sắc kiểu dáng phù hợp qua link: