Besprijekorna integracija Moneris Checkout-a: Rješavanje problema JSON odgovora
Moneris Checkout često je korišteni sustav pristupnika plaćanja koji pomaže tvrtkama u ubrzavanju mrežnih transakcija. Međutim, njegovo integriranje u vašu web stranicu može biti teško, osobito kada se potrebni podaci, kao što je broj ulaznice, ne vraćaju iz JSON poziva. Takve pogreške mogu spriječiti redoviti tijek transakcija, pa je uklanjanje pogrešaka potrebna vještina za inženjere.
Razumijevanje kako ispravno konfigurirati naplatu je ključno kada zamjenjujete zastarjelu Hosted Payment Page (HPP) s Monerisom i koristite njihovo JavaScript sučelje. Kako biste svojim klijentima pružili besprijekorno iskustvo, osigurajte da stranica objavljuje detalje transakcije i dohvaća točne odgovore.
Mnogi programeri imaju problema s praćenjem Monerisove dokumentacije o integraciji. Složenost proizlazi iz rukovanja povratnim pozivima, učitavanja transakcijskih podataka i rezultata čitanja u stvarnom vremenu, što je sve potrebno za uspješnu integraciju. Kad započnete svoj integracijski put, imati jasnu i dobro dokumentiranu metodologiju moglo bi biti od koristi.
U ovom ćemo postu pogledati kako riješiti problem nedostajućih brojeva karata u vašoj integraciji Moneris. Bit ćete bolje pripremljeni za rješavanje ovog problema ako pregledate potrebne isječke koda i tehnike za rješavanje problema.
| Naredba | Primjer korištenja |
|---|---|
| monerisCheckout() | Ovo je funkcija konstruktora iz Moneris JavaScript SDK-a. Pokreće postupak naplate. Ova skripta generira novu instancu Monerisovog widgeta za naplatu, koji vam omogućuje da ugradite pristupnik plaćanja na svoju web stranicu. |
| setMode() | Određuje okruženje za Moneris transakciju. U ovom primjeru, "qa" se odnosi na testno okruženje u kojem možete sigurno simulirati transakcije bez obrade stvarnih plaćanja. Ovo je potrebno za testiranje integracije bez stvarne naplate kartica. |
| setCheckoutDiv() | Ova naredba pridružuje Moneris checkout s određenim HTML spremnikom (div). Unosom ID-a "monerisCheckout", widget za plaćanje se prikazuje unutar ovog diva, omogućujući vam da odaberete gdje će se obrazac pojaviti na stranici. |
| setCallback() | Tijekom postupka naplate dodijelite funkciju određenom događaju. U ovom scenariju prilagođena funkcija "myPageLoad" rukuje događajem "page_loaded", dopuštajući programerima pokretanje koda kada je stranica za naplatu potpuno učitana. |
| startCheckout() | Započnite postupak plaćanja Moneris. Kada se pozove, ova funkcija pokreće tijek plaćanja renderiranjem obrasca za plaćanje i njegovim povezivanjem s pozadinskim sustavom za obradu transakcija. |
| app.post() | Ovo je Express.js rukovatelj rutom koji obrađuje POST zahtjeve. Ova skripta prima potvrde o plaćanju od Moneris pozadine nakon završetka transakcije, što omogućuje dodatnu obradu kao što je čuvanje podataka o plaćanju ili izdavanje potvrda. |
| bodyParser.json() | Funkcija međuprograma u Expressu za raščlanjivanje dolaznih JSON zahtjeva. To je posebno kritično u ovom slučaju jer Moneris prenosi transakcijske podatke u JSON formatu. Ova naredba jamči da je tijelo zahtjeva ispravno obrađeno za obradu na strani poslužitelja. |
| chai.request() | Ova je naredba dio Chai HTTP paketa za testiranje koji šalje HTTP zahtjeve unutar testnih slučajeva. Replicira POST zahtjeve Moneris API-ju za plaćanje tijekom jediničnog testiranja, omogućujući razvojnom programeru da vidi kako pozadina obrađuje uspješne i neuspješne transakcije. |
| expect() | Osnovna funkcija tvrdnje u biblioteci Chai. U kontekstu jediničnih testova, utvrđuje jesu li određeni uvjeti zadovoljeni. Koristi se kako bi se osiguralo da status odgovora i poruka koju vraća krajnja točka plaćanja odgovaraju predviđenim ishodima. |
Razumijevanje integracije i tijeka rada skripte Moneris Checkout
Uključena front-end skripta integrira sustav Moneris Checkout u web stranicu putem JavaScripta. Primarna funkcionalnost počinje uspostavljanjem instance Moneris naplate putem monerisCheckout() konstruktor. Ova instanca služi kao sučelje između vaše web stranice i Monerisove usluge obrade plaćanja. Zapovijed setMode() specificira treba li okolina biti postavljena na "qa" za testiranje ili "uživo" za proizvodnju, što je kritično tijekom faza razvoja. Odabirom "qa" programeri mogu replicirati transakcije bez stvarnih troškova, stvarajući sigurno poligon za testiranje.
Nakon što se instanca za naplatu izgradi, setCheckoutDiv() naredba povezuje obrazac za plaćanje Moneris s određenim HTML div. Ovdje će se na stranici pojaviti obrazac za plaćanje. To jamči da se vizualni prikaz obrasca za plaćanje prikazuje u određenom dijelu web stranice, čineći postupak besprijekornim i integriranim u vaš postojeći dizajn. U našem primjeru, obrazac Moneris umetnut je u div s ID-om "monerisCheckout." Ovaj div služi kao rezervirano mjesto za Monerisov dinamički učitani sadržaj, koji uključuje polja za unos plaćanja klijenta i gumbe.
Skripta se tada izvršava setCallback(), omogućujući razvojnom programeru da konfigurira specifično rukovanje događajima za proces naplate. Točnije, povratni poziv za "page_loaded" priložen je funkciji myPageLoad, jamčeći da kada se stranica u potpunosti učita, mogu se dogoditi dodatne prilagođene radnje (kao što su podaci o zapisivanju). Ova funkcija omogućuje fleksibilnost u rukovanju korisničkim iskustvom. Bilježenje sadržaja pr objekt unutar myPageLoad() pomaže programerima u otklanjanju pogrešaka pružajući povratne informacije u stvarnom vremenu o podacima koje Moneris vraća.
Konačno, pozadinska skripta obrađuje primanje podataka o plaćanju na strani poslužitelja. Korištenje Express.js u Node.js, ruta app.post() je definiran za primanje POST zahtjeva od Monerisa nakon dovršetka transakcije. Ova krajnja točka obrađuje vraćeni JSON, provjeravajući kod_odgovora kako bi vidjeli je li plaćanje uspješno. Ako je uspješna, podaci o transakciji (kao što je broj karte) mogu se zabilježiti ili unijeti u bazu podataka. Vraćanjem prikladnih statusnih kodova i poruka, backend omogućuje glatku vezu s frontendom, pružajući kritične povratne informacije korisniku, kao što je je li transakcija uspjela ili nije.
Moneris Checkout integracija s JavaScriptom: Front-End i Back-End rješenja
Front-end rješenje koje koristi JavaScript za uključivanje obrasca Moneris Checkout i rukovanje odgovorima na transakcije.
// 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 rješenje s Node.js i Expressom: rukovanje podacima o plaćanju
Pozadinsko rješenje koje koristi Node.js i Express za upravljanje Monerisovim podacima o naknadnom plaćanju
// 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');});
Jedinično testiranje pozadinskog rukovanja plaćanjem s Mocha i Chai
Testiranje pozadinske jedinice s Mocha i Chai za provjeru funkcionalnosti upravljanja novcem
// 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();});});});
Poboljšanje integracije Moneris Checkout s opcijama prilagodbe
Kada rade s integracijom Moneris Checkout, programeri često traže metode za personalizaciju procesa plaćanja kako bi poboljšali korisničko iskustvo. Obrazac za naplatu komponente korisničkog sučelja može se prilagoditi, što je manje poznata funkcija. Moneris omogućuje tvrtkama da prilagode izgled i raspored stranice za naplatu, dopuštajući im da je usklade sa svojim brendiranjem. To uključuje izmjenu izgleda gumba, polja obrazaca, pa čak i riječi kako bi se krajnjim korisnicima olakšao postupak i povećale konverzije.
Još jedan čimbenik koji treba ispitati je korištenje vrsta transakcija koje nisu osnovna plaćanja. Moneris ima mogućnosti kao što je predautorizacija, u kojoj se iznos transakcije sprema na karticu, ali se ne tereti odmah. Ova je funkcija posebno važna u područjima kao što su hoteli i iznajmljivanje automobila, gdje se konačne cijene mogu razlikovati. Integracija može obraditi mnoge vrste transakcija koristeći iste API, što ga čini svestranim za različite slučajeve upotrebe.
Sigurnost je glavni prioritet u bilo kojoj integraciji plaćanja, a Moneris Checkout uključuje tehnologije poput tokenizacije i sprječavanja prijevara. Tokenizacija zamjenjuje osjetljive podatke kartice tokenom, tako da podaci potrošača nikada nisu izloženi u vašim sustavima. Provedba sigurnosnih mjera, kao što su tehnologije za otkrivanje prijevara i usklađenost s PCI DSS-om, može dramatično smanjiti rizike povezane s mrežnim transakcijama.
Uobičajena pitanja o integraciji Moneris Checkout
- Što je Moneris Checkout?
- Moneris Checkout rješenje je pristupnika plaćanja koje tvrtkama omogućuje sigurno prihvaćanje plaćanja putem njihove web stranice. Omogućuje prilagodljive obrasce za naplatu i prihvaća različite načine plaćanja.
- Kako mogu prilagoditi Moneris Checkout obrazac?
- Moneris API omogućuje vam da prilagodite dizajn obrasca za naplatu mijenjanjem elemenata kao što su gumbi i polja za unos. Koristite naredbe poput setCustomStyle() kako biste obrascu dodali stil svoje marke.
- Koja je važnost postavljanja okoline na "qa"?
- Postavljanje okruženja na "qa" sa setMode("qa") omogućuje sigurno testiranje transakcija bez obrade stvarnih plaćanja.
- Kako mogu postupati s transakcijom predautorizacije?
- Za upravljanje predautorizacijom uključite action: "preauth" argument u vašem JSON zahtjevu. Ovo će staviti zadržavanje na kartici kupca umjesto da je odmah tereti.
- Koje sigurnosne mjere nudi Moneris Checkout?
- Moneris podržava tokenizaciju, koja zamjenjuje osjetljive podatke kreditne kartice tokenom. Usklađenost s PCI DSS jamči da vaša integracija zadovoljava sigurnosne zahtjeve industrije.
Završne misli o integraciji Moneris Checkout
Za uspješnu integraciju Moneris Checkouta s JavaScriptom, postavke front-enda i backenda moraju biti pažljivo planirane. Pružanje dobrog iskustva naplate za korisnike zahtijeva osiguravanje da su detalji o transakciji, kao što je broj karte, odgovarajuće zabilježeni.
Testiranje u QA okruženju i ispravno strukturiranje vašeg obrasca za plaćanje pomoći će vam da rano otkrijete probleme. Ispravnom tehnikom možete stvoriti besprijekornu i sigurnu proceduru plaćanja koja odgovara ciljevima vaše tvrtke, istovremeno osiguravajući zadovoljstvo klijenta.
Reference i resursi za Moneris Checkout integraciju
- Ovaj se članak temelji na dokumentaciji Moneris Checkout integracije i referenci API-ja. Za detaljnije informacije posjetite službeni Moneris GitHub repozitorij: Moneris Checkout GitHub .
- Dodatne smjernice o postavljanju integracija plaćanja temeljenih na JavaScriptu mogu se pronaći na Moneris portalu za razvojne programere: Portal za programere Moneris .
- Najbolje primjere iz prakse za rukovanje JSON pozivima i hvatanje odgovora na transakcije potražite u dokumentaciji za JavaScript SDK: Moneris JavaScript SDK .