Integració perfecta de Moneris Checkout: resolució de problemes de resposta JSON
Moneris Checkout és un sistema de passarel·la de pagament d'ús habitual que ajuda les empreses a accelerar les transaccions en línia. Tanmateix, pot ser difícil integrar-lo al vostre lloc web, sobretot quan les dades necessàries, com ara un número de bitllet, no es retornen d'una trucada JSON. Aquests errors poden impedir el flux regular de transaccions, de manera que la depuració és una habilitat necessària per als enginyers.
Entendre com configurar correctament el pagament és fonamental quan es substitueix una pàgina de pagament allotjada (HPP) obsoleta per Moneris i s'utilitza la seva interfície de JavaScript. Per oferir als vostres clients una experiència perfecta, assegureu-vos que la pàgina publici els detalls de la transacció i obtingui respostes precises.
Molts desenvolupadors tenen problemes per seguir la documentació d'integració de Moneris. La complexitat deriva de la gestió de les devolucions de trucada, la càrrega de dades de transaccions i la lectura dels resultats en temps real, tot això necessari per a una integració exitosa. Quan comenceu el vostre viatge d'integració, pot ser beneficiós tenir una metodologia clara i ben documentada.
En aquesta publicació, veurem com resoldre el problema dels números de bitllet que falten a la vostra integració de Moneris. Estaràs millor preparat per fer front a aquest problema si reviseu els fragments de codi i les tècniques de resolució de problemes necessaris.
| Comandament | Exemple d'ús |
|---|---|
| monerisCheckout() | Aquesta és la funció de constructor de l'SDK de JavaScript de Moneris. Inicia el procediment de pagament. Aquest script genera una nova instància del giny de pagament de Moneris, que us permet inserir la passarel·la de pagament al vostre lloc web. |
| setMode() | Especifica l'entorn per a la transacció de Moneris. En aquest exemple, "qa" fa referència a un entorn de prova en què podeu simular transaccions de manera segura sense processar pagaments reals. Això és necessari per provar la integració sense carregar realment les targetes. |
| setCheckoutDiv() | Aquesta ordre associa el pagament de Moneris amb un contenidor HTML especificat (div). En proporcionar l'identificador "monerisCheckout", el giny de pagament es mostra dins d'aquest div, que us permet seleccionar on apareix el formulari a la pàgina. |
| setCallback() | Durant el procés de pagament, assigneu una funció a un esdeveniment específic. En aquest escenari, la funció personalitzada "myPageLoad" gestiona l'esdeveniment "page_loaded", permetent als desenvolupadors executar codi quan la pàgina de pagament està completament carregada. |
| startCheckout() | Comenceu el procés de pagament de Moneris. Quan es crida, aquesta funció inicia el flux de pagament mostrant el formulari de pagament i connectant-lo al sistema de fons per processar transaccions. |
| app.post() | Aquest és un gestor de rutes Express.js que gestiona les sol·licituds POST. Aquest script rep els rebuts de pagament del backend de Moneris un cop finalitzada una transacció, la qual cosa permet un processament addicional, com ara conservar les dades de pagament o emetre confirmacions. |
| bodyParser.json() | Una funció de middleware a Express per analitzar les sol·licituds JSON entrants. És especialment crític en aquest cas perquè Moneris transmet dades de transaccions en format JSON. Aquesta ordre garanteix que el cos de la sol·licitud es processa correctament per al processament del servidor. |
| chai.request() | Aquesta ordre forma part del paquet de proves HTTP Chai que envia sol·licituds HTTP dins dels casos de prova. Replica les sol·licituds POST a l'API de pagament de Moneris durant la prova d'unitat, permetent al desenvolupador veure com el backend gestiona les transaccions reeixides i fallides. |
| expect() | Una funció bàsica d'afirmació a la biblioteca Chai. En el context de les proves unitàries, determina si es compleixen condicions particulars. S'utilitza per garantir que l'estat de resposta i el missatge retornats pel punt final de pagament coincideixen amb els resultats previstos. |
Entendre la integració de Moneris Checkout i el flux de treball de script
L'script frontal inclòs integra el sistema Moneris Checkout en un lloc web mitjançant JavaScript. La funcionalitat principal comença amb l'establiment d'una instància de pagament de Moneris a través de monerisCheckout() constructor. Aquesta instància serveix com a interfície entre el vostre lloc web i el servei de processament de pagaments de Moneris. La comanda setMode() especifica si l'entorn s'ha de configurar a "qa" per a les proves o "en directe" per a la producció, que és fonamental durant les etapes de desenvolupament. En seleccionar "qa", els desenvolupadors poden replicar transaccions sense incórrer en costos reals, creant un camp de proves segur.
Un cop construïda la instància de pagament, el setCheckoutDiv() L'ordre connecta el formulari de pagament de Moneris a un div HTML específic. Aquí és on apareixerà el formulari de pagament a la pàgina. Això garanteix que la representació visual del formulari de pagament es mostri en una regió específica del lloc web, fent que el procediment sigui fluid i integrat al vostre disseny existent. En el nostre exemple, el formulari de Moneris s'insereix al div amb l'identificador "monerisCheckout". Aquest div serveix com a marcador de posició per al contingut carregat dinàmicament de Moneris, que inclou camps i botons d'entrada de pagament del client.
Llavors s'executa l'script setCallback(), que permet al desenvolupador configurar la gestió d'esdeveniments específics per al procés de pagament. Concretament, la devolució de trucada per a "page_loaded" s'adjunta a la funció myPageLoad, que garanteix que quan la pàgina està completament carregada, es poden produir accions personalitzades addicionals (com ara dades de registre). Aquesta funció permet flexibilitat en com es gestiona l'experiència de l'usuari. Registre del contingut del ex objecte dins myPageLoad() ajuda els desenvolupadors a depurar proporcionant comentaris en temps real sobre les dades que Moneris retorna.
Finalment, l'script de fons gestiona la recepció de dades de pagament al costat del servidor. Utilitzant Express.js a Node.js, la ruta app.post() està definit per rebre sol·licituds POST de Moneris un cop finalitzada la transacció. Aquest punt final processa el JSON retornat, comprovant el codi_resposta per veure si el pagament ha estat satisfactori. Si té èxit, les dades de la transacció (com ara el número de bitllet) es poden registrar o introduir en una base de dades. En retornar els codis i missatges d'estat adequats, el backend permet una connexió fluida amb el frontend, proporcionant comentaris crítics a l'usuari, com ara si la transacció ha estat correcta o ha fallat.
Integració de Moneris Checkout amb JavaScript: solucions front-end i back-end
Solució frontal que utilitza JavaScript per incorporar el formulari de pagament de Moneris i gestionar les respostes de transaccions.
// 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>
Solució back-end amb Node.js i Express: gestió de dades de pagament
Solució de fons que utilitza Node.js i Express per gestionar les dades de postpagament de 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');});
Unitat de prova de la gestió de pagaments de fons amb Mocha i Chai
Proves d'unitat de fons amb Mocha i Chai per validar la funcionalitat de gestió de diners
// 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();});});});
Millora de la integració de Moneris Checkout amb les opcions de personalització
Quan treballen amb la integració de Moneris Checkout, els desenvolupadors sovint busquen mètodes per personalitzar el procés de pagament per millorar l'experiència de l'usuari. El formulari de pagament Components de la IU es pot personalitzar, que és una funció menys coneguda. Moneris permet a les empreses personalitzar l'aparença i el disseny de la pàgina de pagament, cosa que els permet alinear-la amb la seva marca. Això implica modificar la disposició dels botons, els camps del formulari i fins i tot la redacció per facilitar el procés als usuaris finals i augmentar les conversions.
Un altre factor a examinar és l'ús de tipus de transaccions diferents dels pagaments bàsics. Moneris té capacitats com ara la preautorització, en què l'import de la transacció s'emmagatzema a la targeta però no es cobra immediatament. Aquesta funcionalitat és especialment important en àrees com ara hotels i lloguer d'automòbils, on les tarifes finals poden diferir. La integració pot gestionar molts tipus de transaccions utilitzant el mateix API, fent-lo versàtil per a diversos casos d'ús.
La seguretat és una prioritat en qualsevol integració de pagaments i Moneris Checkout incorpora tecnologies com la tokenització i la prevenció del frau. La tokenització substitueix la informació confidencial de la targeta per un testimoni, de manera que les dades dels consumidors mai s'exposen als vostres sistemes. La implementació de mesures de seguretat, com ara les tecnologies de detecció de fraus i el compliment de PCI DSS, pot reduir dràsticament els riscos relacionats amb les transaccions en línia.
Preguntes habituals sobre la integració de Moneris Checkout
- Què és Moneris Checkout?
- Moneris Checkout és una solució de passarel·la de pagament que permet a les empreses acceptar pagaments de manera segura a través del seu lloc web. Ofereix formularis de pagament personalitzables i accepta diverses maneres de pagament.
- Com puc personalitzar el formulari de pagament de Moneris?
- L'API de Moneris us permet personalitzar el disseny del formulari de pagament canviant elements com ara botons i camps d'entrada. Utilitzeu ordres com setCustomStyle() per afegir l'estil de la vostra marca al formulari.
- Quina és la importància de posar l'entorn a "qa"?
- Configurant l'entorn a "qa" amb setMode("qa") us permet provar transaccions de manera segura sense processar pagaments reals.
- Com puc gestionar una transacció de preautorització?
- Per gestionar la preautorització, incloeu el action: "preauth" argument a la vostra sol·licitud JSON. Això mantindrà la targeta del client en lloc de carregar-la immediatament.
- Quines són les mesures de seguretat que ofereix Moneris Checkout?
- Moneris admet la tokenització, que substitueix la informació sensible de la targeta de crèdit per un testimoni. Compliment de PCI DSS assegura que la vostra integració compleix els requisits de seguretat de la indústria.
Consideracions finals sobre la integració de Moneris Checkout
Per integrar amb èxit Moneris Checkout amb JavaScript, s'han de planificar acuradament tant la configuració del front-end com del back-end. Proporcionar una bona experiència de pagament per als usuaris requereix assegurar-se que els detalls de la transacció, com ara el número de bitllet, es capturen adequadament.
Les proves en un entorn de control de qualitat i l'estructuració adequada del vostre formulari de pagament us ajudaran a detectar els problemes amb antelació. Amb la tècnica correcta, podeu crear un procediment de pagament sense problemes i segur que s'adapti als objectius de la vostra empresa alhora que garanteix la felicitat del client.
Referències i recursos per a la integració de Moneris Checkout
- Aquest article es basa en la documentació d'integració de Moneris Checkout i la referència de l'API. Per obtenir informació més detallada, visiteu el dipòsit oficial de GitHub de Moneris: Moneris Checkout GitHub .
- Al portal de desenvolupadors de Moneris podeu trobar una guia addicional sobre com configurar integracions de pagament basades en JavaScript: Portal de desenvolupadors de Moneris .
- Per obtenir les millors pràctiques sobre la gestió de trucades JSON i la captura de respostes de transaccions, consulteu la documentació de l'SDK de JavaScript: SDK de JavaScript de Moneris .