Tích hợp liền mạch của Moneris Checkout: Khắc phục sự cố phản hồi JSON
Moneris Checkout là hệ thống cổng thanh toán được sử dụng phổ biến để giúp các doanh nghiệp đẩy nhanh các giao dịch trực tuyến. Tuy nhiên, việc tích hợp nó vào trang web của bạn có thể khó khăn, đặc biệt khi dữ liệu bắt buộc, chẳng hạn như số vé, không được trả về từ lệnh gọi JSON. Những lỗi như vậy có thể cản trở luồng giao dịch thường xuyên, vì vậy việc gỡ lỗi là một kỹ năng cần thiết đối với các kỹ sư.
Hiểu cách định cấu hình thanh toán đúng cách là rất quan trọng khi thay thế Trang thanh toán được lưu trữ (HPP) đã lỗi thời bằng Moneris và sử dụng giao diện JavaScript của chúng. Để cung cấp cho khách hàng của bạn trải nghiệm liền mạch, hãy đảm bảo rằng trang đăng chi tiết giao dịch và truy xuất phản hồi chính xác.
Nhiều nhà phát triển gặp khó khăn khi làm theo tài liệu tích hợp của Moneris. Sự phức tạp bắt nguồn từ việc xử lý lệnh gọi lại, tải dữ liệu giao dịch lên và đọc kết quả trong thời gian thực, tất cả đều cần thiết để tích hợp thành công. Khi bạn bắt đầu hành trình tích hợp của mình, việc có một phương pháp luận rõ ràng và được ghi chép đầy đủ có thể sẽ mang lại lợi ích.
Trong bài đăng này, chúng ta sẽ xem xét cách giải quyết vấn đề thiếu số vé trong quá trình tích hợp Moneris của bạn. Bạn sẽ được chuẩn bị tốt hơn để giải quyết vấn đề này nếu bạn xem lại các đoạn mã cần thiết và kỹ thuật khắc phục sự cố.
| Yêu cầu | Ví dụ về sử dụng |
|---|---|
| monerisCheckout() | Đây là hàm xây dựng từ SDK JavaScript của Moneris. Nó bắt đầu thủ tục thanh toán. Tập lệnh này tạo một phiên bản mới của tiện ích thanh toán Moneris, cho phép bạn nhúng cổng thanh toán vào trang web của mình. |
| setMode() | Chỉ định môi trường cho giao dịch Moneris. Trong ví dụ này, "qa" đề cập đến môi trường thử nghiệm trong đó bạn có thể mô phỏng các giao dịch một cách an toàn mà không cần xử lý các khoản thanh toán thực tế. Điều này là cần thiết để kiểm tra sự tích hợp mà không thực sự tính phí vào thẻ. |
| setCheckoutDiv() | Lệnh này liên kết quy trình thanh toán Moneris với vùng chứa HTML (div) được chỉ định. Bằng cách cung cấp ID "monerisCheckout", tiện ích thanh toán được hiển thị trong div này, cho phép bạn chọn vị trí biểu mẫu xuất hiện trên trang. |
| setCallback() | Trong quá trình thanh toán, hãy chỉ định chức năng cho một sự kiện cụ thể. Trong trường hợp này, hàm tùy chỉnh "myPageLoad" xử lý sự kiện "page_loaded", cho phép nhà phát triển chạy mã khi trang thanh toán được tải hoàn toàn. |
| startCheckout() | Bắt đầu quá trình thanh toán Moneris. Khi được gọi, hàm này bắt đầu luồng thanh toán bằng cách hiển thị biểu mẫu thanh toán và kết nối nó với hệ thống phụ trợ để xử lý giao dịch. |
| app.post() | Đây là trình xử lý tuyến Express.js xử lý các yêu cầu POST. Tập lệnh này nhận biên lai thanh toán từ chương trình phụ trợ của Moneris sau khi giao dịch kết thúc, cho phép xử lý bổ sung như lưu giữ dữ liệu thanh toán hoặc đưa ra xác nhận. |
| bodyParser.json() | Một hàm phần mềm trung gian trong Express để phân tích cú pháp các yêu cầu JSON gửi đến. Điều này đặc biệt quan trọng trong trường hợp này vì Moneris truyền dữ liệu giao dịch ở định dạng JSON. Lệnh này đảm bảo rằng nội dung yêu cầu được xử lý chính xác để xử lý phía máy chủ. |
| chai.request() | Lệnh này là một phần của gói thử nghiệm Chai HTTP gửi yêu cầu HTTP trong các trường hợp thử nghiệm. Nó sao chép các yêu cầu POST tới API thanh toán Moneris trong quá trình thử nghiệm đơn vị, cho phép nhà phát triển xem cách phần phụ trợ xử lý các giao dịch thành công và thất bại. |
| expect() | Một hàm xác nhận cốt lõi trong thư viện Chai. Trong bối cảnh kiểm tra đơn vị, nó xác định liệu các điều kiện cụ thể có được thỏa mãn hay không. Nó được sử dụng để đảm bảo rằng trạng thái phản hồi và thông báo do điểm cuối thanh toán trả về khớp với kết quả dự kiến. |
Tìm hiểu quy trình tích hợp và tập lệnh thanh toán Moneris
Tập lệnh giao diện người dùng đi kèm sẽ tích hợp hệ thống Moneris Checkout vào một trang web thông qua JavaScript. Chức năng chính bắt đầu bằng việc thiết lập một phiên bản thanh toán Moneris thông qua người xây dựng. Phiên bản này đóng vai trò là giao diện giữa trang web của bạn và dịch vụ xử lý thanh toán của Moneris. Lệnh chỉ định xem môi trường nên được đặt thành "qa" để thử nghiệm hay "trực tiếp" cho sản xuất, điều này rất quan trọng trong các giai đoạn phát triển. Bằng cách chọn "qa", các nhà phát triển có thể sao chép các giao dịch mà không phải chịu chi phí thực tế, tạo ra một nền tảng thử nghiệm an toàn.
Sau khi phiên bản thanh toán được tạo, lệnh kết nối biểu mẫu thanh toán Moneris với một div HTML cụ thể. Đây là nơi hình thức thanh toán sẽ xuất hiện trên trang. Điều này đảm bảo rằng mô tả trực quan của hình thức thanh toán hiển thị ở một khu vực cụ thể của trang web, giúp quy trình trở nên liền mạch và được tích hợp vào thiết kế hiện tại của bạn. Trong ví dụ của chúng tôi, biểu mẫu Moneris được chèn vào div có ID "monerisCheckout". Div này đóng vai trò giữ chỗ cho nội dung được tải động của Moneris, bao gồm các trường và nút nhập thanh toán của khách hàng.
Kịch bản sau đó thực thi , cho phép nhà phát triển định cấu hình xử lý sự kiện cụ thể cho quy trình thanh toán. Cụ thể, lệnh gọi lại cho "page_loaded" được gắn vào hàm , đảm bảo rằng khi trang được tải đầy đủ, các hành động tùy chỉnh bổ sung (chẳng hạn như ghi dữ liệu) có thể xảy ra. Chức năng này cho phép linh hoạt trong cách xử lý trải nghiệm người dùng. Ghi lại nội dung của đối tượng bên trong myPageLoad() hỗ trợ các nhà phát triển gỡ lỗi bằng cách cung cấp phản hồi theo thời gian thực về dữ liệu mà Moneris trả về.
Cuối cùng, tập lệnh back-end xử lý việc nhận dữ liệu thanh toán phía máy chủ. sử dụng trong Node.js, tuyến đường được xác định để nhận các yêu cầu POST từ Moneris sau khi giao dịch hoàn tất. Điểm cuối này xử lý JSON được trả về, kiểm tra để xem thanh toán có thành công hay không. Nếu thành công, dữ liệu giao dịch (chẳng hạn như số vé) có thể được ghi lại hoặc nhập vào cơ sở dữ liệu. Bằng cách trả về mã trạng thái và thông báo phù hợp, phần phụ trợ cho phép kết nối suôn sẻ với giao diện người dùng, cung cấp phản hồi quan trọng cho người dùng, chẳng hạn như giao dịch thành công hay thất bại.
Tích hợp Moneris Checkout với JavaScript: Giải pháp Front-End và Back-End
Giải pháp giao diện người dùng sử dụng JavaScript để kết hợp biểu mẫu Moneris Checkout và xử lý phản hồi giao dịch.
// Front-end integration script// This script embeds the Moneris checkout and processes the transaction result<script src="https://gatewayt.moneris.com/chktv2/js/chkt_v2.00.js"></script><div id="monerisCheckout"></div><script>var myCheckout = new monerisCheckout();myCheckout.setMode("qa"); // Set environment to QAmyCheckout.setCheckoutDiv("monerisCheckout"); // Define div for checkout// Add callback for when the page is fully loadedmyCheckout.setCallback("page_loaded", myPageLoad);// Start the checkout processmyCheckout.startCheckout("");// Function that gets triggered when the page is loadedfunction myPageLoad(ex) {console.log("Checkout page loaded", ex);}// Function to handle the receipt after the paymentfunction myPaymentReceipt(ex) {if(ex.response_code === '00') {alert("Transaction Successful: " + ex.ticket);} else {alert("Transaction Failed: " + ex.message);}}</script>
Giải pháp Back-End với Node.js và Express: Xử lý dữ liệu thanh toán
Giải pháp back-end sử dụng Node.js và Express để quản lý dữ liệu thanh toán sau của Moneris
// Node.js backend script for processing payment receipt data// This backend handles the response from Moneris and processes it for database storageconst express = require('express');const bodyParser = require('body-parser');const app = express();app.use(bodyParser.json());app.use(bodyParser.urlencoded({ extended: true }));// Endpoint to receive the payment resultapp.post('/payment-receipt', (req, res) => {const paymentData = req.body;if (paymentData.response_code === '00') {console.log('Payment successful:', paymentData.ticket);// Insert into database or further process the paymentres.status(200).send('Payment success');} else {console.error('Payment failed:', paymentData.message);res.status(400).send('Payment failed');}});app.listen(3000, () => {console.log('Server running on port 3000');});
Đơn vị kiểm tra việc xử lý thanh toán phụ trợ với Mocha và Chai
Kiểm tra đơn vị phụ trợ với Mocha và Chai để xác thực chức năng xử lý tiền
// Unit test for the Node.js backend using Mocha and Chai// This test checks if the backend properly handles successful and failed transactionsconst chai = require('chai');const chaiHttp = require('chai-http');const app = require('../app');const expect = chai.expect;chai.use(chaiHttp);describe('POST /payment-receipt', () => {it('should return 200 for successful payment', (done) => {chai.request(app).post('/payment-receipt').send({ response_code: '00', ticket: '123456' }).end((err, res) => {expect(res).to.have.status(200);expect(res.text).to.equal('Payment success');done();});});it('should return 400 for failed payment', (done) => {chai.request(app).post('/payment-receipt').send({ response_code: '01', message: 'Transaction Declined' }).end((err, res) => {expect(res).to.have.status(400);expect(res.text).to.equal('Payment failed');done();});});});
Tăng cường tích hợp Moneris Checkout với các tùy chọn tùy chỉnh
Khi làm việc với tiện ích tích hợp Moneris Checkout, các nhà phát triển thường xuyên tìm kiếm các phương pháp cá nhân hóa quy trình thanh toán nhằm cải thiện trải nghiệm người dùng. Mẫu thanh toán của có thể được tùy chỉnh, đây là một chức năng ít được biết đến hơn. Moneris cho phép các doanh nghiệp tùy chỉnh giao diện và bố cục của trang thanh toán, cho phép họ điều chỉnh nó phù hợp với thương hiệu của mình. Điều này liên quan đến việc sửa đổi bố cục nút, trường biểu mẫu và thậm chí cả cách diễn đạt để giúp người dùng cuối thực hiện quy trình dễ dàng hơn và tăng chuyển đổi.
Một yếu tố khác cần kiểm tra là việc sử dụng các loại giao dịch khác ngoài thanh toán cơ bản. Moneris có các khả năng như ủy quyền trước, trong đó số tiền giao dịch được lưu trữ trên thẻ nhưng không bị tính phí ngay lập tức. Chức năng này đặc biệt quan trọng trong các lĩnh vực như khách sạn và cho thuê ô tô, nơi mức giá cuối cùng có thể khác nhau. Việc tích hợp có thể xử lý nhiều loại giao dịch bằng cách sử dụng cùng một , làm cho nó linh hoạt cho các trường hợp sử dụng khác nhau.
Bảo mật là ưu tiên hàng đầu trong mọi hoạt động tích hợp thanh toán và Moneris Checkout kết hợp các công nghệ như mã hóa và ngăn chặn gian lận. Mã thông báo thay thế thông tin thẻ nhạy cảm bằng mã thông báo, do đó dữ liệu người tiêu dùng không bao giờ bị lộ trên hệ thống của bạn. Việc triển khai các biện pháp bảo mật, chẳng hạn như công nghệ phát hiện gian lận và tuân thủ PCI DSS, có thể giảm đáng kể rủi ro liên quan đến giao dịch trực tuyến.
- Thanh toán Moneris là gì?
- Moneris Checkout là giải pháp cổng thanh toán cho phép các doanh nghiệp chấp nhận thanh toán một cách an toàn thông qua trang web của họ. Nó cung cấp các hình thức thanh toán có thể tùy chỉnh và chấp nhận nhiều cách thanh toán khác nhau.
- Làm cách nào tôi có thể tùy chỉnh biểu mẫu Thanh toán Moneris?
- API Moneris cho phép bạn tùy chỉnh thiết kế của biểu mẫu thanh toán bằng cách thay đổi các thành phần như nút và trường nhập. Sử dụng các lệnh như để thêm phong cách thương hiệu của bạn vào biểu mẫu.
- Tầm quan trọng của việc đặt môi trường thành "qa" là gì?
- Đặt môi trường thành "qa" với cho phép bạn kiểm tra các giao dịch một cách an toàn mà không cần xử lý các khoản thanh toán thực.
- Làm cách nào để xử lý giao dịch ủy quyền trước?
- Để quản lý việc ủy quyền trước, hãy bao gồm đối số trong yêu cầu JSON của bạn. Điều này sẽ khiến thẻ của khách hàng bị giữ lại thay vì tính phí ngay lập tức.
- Các biện pháp bảo mật được Moneris Checkout cung cấp là gì?
- Moneris hỗ trợ mã thông báo, thay thế thông tin thẻ tín dụng nhạy cảm bằng mã thông báo. Tuân thủ đảm bảo rằng sự tích hợp của bạn đáp ứng các yêu cầu bảo mật của ngành.
Để tích hợp thành công Moneris Checkout với JavaScript, cả thiết lập giao diện người dùng và mặt sau đều phải được lên kế hoạch cẩn thận. Việc cung cấp trải nghiệm thanh toán tốt cho người dùng đòi hỏi phải đảm bảo rằng các chi tiết giao dịch, chẳng hạn như số vé, được ghi lại một cách thích hợp.
Thử nghiệm trong môi trường QA và cấu trúc hợp lý hình thức thanh toán của bạn sẽ giúp bạn phát hiện sớm vấn đề. Với kỹ thuật chính xác, bạn có thể tạo quy trình thanh toán liền mạch và an toàn, phù hợp với mục tiêu của công ty bạn đồng thời đảm bảo sự hài lòng của khách hàng.
- Bài viết này dựa trên tài liệu tham khảo API và tích hợp Moneris Checkout. Để biết thêm thông tin chi tiết, hãy truy cập kho lưu trữ Moneris GitHub chính thức: Thanh toán Moneris GitHub .
- Bạn có thể tìm thấy hướng dẫn bổ sung về cách thiết lập tích hợp thanh toán dựa trên JavaScript trên cổng thông tin dành cho nhà phát triển Moneris: Cổng thông tin dành cho nhà phát triển Moneris .
- Để biết các phương pháp hay nhất về cách xử lý lệnh gọi JSON và thu thập phản hồi giao dịch, hãy tham khảo tài liệu SDK JavaScript: SDK JavaScript của Moneris .