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.

1. Prijavite se v Leanpay aplikacijo za želeno okolje (testno ali produkcijsko).

2. Pojdite v razdelek Company.

3. Pomaknite do razdelka Development in pridobite:
– API key in
– Pre-qualify URL.
API key je ključen za sinhronizacijo razpoložljivih obročnih načrtov (installment plans) za vaš račun.

4. Obiščite Shopify integracijski endpoint na https://installmentapp.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. API key in Pre-qualify URL sta na voljo v Leanpay Gateway panel pod Company → Development.

– Izberite ustrezno API environment in mode za izbrani API key.
– Nastavitev Payment Information URL je izbirna. Če je URL nastavljen in vodi na stran, ki pojasnjuje možnosti plačilne metode, bo uporabljen v gumbu znotraj widgetov (“More information”).

8. Po shranjevanju (“Save & Sync plans”) bo izbirni seznam Installment group dropdown samodejno napolnjen.

9. Izberite in aktivirajte skupino, ki bo uporabljena za vse front-end calculations. Aplikacija bi morala biti zdaj konfigurirana in pripravljena za prikaz widgetov.

1. Pojdite na Store → Themes → “Customize” aktivne teme.

2. Na voljo bodo trije novi widgeti:

Product Widget

Vstavite v želeno območje znotraj strani izdelka. Dodatne nastavitve niso potrebne.

Horizontal Widget

Vstavite v katerokoli območje z večjo širino (npr. collection head).
Vrednost cene je nastavljiva ročno.

Vertical Widget

Vstavite v katerokoli območje z manjšo širino. Idealno za mobilne poglede ali sidebars.
Niz vrednosti cene (price value string) je nastavljiv ročno.

Privzeto Product widget (calculator) ne podpira dogodkov spremembe cene ob menjavi variante (price variant change events) zaradi specifik implementacije v Shopifyju. Ker vsaka tema upravlja posodobitve cen drugače, ne obstaja standardiziran način za zaznavanje teh dogodkov.

Za odpravo te omejitve in zagotavljanje združljivosti s prilagoditvami aplikacij tretjih oseb Leanpay Marketing Tools ponuja programski način za sprožanje posodobitev cene ob spremembi variant.

Primer implementacije:

// Example: When variant changes
function onVariantChange(variant) {
 // Your existing variant change logic...

 // Notify Leanpay widget of price change
 if (variant && variant.price) {
   window.dispatchEvent(new CustomEvent('leanpay:priceChange', {
     detail: {
       price: variant.price / 100  // Convert cents to currency units
     }
   }));
 }
}

// Example: When quantity changes
function onQuantityChange(quantity) {
 const basePrice = 99.99;
 const newPrice = basePrice * quantity;

 window.dispatchEvent(new CustomEvent('leanpay:priceChange', {
   detail: {
     price: newPrice
   }
 }));
}

Za podrobne informacije o obravnavi sporov se obrnite na uradno Leanpay dokumentacijo.

Pri izdaji vračila za plačano naročilo je obvezno vrniti celoten znesek originalnega plačila. Delna vračila niso podprta, saj se v tej integraciji ne obravnavajo kot klasična vračila in lahko povzročijo tehnične težave v Shopifyju.

Če znesek vračila ne ustreza natančno celotnemu plačanemu znesku (vključno z vsemi izdelki in stroški dostave), bo zahteva zavrnjena z napako.

Za uspešno obdelavo vedno izberite vse izdelke naročila in pripadajoče shipping cost pri oddaji vračila.