Sømløs integrasjon av Moneris Checkout: Feilsøking av JSON-svar
Moneris Checkout er et ofte brukt betalingsgateway-system som hjelper bedrifter med å fremskynde netttransaksjoner. Det kan imidlertid være vanskelig å integrere den på nettstedet ditt, spesielt når nødvendige data, for eksempel et billettnummer, ikke returneres fra et JSON-anrop. Slike feil kan hindre den vanlige flyten av transaksjoner, så feilsøking er en nødvendig ferdighet for ingeniører.
Det er avgjørende å forstå hvordan du konfigurerer kassen på riktig måte når du erstatter en utdatert Hosted Payment Page (HPP) med Moneris og bruker JavaScript-grensesnittet. For å gi kundene dine en sømløs opplevelse, sørg for at siden legger ut transaksjonsdetaljer og henter nøyaktige svar.
Mange utviklere har problemer med å følge integrasjonsdokumentasjonen til Moneris. Kompleksiteten kommer fra håndtering av tilbakeringinger, opplasting av transaksjonsdata og lesing av resultater i sanntid, som alt er nødvendig for en vellykket integrasjon. Når du begynner på integreringsreisen, kan det være en fordel å ha en klar og godt dokumentert metodikk.
I dette innlegget skal vi se på hvordan du løser problemet med manglende billettnummer i Moneris-integrasjonen din. Du vil være bedre forberedt til å håndtere dette problemet hvis du ser gjennom de nødvendige kodebitene og feilsøkingsteknikkene.
| Kommando | Eksempel på bruk |
|---|---|
| monerisCheckout() | Dette er konstruktørfunksjonen fra Moneris JavaScript SDK. Det starter utsjekkingsprosedyren. Dette skriptet genererer en ny forekomst av Moneris-kassewidgeten, som lar deg bygge inn betalingsgatewayen på nettstedet ditt. |
| setMode() | Spesifiserer miljøet for Moneris-transaksjonen. I dette eksemplet refererer "qa" til et testmiljø der du sikkert kan simulere transaksjoner uten å behandle faktiske betalinger. Dette er nødvendig for å teste integrasjonen uten å faktisk lade kortene. |
| setCheckoutDiv() | Denne kommandoen knytter Moneris-kassen til en spesifisert HTML-beholder (div). Ved å oppgi ID "monerisCheckout", vises betalingswidgeten i denne divisjonen, slik at du kan velge hvor skjemaet skal vises på siden. |
| setCallback() | Under betalingsprosessen, tilordne en funksjon til en bestemt hendelse. I dette scenariet håndterer den tilpassede funksjonen "myPageLoad" hendelsen "page_loaded", slik at utviklere kan kjøre kode når betalingssiden er fullstendig lastet. |
| startCheckout() | Begynn Moneris betalingsprosessen. Når den kalles opp, starter denne funksjonen betalingsflyten ved å gjengi betalingsskjemaet og koble det til backend-systemet for behandling av transaksjoner. |
| app.post() | Dette er en Express.js-rutebehandler som håndterer POST-forespørsler. Dette skriptet mottar betalingskvitteringer fra Moneris-støtten etter at en transaksjon er fullført, noe som gir mulighet for ytterligere behandling som å bevare betalingsdata eller utstede bekreftelser. |
| bodyParser.json() | En mellomvarefunksjon i Express for å analysere innkommende JSON-forespørsler. Det er spesielt viktig i dette tilfellet fordi Moneris overfører transaksjonsdata i JSON-format. Denne kommandoen garanterer at forespørselsteksten er korrekt behandlet for behandling på serversiden. |
| chai.request() | Denne kommandoen er en del av Chai HTTP-testpakken som sender HTTP-forespørsler i testtilfeller. Den replikerer POST-forespørsler til Moneris betalings-API under enhetstesten, slik at utvikleren kan se hvordan backend håndterer vellykkede og mislykkede transaksjoner. |
| expect() | En kjernefunksjon i Chai-biblioteket. I sammenheng med enhetstester avgjør den om spesielle betingelser er oppfylt. Den brukes til å sikre at svarstatusen og meldingen som returneres av betalingsendepunktet samsvarer med de tiltenkte utfallene. |
Forstå Moneris Checkout-integrasjon og skriptarbeidsflyt
Front-end-skriptet som følger med integrerer Moneris Checkout-systemet i et nettsted via JavaScript. Den primære funksjonaliteten begynner med å etablere en forekomst av Moneris-kassen gjennom MonerisCheckout() konstruktør. Denne forekomsten fungerer som et grensesnitt mellom nettstedet ditt og Moneris sin betalingsbehandlingstjeneste. Kommandoen setMode() spesifiserer om miljøet skal settes til "qa" for testing eller "live" for produksjon, noe som er kritisk under utviklingsstadier. Ved å velge «qa» kan utviklere replikere transaksjoner uten å pådra seg kostnader i den virkelige verden, noe som skaper et trygt testområde.
Når betalingsforekomsten er bygget, vil setCheckoutDiv() kommandoen kobler Moneris-kasseskjemaet til en bestemt HTML-div. Det er her betalingsskjemaet vil vises på siden. Dette garanterer at den visuelle avbildningen av betalingsskjemaet vises i en bestemt region på nettstedet, noe som gjør prosedyren sømløs og integrert i ditt eksisterende design. I vårt eksempel er Moneris-skjemaet satt inn i div med IDen "monerisCheckout." Denne div fungerer som en plassholder for Moneris sitt dynamisk lastede innhold, som inkluderer inndatafelter og knapper for klientbetaling.
Skriptet kjøres deretter setCallback(), slik at utvikleren kan konfigurere spesifikk hendelseshåndtering for utsjekkingsprosessen. Nærmere bestemt er tilbakeringingen for "page_loaded" knyttet til funksjonen myPageLoad, som garanterer at når siden er fullastet, kan ekstra egendefinerte handlinger (som loggingsdata) forekomme. Denne funksjonen gir fleksibilitet i hvordan brukeropplevelsen håndteres. Logging av innholdet i eks objekt innenfor myPageLoad() hjelper utviklere med feilsøking ved å gi tilbakemelding i sanntid på dataene Moneris returnerer.
Til slutt håndterer back-end-skriptet mottak av betalingsdata på serversiden. Bruker Express.js i Node.js, ruten app.post() er definert til å motta POST-forespørsler fra Moneris når transaksjonen er fullført. Dette endepunktet behandler den returnerte JSON-en og sjekker response_code for å se om betalingen var vellykket. Hvis det lykkes, kan transaksjonsdataene (som billettnummeret) logges eller legges inn i en database. Ved å returnere passende statuskoder og meldinger, muliggjør backend jevn tilkobling med frontend, og gir kritisk tilbakemelding til brukeren, for eksempel om transaksjonen lyktes eller mislyktes.
Moneris Checkout-integrasjon med JavaScript: Front-End- og Back-End-løsninger
Front-end-løsning som bruker JavaScript for å inkludere Moneris Checkout-skjemaet og håndtere transaksjonssvar.
// 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>
Back-end-løsning med Node.js og Express: Håndtering av betalingsdata
Back-end-løsning som bruker Node.js og Express for å administrere Moneris' etterbetalingsdata
// 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');});
Enhetstesting av betalingshåndtering med Mocha og Chai
Backend-enhetstesting med Mocha og Chai for å validere pengehåndteringsfunksjonalitet
// 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();});});});
Forbedrer Moneris Checkout-integrasjon med tilpasningsalternativer
Når de jobber med Moneris Checkout-integrasjonen, ser utviklere ofte etter metoder for å tilpasse betalingsprosessen for å forbedre brukeropplevelsen. Kasseskjemaet er UI-komponenter kan tilpasses, som er en mindre kjent funksjon. Moneris lar bedrifter tilpasse utseendet og utformingen av betalingssiden, slik at de kan tilpasse den etter merkevarebyggingen deres. Dette innebærer å endre knappeoppsett, skjemafelt og til og med ordlyden for å gjøre prosessen enklere for sluttbrukere og øke konverteringene.
En annen faktor å undersøke er bruken av andre transaksjonstyper enn grunnleggende betalinger. Moneris har funksjoner som forhåndsgodkjenning, der et transaksjonsbeløp lagres på kortet, men ikke belastes umiddelbart. Denne funksjonaliteten er spesielt viktig i områder som hoteller og bilutleie, hvor de endelige prisene kan variere. Integrasjonen kan håndtere mange transaksjonstyper ved å bruke den samme API, noe som gjør den allsidig for ulike brukstilfeller.
Sikkerhet er en toppprioritet i enhver betalingsintegrasjon, og Moneris Checkout inkluderer teknologier som tokenisering og svindelforebygging. Tokenisering erstatter sensitiv kortinformasjon med et token, slik at forbrukerdata aldri blir eksponert på systemene dine. Implementering av sikkerhetstiltak, som svindeldeteksjonsteknologier og PCI DSS-samsvar, kan dramatisk redusere risikoen forbundet med nettbaserte transaksjoner.
Vanlige spørsmål om Moneris Checkout-integrasjon
- Hva er Moneris Checkout?
- Moneris Checkout er en betalingsgateway-løsning som gjør det mulig for bedrifter å trygt akseptere betalinger via nettsiden deres. Det gir tilpassbare betalingsskjemaer og godtar en rekke betalingsmåter.
- Hvordan kan jeg tilpasse Moneris Checkout-skjemaet?
- Moneris API lar deg tilpasse utformingen av betalingsskjemaet ved å endre elementer som knapper og inndatafelt. Bruk kommandoer som setCustomStyle() for å legge til merkevarens stil i skjemaet.
- Hva er viktigheten av å sette miljøet til "qa"?
- Sette miljøet til "qa" med setMode("qa") lar deg trygt teste transaksjoner uten å behandle reelle betalinger.
- Hvordan håndterer jeg en forhåndsgodkjenningstransaksjon?
- For å administrere forhåndsgodkjenning, inkludere action: "preauth" argument i JSON-forespørselen din. Dette vil sette en sperre på kundens kort i stedet for å belaste det umiddelbart.
- Hva er sikkerhetstiltakene levert av Moneris Checkout?
- Moneris støtter tokenisering, som erstatter sensitiv kredittkortinformasjon med et token. Overholdelse av PCI DSS sikrer at integrasjonen din oppfyller bransjens sikkerhetskrav.
Siste tanker om Moneris Checkout-integrasjon
For å lykkes med å integrere Moneris Checkout med JavaScript, må både front-end- og back-end-oppsettene planlegges nøye. Å gi brukere en god betalingsopplevelse krever at transaksjonsdetaljer, for eksempel billettnummer, registreres på riktig måte.
Testing i et QA-miljø og riktig strukturering av betalingsskjemaet ditt vil hjelpe deg med å oppdage problemer tidlig. Med riktig teknikk kan du lage en sømløs og sikker betalingsprosedyre som passer til bedriftens mål samtidig som du sikrer kundelykke.
Referanser og ressurser for Moneris Checkout-integrasjon
- Denne artikkelen er basert på Moneris Checkout Integration-dokumentasjonen og API-referansen. For mer detaljert informasjon, besøk det offisielle Moneris GitHub-depotet: Moneris Checkout GitHub .
- Ytterligere veiledning for å sette opp JavaScript-baserte betalingsintegrasjoner finner du på Moneris utviklerportal: Moneris utviklerportal .
- For beste praksis for håndtering av JSON-anrop og registrering av transaksjonssvar, se JavaScript SDK-dokumentasjonen: Moneris JavaScript SDK .