Lisa LHV järelmaksulink oma e-poe veebilehele ning sa ei pea kliendi järelmaksutaotlusi ega lepinguid enam käsitsi vormistama. Klient saab seda kõike ise veebis teha ja sina hoiad kokku väärtuslikku aega. Arvutame kliendile järelmaksulimiidi, mida ta saab kasutada kolme kuu jooksul – see aitab kasvatada ühe kliendi ostude arvu sinu veebipoes. Järelmaksulingiga maksab su klient kiiresti ja mugavalt, mis tähendab sinu poe jaoks rohkem õnnestunud oste.
TERMINID
Kaupmehe privaatvõti (PRIVATE KEY)
Kaupmehe privaatne võti, mis tuleb sisestada e-poe-rakendusse või moodulisse.
Kaupmehe sertifikaat (CERTIFICATE)
Privaatvõtmega allkirjastatud sertifikaat tuleb edastada panka. Pank aktiveerib sertifikaadi manuaalselt ja teavitab sellest Kaupmeest.
LHV sertifikaat
LHV järelmaksulingil on sertifikaat fikseeritud ja see peab olema sisestatud e-poe-rakendusse või moodulisse. Ühendus toimib ainult juhul, kui pank on sertifikaadi eelnevalt aktiveerinud. Sertifikaadi saad alla laadida .PEM formaadis siit lingilt
Võtmepaari genereerimise juhend
Klient peab genereerima omale sertifikaatide võtmepaari.
Võtmepaari saab genereerida käsurealt openssl utiliidi abil:
openssl genrsa 2048 > privkey.pem
openssl req -new -key privkey.pem -out cert-req.pem
Järelmaksulingi päringute all on mõeldud HTTP POST päringut spetsifitseeritud parameetritega. Iga päring sisaldab endas teenuse numbrit. Igale teenusele vastab oma loetelu parameetritest ja päringu käsitlemise algoritm. Käesoleval lehel on välja toodud päringute spetsifikatsioonid, milles igale teenusele vastab oma loetelu parameetritest. Toimiva teenuse koostamiseks ei tohi lisada ühtegi parameetrit, mida pole spetsifikatsioonis kirjas ja tuleb järgida dokumendis välja toodud juhiseid.
Kasutatavad teenuskoodid on:
5011 - Taotluse edastamine pangale
5112 - Panga poolne positiivne vastus
5113 - Panga poolne negatiivne vastus
Päringud tuleb suunata järgnevale linkidest:
Live versiooon: https://lhv.ee/coflink
Testversioon: https://lhv.ee/coflink?testRequest=true
Testversiooni kasutamisel päring valideeritakse ja suunatakse edasi testlehele, kus on võimalik nupvajutusega valida panga poolse vastuspäringu. 5111 vastuspäring on positiivne ning 5113 on negatiivne. Käesolevate testpäringute sisud ei jõua Dealer portaali ning see on mõeldud ainult liideste testimiseks. Testimiseks on kohustuslik kasutada võtmepaare ja on vajalik kehtiv leping.
| Jrk | Välja nimi | Pikkus | Kirjeldus | Näidis |
|---|---|---|---|---|
| 1 | VK_SERVICE | 4 | Teenuse number | 5011 |
| 2 | VK_VERSION | 3 | Kasutatav krüptoaloritm | 008 |
| 3 | VK_SND_ID | 15 | Päringu koostaja (Kaupmehe) ID. | testfirma |
| 4 | VK_REC_ID | 20 | Päringu vastuvõtja | LHV |
| 5 | VK_STAMP | 20 | Päringu koostaja ajatempel | 11082021 |
| 6 | VK_DATA | 4096 | Päringu lisainfo XML fomaadis | <CofContractProductList><CofContractProduct><Name>LCD</Name><Code>1122</Code><Currency>EUR</Currency><CostInclVatAmount>120</CostInclVatAmount><CostVatPercent>20</CostVatPercent></CofContractProduct><ValidToDtime>2015-02-05T07:18:11+02:00</ValidToDtime></CofContractProductList> |
| 7 | VK_RESPONSE | 255 | URL vastuspäringu saatmiseks | https://epood.lhv/?response |
| 8 | VK_RETURN | 255 | URL kuhu klient suunatakse | https://epood.lhv/?return |
| 9 | VK_DATETIME | 25 | Päringu algatamise kuupäev ja kellaaeg, mis tuleneb serveri poolsest ajatemplist. Kellaag peab olema ISO 8601 formaadis sekundi täpsusega koos ajatsooni infoga.. Väärtus tohib erineda +-5 minutit. | 2021-08-25T14:00:24+03:00 |
| 10 | VK_MAC | 700 | Kontrollkood ehk allkiri, tehniliselt genereeritud ja dünaamiliselt muutuv. | EUC5hUnE/wwZ9KSQH2vbsXDKAi |
| 11 | VK_ENCODING | 12 | Sõnumi kodeering. Vaikimisi UTF-8 ning võib kasutada alternatiivina ISO 8859-1 või WINDOWS-1257 | UTF-8 |
| 12 | VK_LANG | 3 | EST või RUS. Defineerib ära, mis keelsesse süsteemi LHV portaalis suunatakse | EST |
| 13 | VK_EMAIL | 255 | Kliendi e-mail – Kasutatakse eeltäidetud infona LHV portaalis. | eesnimi.perekonnanimi@eesti.ee |
| 14 | VK_PHONE | 25 | Kliendi telefoninumber kujul +37212345678 Kasutatakse infona LHV portaalis. | +37251234567 |
| Jrk | XML välja nimetus | Kirjeldus |
|---|---|---|
| 1 | <CofContractProductList> | Ostukorvi toodete nimekiri |
| 2 | <CofContractProduct> | Ostukorvi toode |
| 3 | <Name> | Toote või teenuse nimi (maksimaalselt 250 tähemärki) |
| 4 | <Code> | Toote või teenuse tootekood (maksimaalselt 50 tähemärki) ei ole kohustuslik |
| 5 | <Currency> | Fikseeritult väärtus EUR |
| 6 | <CostInclVatAmount> | Toote maksumus koos käibemaksuga. Sendid eraldada punktiga |
| 7 | <CostVatPercent> | Toote käibemaksu protsent |
| 8 | <ValidToDtime> | Ostukorvi kehtivusaeg. ISO 8606 formaadis. Aeg peab olema defineeritud tulevikku. |
| Jrk | XML välja nimetus | Kirjeldus |
|---|---|---|
| 1 | <CofContract> | Kliendi ja LHV Finance vaheline leping |
| 2 | <IdCode> | Taotleja isikukood |
| 3 | <IdCodeIssuer> | Taotleja isikukoodi väljastajariigi 2 kohaline kood |
| 4 | <FullName> | Taotleja täisnimi |
| 5 | <ContractStatusCode> | Lepingu staatus. READY_FOR_CONTRACT_SIGNING või CONTRACT_SIGNED |
| 6 | <ContractNumber> | Lepingu number |
| 7 | <ContractDownPaymentAmount> | Lepingu sissemakse |
| 8 | <ContractFeeAmount> | Lepingutasu |
| 9 | <CustomerEmail> | Taotleja e-mailiaadress |
| 10 | <CustomerPhone> | Taotleja telefoninumber |
| 11 | <CustomerCountryCode> | Taotleja 2 kohaline riigikood |
| 12 | <CustomerCity> | Taotleja linn |
| 13 | <CustomerStreetAddress> | Taotleja aadress |
| 14 | <CustomerPostalCode> | Taotleja aadressi postiindeks |
| 15 | <SigningDtime> | Lepingu allkirjastamise kellaaeg ja kuupäev ISO 8601 formaadis sekundi ja ajatsooni infoga. |
| Jrk | XML välja nimetus | Kirjeldus |
|---|---|---|
| 1 | <CoflinkContract> | Kliendi ja LHV Finance vaheline leping |
| 1 | <Message> | Sõnum saatuse kohta. Ainuvõimalik vastus on "Application was rejected" |
Päringutes kasutatava elektroonse allkirja VK_MAC arvutus toimub kokkuleppelise algoritmi alusel. Algoritmi versiooni määrab päringu parameeter VK_VERSION. Hetkel on kasutusel ainult versioon 008. Allkiri VK_MAC edastatakse päringutes BASE64 kodeerituna, VK_MAC(MAC008) arvutatakse kasutades avaliku võtme algoritmi RSA ning räsialgoritmi SHA-1. MAC008(x1,x2,…,xn) := RSA( SHA-1(p(x1)|| x1|| p(x2)|| x2 || … ||p( xn )||xn), d, n).