Integracija Moneris Checkout z JavaScriptom: obravnavanje težav z odzivom JSON

Brezšivna integracija Moneris Checkout: Odpravljanje težav z odzivom JSON

Moneris Checkout je pogosto uporabljen sistem plačilnih prehodov, ki podjetjem pomaga pospešiti spletne transakcije. Vendar pa je lahko integracija v vaše spletno mesto težavna, zlasti če zahtevani podatki, kot je številka vstopnice, niso vrnjeni iz klica JSON. Takšne napake lahko ovirajo reden tok transakcij, zato je odpravljanje napak nujna veščina za inženirje.

Razumevanje, kako pravilno konfigurirati blagajno, je ključnega pomena pri zamenjavi zastarele gostujoče plačilne strani (HPP) z Monerisom in uporabo njihovega vmesnika JavaScript. Če želite svojim strankam zagotoviti brezhibno izkušnjo, poskrbite, da bodo na strani objavljeni podatki o transakcijah in pridobljeni točni odgovori.

Številni razvijalci imajo težave pri sledenju Monerisovi integracijski dokumentaciji. Kompleksnost izhaja iz obravnavanja povratnih klicev, nalaganja transakcijskih podatkov in rezultatov branja v realnem času, kar je vse potrebno za uspešno integracijo. Ko začnete svojo integracijsko pot, vam bo morda koristila jasna in dobro dokumentirana metodologija.

V tej objavi si bomo ogledali, kako rešiti težavo z manjkajočimi številkami vstopnic v vaši integraciji Moneris. Na to težavo boste bolje pripravljeni, če pregledate potrebne izrezke kode in tehnike za odpravljanje težav.

Razumevanje integracije Moneris Checkout in delovnega toka skripta

Vključeni sprednji skript integrira sistem Moneris Checkout v spletno mesto prek JavaScripta. Primarna funkcionalnost se začne z vzpostavitvijo primerka blagajne Moneris prek monerisCheckout() konstruktor. Ta primerek služi kot vmesnik med vašim spletnim mestom in Monerisovo storitvijo za obdelavo plačil. Ukaz setMode() določa, ali naj bo okolje nastavljeno na "qa" za testiranje ali "live" za proizvodnjo, kar je ključnega pomena v razvojnih fazah. Z izbiro »qa« lahko razvijalci posnemajo transakcije brez stroškov v resničnem svetu in ustvarijo varno testno poligon.

Ko je primerek za dokončanje nakupa zgrajen, je setCheckoutDiv() ukaz poveže obrazec za odjavo Moneris z določenim divom HTML. Tukaj se na strani prikaže obrazec za plačilo. To zagotavlja, da se vizualni prikaz plačilnega obrazca prikaže v določenem delu spletnega mesta, zaradi česar je postopek brezhiben in integriran v vaš obstoječi dizajn. V našem primeru je obrazec Moneris vstavljen v div z ID-jem »monerisCheckout«. Ta div služi kot ograda za dinamično naloženo vsebino Moneris, ki vključuje vnosna polja in gumbe za plačilo strank.

Skript se nato izvede setCallback(), kar omogoča razvijalcu, da konfigurira posebno obravnavo dogodkov za postopek zaključka nakupa. Natančneje, funkciji je priložen povratni klic za "page_loaded". myPageLoad, ki zagotavlja, da se lahko, ko je stran v celoti naložena, izvedejo dodatna dejanja po meri (kot je beleženje podatkov). Ta funkcija omogoča prilagodljivost pri obravnavi uporabniške izkušnje. Beleženje vsebine npr predmet znotraj myPageLoad() pomaga razvijalcem pri odpravljanju napak z zagotavljanjem povratnih informacij v realnem času o podatkih, ki jih vrne Moneris.

Nazadnje, zaledni skript obravnava prejem plačilnih podatkov na strani strežnika. Uporaba Express.js v Node.js, pot app.post() je definiran za prejemanje zahtev POST od Monerisa, ko je transakcija končana. Ta končna točka obdela vrnjeni JSON in preveri odzivna_koda ali je bilo plačilo uspešno. Če je transakcija uspešna, se lahko podatki o transakciji (kot je številka vstopnice) zabeležijo ali vnesejo v bazo podatkov. Z vračanjem ustreznih statusnih kod in sporočil zaledje omogoča nemoteno povezavo s sprednjim delom in uporabniku zagotavlja kritične povratne informacije, na primer, ali je bila transakcija uspešna ali neuspešna.

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

Izboljšanje integracije Moneris Checkout z možnostmi prilagajanja

Pri delu z integracijo Moneris Checkout razvijalci pogosto iščejo metode za prilagoditev postopka nakupa za izboljšanje uporabniške izkušnje. Obrazec za odjavo komponente uporabniškega vmesnika je mogoče prilagoditi, kar je manj znana funkcija. Moneris omogoča podjetjem, da prilagodijo videz in postavitev strani za nakup, kar jim omogoča, da jo uskladijo s svojo blagovno znamko. To vključuje spreminjanje postavitev gumbov, polj obrazcev in celo besedila, da bi olajšali postopek za končne uporabnike in povečali konverzije.

Drug dejavnik, ki ga je treba preučiti, je uporaba vrst transakcij, ki niso osnovna plačila. Moneris ima zmožnosti, kot je predavtorizacija, pri kateri se znesek transakcije shrani na kartico, vendar se ne bremeni takoj. Ta funkcija je še posebej pomembna na področjih, kot so hoteli in najem avtomobilov, kjer se končne cene lahko razlikujejo. Integracija lahko obravnava številne vrste transakcij z isto uporabo API, zaradi česar je vsestranski za različne primere uporabe.

Varnost je glavna prednostna naloga pri vsaki integraciji plačil, Moneris Checkout pa vključuje tehnologije, kot sta tokenizacija in preprečevanje goljufij. Tokenizacija nadomešča občutljive podatke kartice z žetonom, tako da podatki potrošnikov v vaših sistemih niso nikoli izpostavljeni. Izvajanje varnostnih ukrepov, kot so tehnologije za odkrivanje goljufij in skladnost s standardom PCI DSS, lahko dramatično zmanjša tveganja, povezana s spletnimi transakcijami.