Podešavanje Chipcard
Chipcard (pokreće Payten/AllSecure) je primarni platni prolaz za procesiranje kartičnih plaćanja na Mozhe platformi. Ovaj vodič vas vodi kroz proces prijave i konfiguracije.
Pregled
Chipcard pruža:
- Sigurnu obradu kartičnih plaćanja sa PCI DSS usklađenošću
- 3D Secure autentifikaciju za Visa i Mastercard
- Podršku za Dinacard i American Express (non-3DS)
- Integraciju Apple Pay i Google Pay
- Tokenizaciju kartica za sačuvane kartice
- Obradu transakcija u realnom vremenu
Preduslovi
Pre konfigurisanja Chipcard, potrebno vam je:
- Registrovana firma u Srbiji
- Trgovački nalog kod Chipcard/Payten
- Vaši trgovački akreditivi (dobijeni od Chipcard)
- SSL sertifikat na vašem domenu (potreban HTTPS)
Dobijanje trgovačkih akreditiva
Za početak rada sa Chipcard:
- Kontaktirajte Chipcard/Payten da se prijavite za trgovački nalog
- Završite proces prijave trgovca
- Primite vaše akreditive:
- Merchant Name (Ime trgovca)
- Merchant User (Korisnik trgovca)
- Merchant Password (Lozinka trgovca)
Čuvajte ove akreditive sigurno. Biće šifrovani kada se čuvaju u Mozhe sistemu.
Koraci konfiguracije
Korak 1: Pristupite podešavanjima plaćanja
- Prijavite se na Mozhe kontrolnu tablu
- Idite na podešavanja organizacije
- Izaberite sajt koji želite da konfigurišete
- Idite na Podešavanja > Prodavnica > Plaćanja
Korak 2: Omogućite Chipcard
- U sekciji platnog prolaza, izaberite Chipcard kao vaš platni prolaz
- Unesite vaše trgovačke akreditive:
- Merchant Name: Vaš Chipcard identifikator trgovca
- Merchant User: Vaše API korisničko ime
- Merchant Password: Vaša API lozinka
Korak 3: Konfigurišite Virtual POS
Chipcard koristi dve Virtual POS konfiguracije:
- 3D Virtual POS: Za Visa i Mastercard (sa 3D Secure)
- MOTO Virtual POS: Za Dinacard i American Express (bez 3D Secure)
Ove se automatski konfigurišu na osnovu podešavanja platforme. Kontaktirajte Mozhe podršku ako vam je potrebna prilagođena VirtualPOS konfiguracija.
Konfiguracija 3D Secure
3D Secure (3DS) dodaje dodatni sloj autentifikacije za kartična plaćanja.
Kako 3D Secure funkcioniše
- Kupac unosi podatke kartice
- Mozhe detektuje tip kartice (Visa, Mastercard, itd.)
- Za Visa/Mastercard: Kupac se preusmerava na banku radi autentifikacije
- Kupac završava verifikaciju (SMS kod, biometrija, itd.)
- Kupac se vraća u vašu prodavnicu
- Plaćanje se procesira
Pravila za srpsko tržište
Na srpskom tržištu, primenjuju se specifična pravila:
Mozhe automatski usmerava transakcije na ispravan Virtual POS na osnovu BIN-a kartice (prvih 6 cifara).
Testiranje vs Produkcija
Test okruženje
Pre pokretanja uživo, testirajte vašu integraciju u sandbox okruženju:
- Koristite test brojeve kartica koje pruža Chipcard
- Proverite da se tok plaćanja uspešno završava
- Proverite da se porudžbine kreiraju sa ispravnim metapodacima plaćanja
- Testirajte 3D Secure tokove sa različitim tipovima kartica
Uobičajene test kartice:
- Visa: Kartice koje počinju sa 4
- Mastercard: Kartice koje počinju sa 51-55
- Dinacard: Kartice koje počinju sa 9891
Prelazak na produkciju
Za prelazak na produkciju:
- Uverite se da svi testovi prolaze u sandbox-u
- Ažurirajte akreditive na produkcijske vrednosti (dobijene od Chipcard)
- Proverite da je vaš SSL sertifikat validan
- Procesuirajte malu test transakciju sa pravom karticom
- Pažljivo pratite prve transakcije
Tipovi transakcija
Chipcard podržava nekoliko tipova transakcija:
SALE (Trenutna naplata)
Koristi se za digitalne proizvode ili trenutnu isporuku. Sredstva se naplaćuju odmah kada kupac plati.
PREAUTH + POSTAUTH
Koristi se za fizičke proizvode:
- PREAUTH: Rezerviše sredstva na kartici kupca
- POSTAUTH: Naplaćuje sredstva kada pošaljete porudžbinu
Ovo je preporučeni tok za fizičku robu jer vam omogućava da poništite autorizaciju ako ne možete ispuniti porudžbinu.
VOID
Poništava transakciju pre saldiranja (isti dan). Koristite ovo da oslobodite rezervisana sredstva ako je porudžbina otkazana pre slanja.
Plaćanja digitalnim novčanicima
Chipcard podržava plaćanja digitalnim novčanicima:
Apple Pay
- Kupac bira Apple Pay pri plaćanju
- Kupac se autentifikuje sa Face ID, Touch ID ili lozinkom
- Plaćanje se procesira kao SALE transakcija
- Porudžbina se kreira sa statusom "Potvrđena"
Google Pay
- Kupac bira Google Pay pri plaćanju
- Kupac se autentifikuje svojim uređajem
- Plaćanje se procesira kao SALE transakcija
- Porudžbina se kreira sa statusom "Potvrđena"
Da biste omogućili plaćanja novčanicima, uverite se da vaš Chipcard trgovački nalog ima omogućene Apple Pay i Google Pay.
Webhooks
Chipcard šalje webhook obaveštenja za ažuriranja statusa transakcija:
- Plaćanje autorizovano
- Plaćanje naplaćeno
- Plaćanje poništeno
- 3D Secure završen
Ovi webhooks automatski ažuriraju status porudžbine u Mozhe sistemu.
Rešavanje problema
Česti problemi
"Session token failed"
- Proverite da su vaši trgovački akreditivi tačni
- Proverite da je iznos ceo broj (bez decimala)
- Uverite se da je vaš trgovački nalog aktivan
"3D Secure authentication failed"
- Kupac je možda otkazao autentifikaciju
- Banka je možda odbila transakciju
- Kupac treba da pokuša ponovo ili koristi drugu karticu
"Invalid card number"
- Broj kartice može biti netačan
- Kartica je možda istekla
- Kartica možda nije podržana
"Transaction declined"
- Nedovoljno sredstava
- Kartica blokirana od strane banke izdavaoca
- Detektovana sumnjiva aktivnost
Dobijanje pomoći
Ako naiđete na probleme:
- Proverite metapodatke plaćanja porudžbine za detalje greške
- Pregledajte Chipcard dokumentaciju za kodove grešaka
- Kontaktirajte Mozhe podršku sa brojem porudžbine
- Za probleme sa trgovačkim nalogom, kontaktirajte Chipcard direktno
Najbolje prakse za sigurnost
- Nikada ne evidentirajte ili čuvajte pune brojeve kartica
- Koristite HTTPS na svim stranicama za plaćanje
- Čuvajte trgovačke akreditive sigurno i šifrovano
- Pratite sumnjive obrasce transakcija
- Implementirajte provere brzine ako je potrebno
Sledeći koraci
- Konfigurišite KOPA za plaćanja na rate
- Omogućite plaćanje pouzećem kao alternativni način plaćanja
- Podesite načine dostave za završetak konfiguracije naplate