Namestitev in nastavitev plačilne metode
1. Prijavite se v Leanpay aplikacijo za želeno okolje (testno ali produkcijsko).
2. Pojdite v razdelek Company.
3. Pomaknite do razdelka Development in:
– nastavite API URL na: https://extapp.leanpay.si/callback/webhook,
– nastavite Secret Word in si ga zabeležite.
Ta API URL je ključen za sinhronizacijo posodobitev statusa naročil in plačil med Leanpay in Shopify. Nepravilna konfiguracija lahko povzroči, da naročila obstanejo v nerešenem stanju.
4. Obiščite Shopify integracijski endpoint na: https://extapp.leanpay.si
5. Vnesite Shopify store URL.
6. Preusmerjeni boste v Shopify, na zaslon za namestitev aplikacije. Kliknite Install.
7. Ko je aplikacija nameščena, boste preusmerjeni v configuration view. Vnesite zahtevane podatke.
– API Key je na voljo v Leanpay Gateway panel pod Company → Development.
– API Secret ustreza vrednosti Secret Word, ki ste jo nastavili med konfiguracijo gatewaya.
– Default Environment se uporabi v primerih, ko ciljna država nima ustreznega okolja.
– Mode določa, kateri Leanpay API endpoint bo uporabljen. Ne uporabljajte Sandbox v Production okolju, razen če je nujno – v tem primeru zagotovite, da ima Payment Method omogočen Test Mode (glej točko 10).
8. Po shranjevanju bo Leanpay plačilna metoda pripravljena za aktivacijo.
9. Po končani konfiguraciji pojdite v Settings → Payments → Add payment method.
10. Nadaljujte s konfiguracijo in aktivacijo plačilne metode. Za aktivacijo plačilne metode kliknite Activate.
Nastavitev Test Mode ne določa, ali aplikacija komunicira s produkcijskim ali sandbox okoljem Leanpay. Namenjena je izključno vidnosti in obdelavi znotraj Shopifyja. Za produkcijsko uporabo onemogočite Test Mode.
11. Ko je konfiguracija zaključena, bo Leanpay plačilna metoda na voljo v checkout postopku.
- Leanpay okolje se določi glede na delivery address kupca. Na primer: slovenska Leanpay storitev in endpoint se uporabita samo, če je naslov dostave v Sloveniji in obstaja ustrezna konfiguracija.
Če se konfiguracija endpointa (API Key in Secret) odstrani in shrani, bo Leanpay plačilna metoda onemogočena za ustrezno okolje. Če za ciljno državo ni na voljo ustreznega okolja, se uporabi konfigurirani fallback environment za API klice. - Vsa konfigurirana okolja morajo ustrezati izbranemu Mode – bodisi vsa v produkciji bodisi vsa v sandboxu. Uporaba neujemajočih se poverilnic (npr. produkcijski API ključi skupaj z omogočenim sandbox načinom) bo povzročila nepravilno konfigurirane plačilne metode, ki ne bodo delovale za ustrezne destinacije ali okolja.
- Secret Word se uporablja za avtentikacijo dohodnih webhook zahtevkov iz Leanpay Gatewaya in zagotavlja njihovo celovitost ter izvor. Ta vrednost se mora natančno ujemati s konfiguracijo v Leanpay Gateway panelu, sicer posodobitve statusov naročil in plačil ne bodo delovale.
- Zaradi tehničnih razlogov Leanpay aplikacija samodejno izvede pretvorbo valute, kadar valuta, ki jo posreduje Shopify, ne ustreza pričakovani valuti ciljnega okolja (npr. Slovenija in Hrvaška zahtevata EUR, Romunija RON).
Da se izognete neskladjem, zagotovite, da je vaša Shopify trgovina nastavljena na pravilno valuto glede na shipping destination kupca. V nasprotnem primeru se lahko cena pri Shopify checkoutu razlikuje od zneska, prikazanega na Leanpay plačilni strani.
Pretvorba valute na nivoju aplikacije uporablja najnovejše razpoložljive menjalne tečaje, ki so lahko tehnično natančnejši od tistih v Shopifyju, vendar lahko kljub temu povzročijo vidne razlike v ceni za kupca. - Odstranitev Leanpay aplikacije iz Shopify trgovine bo povzročila trajen izbris vseh podatkov, povezanih s trgovino, vključno z osnovno povezavo trgovine, API konfiguracijami in vsemi povezanimi zapisi, kot so dnevniki transakcij ali webhook zgodovina.
Močno odsvetujemo odstranitev aplikacije, če obstajajo neobdelane transakcije ali čakajoča naročila. Ponovna namestitev aplikacije ne bo obnovila že obdelanih transakcij, saj se te upravljajo ločeno od Shopifyja in Leanpay Gateway strežnika.
Če želite plačilno metodo začasno onemogočiti, je priporočljivo, da v konfiguraciji počistite API keys in shranite spremembe. S tem ohranite delovanje webhookov, hkrati pa preprečite prikaz Leanpay plačila pri checkoutu. - Trenutno eno Leanpay okolje ne podpira pošiljanja webhookov v več trgovin hkrati. Na primer: če je Leanpay integriran tako z Magento kot Shopify, webhook dostava ne more biti konfigurirana za obe platformi sočasno.
Če vaša postavitev vključuje več trgovin, ki uporabljajo Leanpay plačilno metodo, se za nadaljnja navodila obrnite na Leanpay podporo.