Princip rada, bez bankarske kompleksnosti
Vaš kod zna samo za placanje.me. Različite banke, procesore, verzije protokola i potpise rješavamo mi. Ovdje je princip, a kompletna specifikacija je u panelu.
Tri veze, od kojih vi pravite dvije
Vaš server → placanje.me
Pokretanje plaćanja i provjera statusa. Svaki zahtjev je zaštićen vašim tajnim ključem i zaštićen od ponavljanja. Ide isključivo sa servera, nikad iz browsera.
placanje.me ↔ banka
Ovo je naš dio: izbor aktivne banke, njen protokol, potpisi, provjera autentičnosti odgovora i provjera statusa kad poruka banke izostane. Ovdje ne pišete ništa.
placanje.me → vaš server
Potpisano obavještenje (webhook) o ishodu plaćanja. Ono je jedini izvor istine za status narudžbe. Ako ne potvrdite prijem, šaljemo ga ponovo.
Želite vizuelno da vidite tok plaćanja? Pogledajte Kako funkcioniše, gdje je opisan svaki korak.
Šest pravila za pouzdanu integraciju
Ovo su principi na kojima je sistem napravljen. Ko ih poštuje, nema izgubljenih ni duplo naplaćenih narudžbi.
1. Status mijenja samo obavještenje
Narudžbu označavate plaćenom isključivo na osnovu webhook obavještenja, nikad na osnovu toga što je kupac stigao na stranicu uspjeha.
2. Provjerite potpis
Svako obavještenje je potpisano. Prije obrade provjerite da je potpis ispravan, a obavještenje bez ispravnog potpisa odbacite.
3. Obrada bez duplikata
Isto obavještenje može stići više puta. Obradite ga tako da ponovljeno obavještenje ne promijeni ništa.
4. Brza potvrda prijema
Odmah potvrdite prijem, a sporije poslove (email, ERP, fiskalizaciju) radite nakon toga. Tako izbjegavate nepotrebna ponavljanja.
5. Tajni ključ samo na serveru
Ključ ne ide u JavaScript, mobilnu aplikaciju ni u repozitorijum. Ako procuri, u panelu ga odmah zamijenite novim.
6. Jedna narudžba = jedno plaćanje
Ako ponovite zahtjev za istu narudžbu, npr. nakon prekida veze, dobijate isto plaćanje, a ne novo.
Testirajte sve prije prve prave uplate
Svaki nalog dobija test ključeve i simuliranu banku. Probna plaćanja prolaze kroz isti tok kao prava, bez kartice i bez novca.
- Simulacija uspješnog, odbijenog i isteklog plaćanja
- Prava obavještenja ka vašem serveru, sa potpisom
- Prelazak na produkciju zamjenom ključeva, bez izmjene koda
Šta vas čeka u panelu
- Kompletna API specifikacija
- Primjeri koda za najčešće jezike
- Uputstvo za provjeru potpisa obavještenja
- Log svakog zahtjeva i svakog obavještenja
- Ručno ponovno slanje obavještenja
- Test i produkcijski ključevi, sa zamjenom jednim klikom
Zašto dokumentacija nije javna? Tehnički detalji (formati zahtjeva, potpisi, primjeri) dostupni su samo klijentima u panelu. Tako manje izlažemo sistem, a vi dobijate dokumentaciju vezanu za svoj nalog i ključeve.
Radite sajt za klijenta?
Pošaljite porudžbinu u ime klijenta ili nam pišite. Otvaramo nalog sa test pristupom i dokumentacijom.