Integration af Moneris Checkout med JavaScript: Håndtering af JSON-svarproblemer

Sømløs integration af Moneris Checkout: Fejlfinding af JSON-svar

Moneris Checkout er et almindeligt anvendt betalingsgateway-system, der hjælper virksomheder med at fremskynde onlinetransaktioner. Det kan dog være svært at integrere det på dit websted, især når nødvendige data, såsom et billetnummer, ikke returneres fra et JSON-opkald. Sådanne fejl kan hæmme den regelmæssige strøm af transaktioner, så fejlretning er en nødvendig færdighed for ingeniører.

Det er afgørende at forstå, hvordan man korrekt konfigurerer kassen, når man udskifter en forældet Hosted Payment Page (HPP) med Moneris og bruger deres JavaScript-grænseflade. For at give dine kunder en problemfri oplevelse, skal du sørge for, at siden poster transaktionsdetaljer og henter nøjagtige svar.

Mange udviklere har problemer med at følge Moneris' integrationsdokumentation. Kompleksiteten stammer fra håndtering af tilbagekald, upload af transaktionsdata og læsning af resultater i realtid, hvilket alt sammen er nødvendigt for en vellykket integration. Når du begynder din integrationsrejse, kan det være en fordel at have en klar og veldokumenteret metode.

I dette indlæg vil vi se på, hvordan du løser problemet med manglende billetnumre i din Moneris-integration. Du vil være bedre forberedt til at håndtere dette problem, hvis du gennemgår de nødvendige kodestykker og fejlfindingsteknikker.

Forstå Moneris Checkout-integration og script-workflow

Det inkluderede frontend-script integrerer Moneris Checkout-systemet på et websted via JavaScript. Den primære funktionalitet begynder med at etablere en forekomst af Moneris checkout gennem MonerisCheckout() konstruktør. Denne instans fungerer som en grænseflade mellem dit websted og Moneris' betalingsbehandlingstjeneste. Kommandoen setMode() specificerer, om miljøet skal indstilles til "qa" til test eller "live" til produktion, hvilket er kritisk under udviklingsstadier. Ved at vælge "qa" kan udviklere replikere transaktioner uden at pådrage sig omkostninger i den virkelige verden, hvilket skaber en sikker testplads.

Når checkout-instansen er bygget, vil setCheckoutDiv() kommando forbinder Moneris betalingsformular til en specifik HTML div. Det er her, betalingsformularen vises på siden. Dette garanterer, at den visuelle afbildning af betalingsformularen vises i en bestemt region af webstedet, hvilket gør proceduren problemfri og integreret i dit eksisterende design. I vores eksempel er Moneris-formularen indsat i div'en med ID'et "monerisCheckout". Denne div fungerer som en pladsholder for Moneris' dynamisk indlæste indhold, som inkluderer indtastningsfelter og knapper for klientbetaling.

Scriptet udføres derefter sætCallback(), hvilket giver udvikleren mulighed for at konfigurere specifik hændelseshåndtering til checkout-processen. Specifikt er tilbagekaldet for "page_loaded" knyttet til funktionen minSideLoad, hvilket garanterer, at når siden er fuldt indlæst, kan der forekomme ekstra tilpassede handlinger (såsom logdata). Denne funktion giver mulighed for fleksibilitet i, hvordan brugeroplevelsen håndteres. Logning af indholdet af eks objekt indeni myPageLoad() hjælper udviklere med fejlretning ved at give feedback i realtid på de data, Moneris returnerer.

Endelig håndterer back-end-scriptet serversidens modtagelse af betalingsdata. Bruger Express.js i Node.js, ruten app.post() er defineret til at modtage POST-anmodninger fra Moneris, når transaktionen er gennemført. Dette slutpunkt behandler den returnerede JSON og kontrollerer svar_kode for at se, om betalingen lykkedes. Hvis det lykkes, kan transaktionsdataene (såsom billetnummeret) logges eller indtastes i en database. Ved at returnere passende statuskoder og beskeder muliggør backend en jævn forbindelse med frontend, hvilket giver kritisk feedback til brugeren, såsom om transaktionen lykkedes eller mislykkedes.

// 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 QA
myCheckout.setCheckoutDiv("monerisCheckout"); // Define div for checkout
// Add callback for when the page is fully loaded
myCheckout.setCallback("page_loaded", myPageLoad);
// Start the checkout process
myCheckout.startCheckout("");

// Function that gets triggered when the page is loaded
function myPageLoad(ex) {
    console.log("Checkout page loaded", ex);
}

// Function to handle the receipt after the payment
function myPaymentReceipt(ex) {
    if(ex.response_code === '00') {
        alert("Transaction Successful: " + ex.ticket);
    } else {
        alert("Transaction Failed: " + ex.message);
    }
}
</script>

// Node.js backend script for processing payment receipt data
// This backend handles the response from Moneris and processes it for database storage

const 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 result
app.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 payment
        res.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');
});

// Unit test for the Node.js backend using Mocha and Chai
// This test checks if the backend properly handles successful and failed transactions

const 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();
            });
    });
});

Forbedring af Moneris Checkout-integration med tilpasningsmuligheder

Når man arbejder med Moneris Checkout-integrationen, leder udviklere ofte efter metoder til at personalisere betalingsprocessen for at forbedre brugeroplevelsen. Kasseformularens UI komponenter kan tilpasses, hvilket er en mindre kendt funktion. Moneris giver virksomheder mulighed for at tilpasse udseendet og layoutet af betalingssiden, så de kan tilpasse den til deres branding. Dette involverer ændring af knaplayout, formularfelter og endda ordlyden for at gøre processen nemmere for slutbrugere og øge konverteringer.

En anden faktor, der skal undersøges, er brugen af ​​andre transaktionstyper end basale betalinger. Moneris har funktioner såsom forhåndsgodkendelse, hvor et transaktionsbeløb gemmes på kortet, men ikke debiteres med det samme. Denne funktionalitet er især vigtig i områder som hoteller og biludlejning, hvor de endelige priser kan variere. Integrationen kan håndtere mange transaktionstyper ved at bruge den samme API, hvilket gør den alsidig til forskellige anvendelsestilfælde.

Sikkerhed er en topprioritet i enhver betalingsintegration, og Moneris Checkout inkorporerer teknologier som tokenisering og forebyggelse af svindel. Tokenisering erstatter følsomme kortoplysninger med et token, så forbrugerdata bliver aldrig eksponeret på dine systemer. Implementering af sikkerhedsforanstaltninger, såsom svindeldetektionsteknologier og PCI DSS-overholdelse, kan dramatisk reducere de risici, der er forbundet med onlinetransaktioner.