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