Kuponske operacije

Prodajno mjesto: izrada, aktivacija i poništenje kupona

Ova sekcija je namijenjena inženjerima, programerima i drugim stručnim licima, koja realizuju tehničku integraciju vašeg sistema sa servisom eDostava u cilju automatizacije izrade, aktivacije i poništenja kupona. Kupon omogućava korisnicima jednostavnu dopunu računa.

Za integracione operacije sa kuponima se koriste API pozivi.

API

Za integraciju prema servisu je potreban klijentski certifikat (izdat od certifikacionog tijela priznatog zakonskom regulativom), koji može da bude isti onaj koji koristite i za autentifikaciju za korisnički pristup preko web servisnog portala. Davalac usluge vam dodijeljuje korisnički token za potrebnu autorizaciju servisa. Sa certifikatom i korisničkim tokenom možete ostvariti pristup po specifikaciji API poziva. Pogledajte praktične primjere.

Kuponi: API - SpecifikacijaKuponi: API - Praktični primjeri

Implementacija

API poziv omogućava izradu, ali i opcionalnu istovremenu aktivaciju kupona na korisničkom računu. Ukoliko je kupon na bilo koji način aktiviran (redeemed), onda ne može da se kasnije poništi preko API poziva (invalidation).

Postoje dva generalna pristupa u implementaciji:

1) Poziva se API samo za izradu kupona (redeemTarget se ne proslijeđuje kao parametar). Broj izrađenog kupona (na primjer: 123-XXXX-XXX) se prikazuje korisniku sa prodajnog mjesta. Zatim korisnik u periodu važenja kupona može samostalno da aktivira kupon i na taj način dopuni račun sa sredstvima u iznosu kupona. Kupon je moguće poništiti sve dok se ne aktivira. Prodajno mjesto odlučuje o poništavanju kupona u skladu sa svojom politikom servisa.

2) Poziva se API za izradu i istovremenu aktivaciju kupona (redeemTarget se proslijeđuje kao parametar i sadrži broj korisničkog računa). Korisnik zna broj svog računa kojeg naznačava na prodajnom mjestu - prilikom kupovine dopune, ili kao jednokratno podešavanje. Broj izrađenog kupona se može kasnije prikazati korisniku kao referenca uspješne aktivacije. Kupon nije moguće poništiti nakon aktivacije.

Poželjno je implementirati oba načina jer imaju svoju praktičnu primjenu, a posebno u slučajevima: korisnik može da proslijedi kupon drugom licu; korisnik može odmah da izvrši dopunu na svoj ili za tuđi račun odmah na prodajnom mjestu.

Dopune i aktivacija kupona

Kupone je moguće izraditi u iznosima od 5, 10, 15 i 20 EUR. U zavisnosti od iznosa postoje sljedeći tipovi kupona: DOPUNA5, DOPUNA10, DOPUNA15 i DOPUNA20. Kuponi važe u predefinisanom periodu važenja nakon kupovine. Nakon isteka važenja nije moguće aktivirati kupon i sredstva su zbog toga trajno neiskorišćena.

Korisnik aktivira kupone preko servisnog portala na linku https://preko.edostava.me/dopuna.

Važna pravila

Za korisnički token se veže mjesečni limit u ukupnoj vrijednosti do koje je moguće izraditi kupone - kao tehnička sigurnosna kontrola koja se dogovara po prodajnom mjestu.

Korisnički token se veže za prodajno mjesto. Prodajno mjesto se prikazuje u listi aktiviranih dopuna na servisnom portalu.

Izrađeni kupon je moguće poništiti isključivo ukoliko kupon nije aktiviran na korisničkom računu. Moguće je poništiti kupone sa istog prodajnog mjesta odakle su inicijalno izrađeni.