Các bạn click ở biểu tượng này để bắt đầu thực tập thực tế: ->
Những loại trang web có thể được tạo bằng WordPress
Có nhiều nhiều trang web khác nhau mà bạn thấy hiện nay đang sử dụng mã nguồn WordPress, nhưng tóm lại thì WordPress có thể tạo được những trang web theo các nhóm phân loại dưới đây.
1. Trang web thương mại: Bạn là chủ doanh nghiệp hoặc cá nhân đang muốn phát triển kinh doanh, WordPress có thể giúp bạn tạo ra một trang web thật bắt mắt nhằm giới thiệu thương hiệu cũng như sản phẩm bạn đang kinh doanh.
2. Trang blog cá nhân: Điều này thì khỏi phải nói rồi, WordPress là mã nguồn phát triển blog cá nhân tốt nhất hiện nay.
3. Trang lưu trữ ảnh: Bạn là người đam mê nhiếp ảnh, bạn muốn giới thiệu những bộ ảnh của bạn đến độc giả, hãy tạo một trang web với WordPress để thực hiện điều này.
4. Trang đánh giá: Bạn có ý tưởng muốn tạo một trang web chuyên đánh giá các sản phẩm công nghệ hoặc đánh giá các sản phẩm phần mềm, hãy đến với WordPress bạn sẽ thấy điều này thật dễ dàng.
5. Trang tin tức: Với blog được tạo từ WordPress, bạn có thể làm nên những trang chia sẻ tin tức một cách chuyên nghiệp.
Trên đây là những nhóm trang web chính bạn có thể tạo ra bằng WordPress, Sáu chỉ giới thiệu một vài cái chính thôi, còn nhiều nhiều nhóm trang web khác bạn vẫn có thể làm được.
Các bạn click ở biểu tượng này để bắt đầu thực tập thực tế: ->
Thương mại điện tử ở Việt Nam đang ngày càng phát triển và kinh doanh qua mạng đang trở nên "hot" hơn bất cứ lúc nào. Vì vậy, việc xây dựng cho riêng mình 1 website bán hàng trực tuyến là nhu cầu của rất nhiều người. Danh bạ web 2.0 sẽ giới thiệu những phần mềm miễn phí và được nhiều người sử dụng để các bạn có thể tham khảo và lựa chọn.
1. Opencart (http://www.opencart.com)
Giải pháp thương mại điện tử này giúp những người kinh doanh trên Internet dễ dàng tạo cho riêng mình 1 website bán hàng trực tuyến mà không cần quá nhiều thời gian và chi phí. Opencart được thiết kế giàu tính năng, đơn giản hóa khi sử dụng, thân thiện với các bộ máy tìm kiếm và giao diện đẹp. Xem Demo tại đây
Platform eCommerce này rất nổi tiếng và được nhiều người sử dụng. Giải pháp này cung cấp nhiều tính năng linh hoạt và dễ dàng quản lý giao diện, nội dung và nhiều chức năng khác trên gian hàng trực tuyến. Magento hỗ trợ nhiều ngôn ngữ, phần quản trị dễ sử dụng, cho phép tùy chỉnh thoải mái template, tạo các group và cung cấp API để bạn tích hợp ứng dụng của hãng thứ ba. Xem Demo tại đây
3.Oscommerce (http://www.oscommerce.com)
Phần mềm mã nguồn mở miễn phí này là giải pháp tốt nếu bạn muốn tạo nhanh chóng và dễ dàng 1 trang bán hàng trực tuyến. osCommerce ra mắt vào tháng 3/2000 và đến bây giờ đã có hơn 207.000 gian hàng trực tuyến trên khắp thế giới. Xem demo tại đây
4.PrestaShop (http://www.prestashop.com)
PrestaShop là 1 phần mềm chuyên nghiệp và miễn phí giúp bạn tạo các trang TMĐT. Đây là phần mềm giàu tính năng, dễ dàng cài đặt, tùy chỉnh và rất nhẹ. Không thể tìm kiếm được phần mềm nào tốt hơn PrestaShop, hãy tải về và dùng thử nào Xem Demo tại đây
5. Zencart (http://www.zen-cart.com)
Zen Cart khá phổ biến và được nhiều người lựa chọn, trong đó có Việt Nam. Dễ dàng cài đặt, hỗ trợ nhiều phương thức thanh toán …
6. Ubercart (http://www.ubercart.org)
Ubercart là gói mã nguồn mở tích hợp trên hệ quản trị nội dung Drupal giúp bạn tạo các online stores.
7.PhpShop (http://www.phpshop.org)
Hỗ trợ tạo đơn giản các shopping cart trên framework CakePHP.
8. Storesprite (http://www.storesprite.com)
Đây là gói phần mềm chuyên dùng cho các Web Designer với nhiều tính năng được hỗ trợ, dễ dàng cài đặt, tùy chỉnh và duy trì hệ thống.
9.VirtueMart (http://virtuemart.net)
Gói phần mềm E-Commerce miễn phí này dành cho hệ quản trị nội dung nổi tiếng là Joomla.
Dưới đây chúng tôi sẽ hướng dẫn bạn hai cách tích hợp thanh toán qua cổng thanh toán trực tuyến Ngân Lượng. Tùy vào mục đích và chức năng của từng site bạn hãy chọn cho mình một phương thức thanh toán phù hợp:
A. Hướng dẫn tích hợp tùy biến cho các website sử dụng cms Wordpress
Bước 0: Bạn hãy download tại đây và làm theo các bước hướng dẫn bên dưới:
Bước 1: Copy file nganluong.php trong thư mục wordpress vừa download được ở bước trên vào thư mục: tên thư mục gốc/ wp-content/ plugins/ wp-e-commerce/ merchants/
Bước 2: Để kích hoạt phương thức thanh toán Ngân Lượng bạn vào trong trang quản trị chọn Store chọn Setting chọnPayment Options sẽ xuất hiện danh sách các Merchanrt, bạn hãy chọn vào checkbox Ngân Lượng như hình vẽ bên dưới:
Tùy chọn này cho phép bạn quyết định phương thức nào sẽ xuất hiện trước người mua.
Bước 3: Cấu hình thông tin cho phương thức thanh toán Ngân Lượng như hình vẽ:
Điền đầy đủ các thông tin như email người nhận (người bán), tên hiển thị của Ngân Lượng trước người dùng, và địa chỉ trả về. Sau khi hoàn thành các thao tác trên bạn đã có thêm một phương thức thanh toán bằng Ngân Lượng xuất hiện trước người mua.
B. Hướng dẫn tích hợp nâng cao cho các website sử dụng cms Wordpress.
Bước 1: Copy file nganluong.php trong thư mục wordpress_nc vừa download được vào thư mục: tên thư mục gốc/ wp-content/ plugins/ wp-e-commerce/ merchants/
Bước 2: Copy file NL_checkout.class.php trong thư mục wordpress_nc vừa download được vào thư mục gốc/ wp-content/ plugins/ wp-e-commerce/ wpsc-includes trên project của bạn
Bước 3: Để kích hoạt phương thức thanh toán Ngân Lượng bạn vào trong trang Quản trị/ Store/ Setting/ Payment Optionssẽ xuất hiện danh sách các Merchant, bạn chọn vào checkbox Ngân Lượng như hình vẽ bên dưới:
Tùy chọn này cho phép bạn quyết định phương thức nào sẽ được chọn làm phương thức thanh toán.
Bước 4: Cấu hình thông tin cho phương thức thanh toán Ngân Lượng như hình vẽ:
Điền đầy đủ các thông tin như email người nhận (người bán), địa chỉ checkout, mã merchant site, mật khẩu giao tiếp, tên phương thức và địa chỉ trả về. Sau khi hoàn thành các thao tác trên bạn đã có thêm một phương thức thanh toán qua cổng thanh toán Ngân Lượng chúc bạn thành công.
Bạn có thể tưởng tượng nỗi không khi mà OS Commerce được thiết kế trộn lẫn giữa giao diện và xử lý.Khi bạn cần mua một template cho nó điều đó có nghĩa là người ta sẽ giao cho bạn một mã nguồn hoàn chỉnh. Bức xúc quá lâu cuối cùng bà con cũng cho ra một hệ thống cháu nội của OSCommerce, mang đầy đủ tinh hoa của ông cha nhưng nhẹ nhàng và tinh tế hơn với một giao diện có sẵn chuyên nghiệp, đó là Digistore. Bên cạnh đó một số anh hào mới cũng xuất hiện với những tính năng hiện đại như so sánh giá, phân lọai theo Tag Cloud, hỗ trợ thống kê Top, Most mà đáng kể phải nói tới PHPMass và prestashop.
Huớng dẫn tích hợp OPEN CART
- Coppy các file theo đúng cấu trúc đường dẫn của thư mục - Vào quản trị admin -> extension -> Payment - Install phương thức thanh toán bằng ngân lượng + Nhập các tham số Site ID ,Mật khẩu giao tiếp API,Tài khoản nhận tiền,Địa chỉ gọi lại,Trạng thái đặt hàng,Trạng thái,Xắp xếp + Enlable và Save
A. Hướng dẫn tích hợp tùy biến cho các website sử dụng cms Drupal.
Bước 0: Bạn hãy download tại đây và làm theo các bước hướng dẫn bên dưới:
Bước 1: Copy thư mục ec_nganluong từ thư mục Drupal/ ec_nganluong trong file nén vừa download ở bước trên vào thư mục trên project của bạn như đường dẫn Thư mục gốc/ sites/ all/ modules/ ecommerce/
Bước 2: Vào phần Quản trị/ site building/ modules chọn check box và thực hiện 'Save config' để cài đặt module này.
Bước 3: Trong quản trị, bạn vào phần 'Administer/ e-Commerce-configuration/ receipts/types' sẽ xuất hiện phương thức thanh toán Ngân Lượng được thêm vào như hình bên dưới:
Để cấu hình các thông tin thanh toán cho Ngân Lượng, kích vào Ngân Lượng như hình vẽ và thực hiện cấu hình:
- Lúc này bạn có thể điền những thông tin cấu hình cho thanh toán Ngân Lượng như email người nhận, và địa chỉ của trang Ngân Lượng dùng để thanh toán, được cố định là: https://www.nganluong.vn/button_payment.php
- Các thông tin này được cấu hình trong phần Settings.
- Với phần Options, bạn được phép cấu hình tên hiển thị của phương thức thanh toán Ngân Lượng, mô tả của phương thức và cho phép Ngân Lượng có là phương thức thanh toán trước người dùng hay không? Điều đó dựa vào cách chọn giá trị ởAllow Payment.
B. Hướng dẫn tích hợp nâng cao cho các website sử dụng cms Drupal.
Bước 1: Copy thư mục ec_nganluong từ thư mục Drupal_nc/ ec_nganluong trong file nén vừa download ở bước trên vào thư mục trên project của bạn như đường dẫn Thư mục gốc/ sites/ all/ modules/ ecommerce/
Bước 2: Vào phần 'Quản trị/ site building/ modules' chọn check box và thực hiện Save config để cài đặt module này.
Bước 3: Trong quản trị, bạn vào phần Administer/e-Commerce-configuration/receipts/types sẽ xuất hiện phương thức thanh toán Ngân Lượng được thêm vào như hình bên dưới:
Bạn muốn cấu hình những thông tin cho thanh toán Ngân Lượng, kích vào Ngân Lượng như hình vẽ và thực hiện cấu hình:
Form điền thông tin cho việc thanh toán có dạng như sau:
- Lúc này bạn có thể điền những thông tin cấu hình cho thanh toán Ngân Lượng như email người nhận, địa chỉ trả về, mã merchant Site, mật khẩu giao tiếp, địa chỉ checkout trang Ngân Lượng.
- Các thông tin này được cấu hình trong phần Settings.
- Với phần Options, bạn được phép cấu hình tên hiển thị của phương thức thanh toán Ngân Lượng, mô tả của phương thức và cho phép Ngân Lượng có là phương thức thanh toán trước người dùng hay không? Điều đó dựa vào cách chọn giá trị ởAllow Payment.
Magento là một phần mềm giúp tạo các trang web thương mại điện tử (e-commerce). Các website sử dụng cms Magento ngày nay đã áp dụng rộng rãi Ngân Lượng để có được sự trao đổi với KH một cách nhanh chóng và thuận tiện nhất. Và dưới đây là bản hướng dẫn tích hợp Ngân Lượng vào website của bạn.
A. Hướng dẫn tích hợp tùy biến cho các website sử dụng cms Magento
Bước 0: Bạn hãy download tại đây và làm theo các bước hướng dẫn bên dưới:
Bước 1: Bạn tìm đến đường dẫn trên project của mình: Thư mục gốc/ app/ code/ core/ Mage/ Payment/ etc/ config.XML và tìm đến đoạn nằm trong cặp thẻ: '< default> < payment>...< /payment> ' tiến hành thêm đoạn mã bên dưới vào:
Bước 2: Bạn tìm đến đường dẫn trên project của bạn: Thư mục gốc/ app/ code/ core/ Mage/ Payment/ etc/ system.XML và tìm đến đoạn nằm trong cặp thẻ: "<groups>…",copy toàn bộ nội dung nằm trong file magento/ code-Payment/ etc/ system.xml nằm trong file nén vừa download được ở bước 0 vào sau bất kỳ 1 định nghĩa cho 1 phương thức thanh toán nào khác (, …).
Bước 3: Copy file NganLuong.php trong thư mục magento/ code-Payment/ Model/ Method vừa download được vào thư mục /app/ code/ core/ Mage/ Payment/ Model/ Method trên project của bạn.
Bước 4: Copy file Nganluong.php trong thư mục magento/ code-Payment/ Block/ Form vừa download được vào thư mục/app/ code/ core/ Mage/ Payment/ Block/ Form trên project của bạn.
Bước 5: Copy file Nganluong.php trong thư mục magento/ code-Payment/ Block/ Info vừa download được vào thư mục / app/ code/ core/ Mage/ Payment/ Block/ Info trên project của bạn.
Bước 6: Copy file nganluong.phtml trong thư mục magento/ template-payment/ form vừa download được vào thư mục / design/ frontend/ base/ default/ template/ payment/ form trên project của bạn.
Bước 7: Copy file nganluong.phtml trong thư mục magento/ template-payment/ info vừa download được vào thư mục / design/ frontend/ base/ default/ template/ payment/ info trên project của bạn.
Bước 8: Bạn tìm đến đường dẫn /design/ frontend/ base/ default/ template/ checkout/ success.phtml trên project của bạn, thêm đoạn code có nội dung như sau vào dưới dòng code hiển thị thông báo "You will receive an order confirmation email with details of your order and a link to track its progress":
Trong phần Quản trị/ system/ configuration/ payment method khi click vào Ngân Lượng sẽ có mô tả như hình vẽ:
Nếu bạn muốn sử dụng Ngân Lượng là 1 phương thức thanh toán trước người dùng thì hãy chọn Enable =>Yes để kích hoạt. Trong các mục ở trên có 2 mục mà bạn phải điền đầy đủ là: Return_URL và Email Receiver tương ứng với địa chỉ trả về và email người bán. Lúc này khi khách hàng thực hiện bước chọn phương thức thanh toán, tích hợp Ngân L ượng sẽ xuất hiện như hình vẽ:
Khách hàng sẽ thực hiện thanh toán khi click vào nút "Thanh toán" ở bước cuối cùng như hình vẽ:
B. Hướng dẫn tích hợp nâng cao cho các website sử dụng cms Magento
Bước 1: Bạn tìm đến đường dẫn magento_nc/ app / code/core / Mage/ Payment/etc/ config.XML và tìm đến đoạn nằm trong cặp thẻ: '< default> < payment>...< /payment> ' tiến hành thêm đoạn mã bên dưới vào:
Bước 2: Bạn tìm đến đường dẫn / app/ code/ core/ Mage/ Payment/ etc/ system.XML trên project của bạn và tìm đến đoạn nằm trong cặp thẻ: "…. ,copy toàn bộ nội dùng nằm trong file magento_nc/ code-Payment/ etc/ system.xml vừa download được vào sau bất kỳ 1 định nghĩa cho 1 phương thức thanh toán nào khác (, …).
Bước 3: Copy file NganLuong.php trong thư mục magento_nc/ code-Payment/ Model/ Method vừa download được vào thư mục / app/ code/ core/ Mage/ Payment/ Model/ Method trên project của bạn.
Bước 4: Copy file Nganluong.php trong thư mục magento_nc/ code-Payment/ Block/ Form vào thư mục / app/ code/ core/ Mage/ Payment/ Block/ Form trên project của bạn.
Bước 5: Copy file Nganluong.php trong thư mục magento_nc/ code-Payment/ Block/ Info vừa download được vào thư mục/app/ code/ core/ Mage/ Payment/ Block/ Info trên project của bạn
Bước 6: Copy file nganluong.phtml trong thư mục magento_nc/ template-payment/ form vừa download được vào thư mục/design/ frontend/ base/ default/ template/ payment/ form trên project của bạn.
Bước 7: Copy file nganluong.phtml trong thư mục magento_nc/ template-payment/ info vừa download được vào thư mục/design/ frontend/ base/ default/ template/ payment/ info trên project của bạn.
Bước 8: Bạn tìm đến đường dẫn /design/ frontend/ base/ default/ template/ checkout/ success.phtml thêm toàn bộ nội dung nằm trong file success.phtml vào dưới dòng code hiển thị thông báo "You will receive an order confirmation email with details of your order and a link to track its progress". Trong phần quản trị/system/configuration/payment method khi click vào ngân lượng sẽ có mô tả như hình vẽ:
Nếu bạn muốn sử dụng Ngân Lượng là 1 phương thức thanh toán trước người dùng thì hãy chọn Enable =>Yes để kích hoạt. Bạn phải điền đầy đủ các thông tin: địa chỉ checkout Ngân Lượng, địa chỉ trả về (return_url), địa chỉ người bán(Email Receiver), mật khẩu giao tiếp, mã merchant Site (merchant ID). Lúc này khi khách hàng thực hiện bước chọn phương thức thanh toán, tích hợp ngân lượng sẽ xuất hiện như hình vẽ:
Khách hàng sẽ thực hiện thanh toán khi click vào nút "Thanh toán" ở bước cuối cùng như hình vẽ:
Nukeviet
Dưới đây cách hướng dẫn tích hợp cổng thanh toán Ngân Lượng vào website của bạn.
Cài đặt
Hiện giờ module Shop phiên bản mới nhất là 3.4.02 được phát hành độc lập với NukeViet 3.4, để cài đặt module này bạn cần cài đặt NukeViet 3.4 trước, sau đó tiền hành cài đặt module Shop lên đó.
(Lưu ý: Chỉ tải về tại địa chỉ chính thức, không sử dụng các module trôi nổi hoặc code share trên mạng để tránh bị chèn mã độc hoặc có thể chứa những lỗi không thể lường trước)
Tích hợp cổng thanh toán Ngân Lượng
A. Đăng ký ví điện tử Ngân Lượng
Để có thể tích hợp cổng thanh toán ngân lượng vào website bán hàng bạn cần có một tài khoản nhận tiền, tài khoản nhận tiền chính là tải khoản ví điện tử của Ngân Lượng. Nếu bạn chưa có tài khoản, cần đăng kí trước tiên. Để thực hiện việc đăng kí tài khoản, tham khảo tài liệuHướng dẫn mở tài khoản ví điện tử
B. Đăng ký Merchant Site
Để đăng kí Merchant Site trước tiên cần đăng nhập vào Ngân Lượng, sau khi đăng nhập thành công trên menu của thành viên chọn Tích hợp thanh toán ⇒ Bán nội dung số ⇒ Đăng kí Merchant Site, điền đầy đủ các thông tin vào form như ảnh
Sau khi đăng ký xong, bạn tiếp tục làm theo những hướng dẫn để xác minh website. Chú ý:
Mục địa chỉ tên miền website cần điền đúng quy luật thì phần tích hợp mới hoạt động được. Nếu website của bạn chạy ngay từ tên miền chính ví dụ http://nukeviet.vn, http://shops.nukeviet.vn thì điền vào là nukeviet.vn, shops.nukeviet.vn. Nếu website của bạn được đặt vào thư mục con so với thư mục chính, đường dẫn tới website có dạng http://nukeviet.vn/shops/ hoặchttp://shops.nukeviet.vn/shops/ thì điền vào nukeviet.vn/shops, shops.nukeviet.vn/shops, không điền dấu / ở cuối đường dẫn ví dụ nukeviet.vn/.
Mục Mật khẩu giao tiếp là mục bạn cần ghi nhớ để tích hợp vào shops.
C. Tích hợp vào Shops
Bước 1:Đăng nhập vào phần quản trị admin
Bước 2: Chọn phần quản lý site
Bước 3:Chọn phần Sản Phẩm
Bước 4:Chọn Tích hợp cổng thanh toán
Bước 5:Chọn Sửa để cấu hình thanh toán qua NgânLượng.vn
Bước 6:Tiến hành cấu hình thông tin
Tại đây bạn cần chú ý điền các thông tin sau.
1. Tên cổng thanh toán: Các bạn điền là NgânLượng.vn
o Địa chỉ trang checkout của Ngân Lượng.vn: https://www.nganluong.vn/checkout.php
Sau khi tạo thành công phương thức thanh toán mới, active phương thức này
Hướng dẫn tích hợp thẻ cào
I. Giới thiệu chung
1. Mục đích
Mô tả chi tiết cách thức tích hợp cổng thanh toán trực tuyến Ngân Lượng để nạp tiền vào tài khoản tiền ảo trên ứng dụng Mobile trên JAVA của bạn sử dụng thẻ cào điện thoại.
2. Giới hạn tài liệu
Chỉ sử dụng cho các merchant bán sản phẩm và dịch vụ nội dung số trên mobile
- Hướng dẫn chứng thực tài khoản Ngân Lượng:
Sau khi đăng ký tài khoản thành công, bạn cần chứng thực tài khoản của mình, để phục vụ cho mục đích định danh tài khoản trong giao dịch rút tiền sau này. Vào đây
II. Quy trình thực hiện kết nối
1. Merchant đăng ký tài khoản ví điện tử Ngân Lượng
- Thực hiện đăng ký mở tài khoản ví Ngân Lượng theo hướng dẫn
2. Khai báo ứng dụng của merchant trên hệ thống Ngân Lượng
Khai báo website/merchant trong phần tích hợp nâng cao của NgânLượng.vn
3. Mô tả hàm “CardCharge
Tên hàm: CardCharge
Tham số vào (gồm 3 tham số)
STT
Tên tham số
Kiểu dữ liệu
Bắt buộc
Giải thích
1
merchant_id
String(50)
x
Mã website/merchant đã khai báo tại NgânLượng.vn
2
checksum
String(50)
x
Là mã MD5 của các tham số và Mật khẩu kết
nối giữa website/merchant với NgânLượng.vn
3
params
String()
x
Là một chuỗi các giá trị ngăn cách nhau bởi dấu ‘|’, tương ứng với các tham số như sau:
pin_card
String(20)
x
Mã thẻ cào
type_card
String(10)
x
Loại thẻ cào, nhận một trong các giá trị:
VMS: Thẻ cào MobiFone
VNP: Thẻ cào VinaPhone
VIETTEL: Thẻ cào Viettel
ref_code
String(50)
x
Mã duy nhất tương ứng với một khách hàng tại merchant (ví dụ: tên tài khoản, mã tài khoản,…)
merchant_account
String(255)
x
Địa chỉ Email chính của tài khoản NgânLượng.vn mà merchant dùng để nhận tiền nạp vào từ thẻ cào
client_fullname
String(255)
Tên đầy đủ của khách hàng tại merchant
client_email
String(255)
Email khách hàng tại merchant
client_mobile
String(20)
Điện thoại của khách hàng tại merchant
card_serial
String(20)
Số serial thẻ cào
Các tham số trên được ngăn cách nhau bởi dấu gạch thẳng đứng ‘|’ theo thứ tự như sau:
params = pin_card|type_card|ref_code|merchant_account|client_fullname|client_email|client_mobile|card_serial
Trong đó, tham số checksum được mã hóa như sau:
Checksum = MD5(param + “|” + Merchant Password (với Merchant Password là mật khẩu kết nối giữa merchant và NgânLượng.vn được khai báo khi khai báo thông tin website hoặc merchant tại NgânLượng.vn)
Tham số ra (trả về)
STT
Tên tham số
Kiểu dữ liệu
Bắt buộc
Giải thích
1
result
String()
Là một chuỗi các giá trị ngăn cách nhau bởi dấu ‘|’,
tương ứng với các tham số như sau:
Mã duy nhất tương ứng với một khách hàng tại merchant
(ví dụ: tên tài khoản, mã tài khoản,…)
merchant_account
String(255)
Địa chỉ Email chính của tài khoản NgânLượng.vn
mà merchant dùng để nhận tiền nạp vào từ thẻ cào
client_fullname
String(255)
Tên đầy đủ của khách hàng tại merchant
client_email
String(255)
Email khách hàng tại merchant
client_mobile
String(20)
Điện thoại của khách hàng tại merchant
4. Bản mô tả mã lỗi trả về
Mã lỗi
Mô tả
00
Đã xử lý thành công (thẻ đã bị gạch, tiền đã được nạp vào tài khoản của merchant)
01
Lỗi, tuy nhiên lỗi chưa được định nghĩa/không xác định
02
Lỗi, Mã website/merchant không tồn tại hoặc website/merchant đang bị khóa
03
Lỗi, Địa chỉ IP truy cập API của NgânLượng.vn bị từ chối
04
Lỗi, Mã checksum không chính xác (lỗi này thường xảy ra khi mật khẩu giao tiếp giữa merchant và NgânLượng.vn không chính xác, hoặc cách sắp xếp các tham số trong biến params không đúng)
05
Lỗi, Mã thẻ cào không chính xác hoặc đã được sử dụng
06
Lỗi, Không kết nối tới hệ thống xác thực thẻ của Telco
07
Lỗi, Tài khoản NgânLượng.vn của merchant nhận tiền nạp không tồn tại
08
Lỗi, Tài khoản NgânLượng.vn của merchant nhận tiền nạp đang bị khóa hoặc bị phong tỏa
09
Lỗi, khách hàng tương ứng với tham số ref_code bị khóa (do nhập sai mã thẻ liên tiếp nhiều lần)
10
Lỗi, thẻ bị trừ, nhưng nạp được tiền vào tài khoản NgânLượng.vn của người bán
Hướng dẫn tích hợp phiên bản 1.0 dành cho iOS
1. Khởi tạo
● Copy các files dưới đây vào project của bạn
○ libNganLuong_Payment.a
○ NganLuong.h
○ NganLuongPayment.h
○ NganLuongItem.h
○ NganLuongErrorCode.h
■ Thiết lập các thông số cần thiết cho project của bạn để có thể sử dụng được thư viện:
● Vào mục Build Settings và thiết lập các thông số sau:
○ Thiết lập thông số “Other Linker Flags” với giá trị là “-ObjC”. Như hình dưới:
○ Thiết lập thông số “Library Search Paths" trỏ vào đường dẫn của thư mục chứa những files bạn vừa copy vào project.
2. Các bước sử dụng thư viện
Tại class bạn muốn sử dụng thư viện, bạn gõ #import "NganLuong.h" tiếp đến bạn cần đăng ký delegate của NganLuongLib là "NganluongDelegate", bạn làm như sau: @interface MainViewController: UIViewController
Các khởi tạo và sử dụng các đối tượng:
/* Khởi tạo một đối tượng NganLuong bạn dùng hàm khởi tạo sau:[NganLuong nganLuongWithAppID:@"275" password:@"123456" rootController:self]; Trong đó bạn cần truyền vào ID ứng dụng bạn đã đăng ký với Ngân Lượng, mật khẩu cảu bạn và cuối cùng bạn phải truyền vào view controller mà thư viện sẽ sử dụng.Các thông số sau bắt buộc bạn phải thiết lập để sử dụng. mEnv: Đây là môi trường mà NganLuongLib sẽ làm việc, có 2 giá trị SANDBOX và LIVE.*/
nl=[NganLuong nganLuongWithAppID@"275"
password:@"123456" rootController:self];
nl.delegate = self;
nl.mEnv = SANDBOX;
/* Tiếp theo là khởi tạo một đối tượng NganLuongPayment, bạn bắt buộc phải dùng "[[NganLuongPayment alloc] initWithNganLuong:nl]", trong đó bạn phải truyền vào đối tượng NganLuong hiện thời.*/
pay.recipient = @"phuonglh@peacesoft.net"; // Email Người nhận
pay.orderCode = @"123456789"; // Mã giao dịch
/* Tiếp theo là khởi tạo các đối tượng NganLuongItem.*/
NganLuongItem*item = nil;
@try
{
for(int i = 0; i<10; i++)
{
item = [[NganLuongItem alloc]init];
item.name = [NSString stringWithFormat:@"Item %d", i];// Tên của item đã được chọn mua.
item.amount = 100000;// Giá tiền của item đó
item.itemID = 10;// ID của Item đó
item.quantity = 1;// Số lượng
[pay addItem:item]; // Bạn thêm item vào payment.
[item release];
}
}
@catch(NSException *exception)
{
NSLog(@"%@", exception.reason);
}
@finally{
}
nl.payment = pay; // Sau khi tạo xong các bước trên bạn truyền đối tượng payment vào cho đối tượng NganLuong đã được tạo ở trên.
/* NganLuonglib cung cấp cho lập trình viên một đối tượng nút bấm để người dùng tương tác. Lập trình viên có thể tuỳ chỉnh vị trí hiển thị của nút bấm và kích thước của nó. Đầu tiên cần phải xác định sẽ dùng nút bấm size là bao nhiêu, mặc định là 152x33. Để thay đổi size làm như sau:
nl.mButtonSize = BUTTON_152x33;
Danh sách các lựa chọn size:
BUTTON_152x33,
BUTTON_194x37,
BUTTON_278x43,
BUTTON_294x45,
Sau cùng bạn dùng method [nlgetButton:CGPointMake(50,50)] để lấy về button. Ở đây bạn phải truyền vào toạ độ hiển thị của button.*/
NganLuongPayment payment = new NganLuongPayment();
payment.setRecipient("merchant@example.com");
// thêm item cần bán
NganLuongItem item = new NganLuongItem();
item.setName("Item 1");
item.setQuantity(2);
item.setAmount(2000); // 2000 VND
payment.addItem(item);
final Intent intent = NganLuong.getInstance().checkout(NganLuongDemoActivity.this,
payment);
new AsyncTask() {
@Override
protected Void doInBackground(Void... params) {
startActivityForResult(intent, 1);
return null;
}
}.execute();
}
});
Trong thư viện do NgânLượng.vn cung cấp class NganLuongPayment có các hàm như sau:
1. Hàm khởi tạo ứng dụng:
public NganLuong initWithAppID(final Context ctx, final String appID, final int env)
- Context : Android context
- appID: Mã merchant hoặc mã ứng dụng bạn khai báo tại NgânLượng.vn
- env: Môi trường thanh toán, nhận một trong hai giá trị là "SANDBOX" và "LIVE"
2. Hàm lấy nút thanh toán:
public CheckoutButton getCheckoutButton(final Context ctx, final int size, final int text)
-Context: android context
- size: kích cỡ nút, đã được định nghĩa trong class NganLuong
-text: chữ trên nút, hỗ trợ PAY, DONATE
3. Hàm thiết lập ngôn ngữ trên giao diện thanh toán:
public void setLanguage(final String lang)
- lang: ngôn ngữ hiển thị, mặc định là Vn
4. Hàm thiết lập hóa đơn thanh toán:
public Intent checkout(final Context ctx, final NganLuongPayment payment)
- ctx: Android context
- payment: Mã hóa đơn do ứng dụng của bạn sinh ra
5. Hàm thiết lập loại tiền tệ thanh toán:
public void setCurrencyType(String currencyType)
- currencyType: Nhận một trong các giá trị "VND" hoặc "USD", mặc định là "VND"
6. Hàm thiết lập tài khoản nhận tiền của người bán (merchant):
public void setRecipient(String recipient)
- recipient: Địa chỉ email tài khoản NgânLượng.vn của bạn dùng để nhận tiền bán hàng
7. Hàm thiết lập tên merchant:
public void setMerchantName(String merchantName)
- merchantName: Tên merchant sẽ hiển thị tại form thanh toán của NgânLượng.vn
8. Hàm thiết lập tên hàng hóa/sản phẩm/dịch vụ:
public void addItem(NganLuongItem item)
- item: Thông tin hàng hóa (bạn có thể thêm tối đa 5 item)
9. Hàm thiết lập loại hàng hóa/dịch vụ:
public void setType(int type)
- type: Loại hàng hóa/dịch vụ, nhận một trong các giá trị "TYPE_GOODS" - hàng hóa vật chất; "TYPE_DIGITAL": hàng hóa/dịch vụ nội dung số; "TYPE_DONATE": quyên góp trực tuyến
Lớp chứa thông tin hàng hóa NganLuongItem có các hàm sau:
1. Hàm thiết lập loại hàng hóa/dịch vụ:
public void setName(String name)
- name: Tên sản phẩm/hàng hóa/dịch vụ
2. Hàm thiết lập tổng số tiền phải thông toán trong đơn hàng:
public void setAmount(double amount)
- amount: tổng số tiền trong đơn hàng phải thanh toán
3. Hàm thiết lập số lượng sản phẩm/dịch vụ trong đơn hàng:
public void setQuantity(int quantity)
- quantity: số lượng sản phẩm/dịch vụ trong đơn hàng
Các hàm sau trong class NganLuongItem không bắt buộc phải nhập:
4. Hàm thiết lập số tiền giảm giá:
public void setDiscountAmount(double discountAmount)
- discountAmount: số tiền giảm giá (mặc định bằng 0)
5. Hàm thiết lập số tiền thuế (VAT):
public void setTaxAmount(double taxAmount)
- taxAmount: Thuế VAT (mặc định bằng 0)
6. Hàm thiết lập phí vận chuyển:
public void setFeeShipping(double feeShipping)
- feeShipping: phí vận chuyển (mặc định bằng 0)
7. Hàm thiết lập tham số cho phép người dùng nhập địa chỉ vận chuyển khi thanh toán:
public void setRequestConfirmShipping(int requestConfirmShipping)
- requestConfirmShipping: Nhận giá trị '0': Không cần nhập; '1': người dùng phải nhập địa chỉ trước khi thanh toán
5- Bắt sự kiện trả về (thành công hay thất bại)
Khi thiết lập các tham số theo các hàm ở trên, bạn có thể gọi hàm sau để load form thanh toán và nhận kết quả trả về:
startActivityForResult(Intent, RequestCode);
Trong đó:
- Intent: Là một thể hiện của lớp NganLuongPayment bạn đã khai báo ở trên
- RequestCode: phân loại giữa các activity, sẽ dùng mã này để kiểm tra dữ liệu trả về
Kết thúc quá trình thanh toán, NgânLượng.vn sẽ trả về kết quả, bạn sử dụng đoạn code tương tự như sau để kiểm tra và xử lý
@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
Lấy mã HTML nút thanh toán do NgânLượng.vn cung cấp rồi lập trình theo hướng dẫn để nhúng động nút "Mua ngay" hoặc "Thanh toán" tương ứng vào từng Sản phẩm hoặc trang Hóa đơn của website bán hàng.
Bài viết sẽ hướng dẫn bạn bằng cách DEMO Video các bước lập trình tích hợp đơn giản vào một Website bán hàng mẫu bằng PHP. Khi đã nắm được cách làm thì bằng cách quy nạp, bạn có thể tự thực hiện tích hợp vào bất kỳ Website nào khác!
Giới thiệu Website mẫu, chưa tích hợp thanh toán
Website được lấy làm ví dụ gồm có 4 trang: Danh sách sản phẩm (browse.php), Chi tiết sản phẩm (detail.php), Giỏ hàng (cart.php) và Hóa đơn bán hàng (order.php); được viết một cách hết sức đơn giản nhằm mục đích DEMO nên không kết nối cơ CSDL mà được giả lập trong một mảng định nghĩa trong file Database.php
Đăng nhập NgânLượng.vn, vào Menu [ Tích hợp thanh toán ] => [ Website bán hàng B2C ] => [ Tích hợp đơn giản ], chọn mẫu nút bạn ưa thích rồi Click "Lấy mã nút nhúng" sau đó Copy đoạn HTML được cung cấp.
Ghi chú: nên chọn nút "Mua ngay" dành cho trang chi tiết sản phẩm và nút "Thanh toán" cho trang hóa đơn bán hàng.
Bước 2.1: Nhúng nút Mua ngay vào trang thông tin sản phẩm
Để lập trình nhúng nút "Mua ngay" vào trang thông tin chi tiết sản phẩm cho phép khách hàng Click chuột sang NgânLượng.vn để thanh toán ngay cho sản phẩm đó, hãy thao tác theo các bước như trong Video hướng dẫn dưới đây:
Bước 2.2: Nhúng nút Thanh toán vào trang hóa đơn bán hàng
Để lập trình nhúng nút "Thanh toán" vào trang hóa đơn bán hàng cho phép khách hàng Click chuột sang NgânLượng.vn để thanh toán cho hóa đơn đó, hãy thao tác theo các bước như trong Video hướng dẫn dưới đây:
Hãy công khai cho khách hàng biết Website bán hàng của bạn có chấp nhận thanh toán bằng NgânLượng.vn, cho phép họ thanh toán tiện lợi và được bảo vệ để tự tin mua sắm nhiều hơn. Vui lòng chọn 1 mẫu Logo dưới đây chèn vào Header, Footer, cột trái hoặc cột phải tất cả các trang của Website và đặt Link đến https://www.nganluong.vn
Nhận các thông tin cập nhật về tích hợp thanh toán.
Chăm sóc, hỗ trợ và tư vấn nâng cao hiệu quả ứng dụng TTTT.
Mời tham gia các chương trình Marketing thúc đẩy bán hàng trực tuyến.
Xét duyệt đưa lên hệ thống Mua sắm và Khuyến mại, được quảng bá đến hàng trăm nghìn người mua.
Tích hợp nâng cao
Sơ đồ tổng quan của mô hình tích hợp nâng cao
Khác với hình thức tích hợp đơn giản, vốn Website bán hàng (gọi tắt là Merchant Site) chỉ gửi sang NgânLượng.vn thông tin sản phẩm và hóa đơn KHÔNG được mã hóa khiến người mua có thể can thiệp sửa đổi nội dung, đồng thời cũng không tự động trả về kết quả thanh toán. Vì vậy khi được thông báo nhận tiền, chủ Website phải đăng nhập vào NgânLượng.vn để kiểm tra trước khi giao hàng. Tích hợp nâng cao khắc phục được hết các yếu điểm này với mô hình hoạt động như trong sơ đồ dưới đây:
Bài viết này sẽ hướng dẫn bạn bằng cách DEMO Video các bước tích hợp nâng cao vào một Merchant Site mẫu viết bằng PHP. Khi đã nắm được cách làm thì bằng cách quy nạp, bạn có thể tự thực hiện tích hợp vào bất kỳ Website nào khác!
Giới thiệu Merchant Site mẫu, chưa tích hợp thanh toán
Website được lấy làm ví dụ gồm có 4 trang: Danh sách sản phẩm (browse.php), Chi tiết sản phẩm (detail.php), Giỏ hàng (cart.php) và Hóa đơn bán hàng (order.php); được viết một cách hết sức đơn giản nhằm mục đích DEMO nên không kết nối cơ CSDL mà được giả lập trong một mảng định nghĩa trong file Database.php
Bước 1: Khai báo Merchant Site và xác minh tên miền
Đăng nhập NgânLượng.vn, vào Menu [ Tích hợp thanh toán ] => [ Website bán hàng B2C ] => [ Tích hợp nâng cao ] => [ Đăng ký Website tích hợp ], rồi nhập các thông tin theo hướng dẫn để đăng ký. Sau đó hệ thống sẽ hướng dẫn bạn các bước để xác minh bạn thật sự là chủ hoặc người đại diện của Website này nhằm tránh việc giả mạo.
Ghi chú: Sau khi khai báo, có thể quay lại trang "Danh sách Merchant Site" để xác minh bất kỳ lúc nào!
Bước 2: Lấy mã Class tích hợp NgânLượng.vn đặt vào mã nguồn Merchant Site
Download mã nguồn các Class dưới đây theo đúng môi trường lập trình của Merchant Site.
Sửa vào mã nguồn Class NL_Checkout để thay đổi giá trị các biến sau:
merchant_site_code: thay bằng mã Merchant Site của Website bán hàng đang tích hợp mà NgânLượng.vn cấp cho bạn sau khi đăng ký (xem tại trang danh sách Merchant Site).
secure_pass: thay bằng mật khẩu giao tiếp với NgânLượng.vn mà bạn đã khai báo cho Merchant Site, bạn có thể đổi mật khẩu này bất kỳ lúc nào bằng cách sửa thông tin Merchant Site.
Bước 3: Lập trình nhúng nút Thanh toán vào trang Hóa đơn bán hàng
Include Class NL_Checkout nói trên vào mã nguồn trang hóa đơn bán hàng, khởi tạo đối tượng kiểu NL_Checkout rồi truyền các tham số vào hàm buildCheckoutUrl() theo thứ tự như sau:
return_url: Sau khi thanh toán hoàn tất, NgânLượng.vn sẽ chuyển người mua (qua giao thức HTTP Redirect) cùng kết quả thanh toán được mã hóa trong URL về địa chỉ này để Merchant Site xử lý.
receiver: Địa chỉ Email chính của tài khoản nhận tiền.
transaction_info: Thông tin thêm về giao dịch thanh toán (không bắt buộc).
order_code: Mã hóa đơn (hoặc mã hoặc tên sản phẩm) cần thanh toán.
price: Tổng giá trị hóa đơn (hoặc sản phẩm) cần thanh toán.
Hàm này trả về đầu ra là mã HTML của nút thanh toán có sẵn đường Link chuyển người dùng sang NgânLượng.vn để thanh toán trong đó thông tin đơn hàng được mã hóa trong tham số SECURE_CODE, hãy đặt mã này vào vị trí phù hợp tại trang hóa đơn để hiện nút thanh toán nâng cao.
Bước 4: Lập trình trang xử lý kết quả thanh toán và cập nhật trạng thái hóa đơn
Bước 5: Lập trình Web Service nhận kết quả thanh toán
Nhược điểm của việc nhận kết quả thanh toán thông qua phương thức HTTP Redirect về địa chỉ RETURN_URL như đề cập ở bước 4 là:
1. Trường hợp một trong hai bên hoặc người mua bị lỗi đường truyền hoặc lỗi website dẫn đến hậu quả NgânLượng.vn không thể Redirect người mua cùng kết quả thanh toán được mã hóa trong URL về Merchant Site thì trạng thái hóa đơn sẽ không được cập nhật tự động.
2. Trường hợp thanh toán thành công (trạng thái hóa đơn đã được cập nhật) nhưng giao dịch thanh toán tại NgânLượng.vn sau đó bị hủy hoặc hoàn lại vì một lý do nào đó (ví dụ: người bán hủy giao dịch và trả lại tiền vì hết hàng, người mua khiếu nại NgânLượng.vn phán quyết hủy giao dịch...) thì cũng không thể tự động đồng bộ hóa với trạng thái thanh toán hóa đơn.
Để khắc phục nhược điểm trên, NgânLượng.vn cung cấp THÊM một phương thức nữa giúp đồng bộ trạng thái hóa đơn bán hàng (tại Merchant Site) với trạng thái giao dịch thanh toán (tại NgânLượng.vn) một cách tự động. Theo đó mỗi khi có sự thay đổi trạng thái giao dịch thanh toán, NgânLượng.vn sẽ tự động gọi đến một Web Service (thông qua phương thức SOAP) tại địa chỉ bạn mà đã khai báo trong trường "Web Service giao tiếp với NL" khi đăng ký Merchant Site.
Hãy lập trình Web Service này bao gồm 2 hàm với các tham số đầu vào và nội dung xử lý như sau để đón lời gọi từ NgânLượng.vn:
Tên hàm
Đầu vào
Hướng dẫn viết nội dung hàm
UpdateOrder()
Thông báo hóa đơn được thanh toán thành công
transaction_info: Thông tin thêm về giao dịch thanh toán. order_code: Mã hóa đơn được thông báo kết quả. payment_id: Mã giao dịch thanh toán tại NgânLượng.vn. payment_type: Kiểu giao dịch thanh toán [ 1 = Thanh toán ngay, 2 = Tạm giữ ]. secure_code: Tham số an ninh để bạn kiểm tra tính xác thực của lời gọi.
1. Gọi hàm mã hóa MD5 chuỗi ký tự có nội dung nối tiếp giá trị các tham số transaction_info,order_code, payment_id, payment_type và biếnsecure_pass
(xem bước 2) cách nhau bởi một khoảng trắng (space).
2. So sánh kết quả mã hóa với giá trị của tham số đầu vào secure_code nhận được
từ tham số truyền vào, nếu giống nhau hoàn toàn thì tức là hóa đơn bán hàng
mã order_code đã được thanh toán.
RefundOrder()
Thông báo giao dịch thanh toán bị hoàn lại
$passcode: Là mật khẩu khi đăng ký merchant site.
$refund_type: Sẽ nhận giái trị là: 1 = hoàn trả một phần, 2 = hoàn trả toàn bộ.
$refund_amount: Số tiền hoàn trả (số tiền hoàn trả nhỏ hơn hoặc bằng số tiền thanh toán).
$refund_description: Lý do hoàn trả số tiền.
$payment_id: Mã giao dịch hoàn tiền.
$order_code: Mã đơn hàng bên phía merchant_site.
$transaction_info: Giá trị này được merchant site gửi sang khi gửi yêu cầu thanh toán.
1. Gọi hàm mã hóa MD5 chuỗi ký tự có nội dung nối tiếp giá trị của các tham số transaction_info,order_code, payment_id, refund_payment_id, refund_amount, refund_type, refund_descriptionvà biến passcode (xem bước 2) cách nhau bởi một khoảng trắng (space).
2. So sánh kết quả mã hóa với giá trị của tham số đầu vào secure_code, nếu giống nhau hoàn toàn thì tức là giao dịch NL có mã payment_id thanh toán cho hóa đơn bán hàng mã order_code đã bị hoàn lại.
Ví dụ nội dung hàm UpdateOrder()
$my_code = md5(transaction_info . ' ' . $order_code . ' ' . $payment_id . ' ' . $payment_type . ' ' . $secure_pass);
if ($my_code == $secure_code)
{
CẬP NHẬT TRẠNG THÁI HÓA ĐƠN MÃ ORDER_CODE THÀNH ĐÃ THANH TOÁN;
}
Hãy công khai cho khách hàng biết Website bán hàng của bạn có chấp nhận thanh toán bằng NgânLượng.vn, cho phép họ thanh toán tiện lợi và được bảo vệ để tự tin mua sắm nhiều hơn. Vui lòng chọn 1 mẫu Logo dưới đây chèn vào Header, Footer, cột trái hoặc cột phải tất cả các trang của Website và đặt Link đến https://www.nganluong.vn
