14 038
editací
(Založena nová stránka s textem „RAPL Pro správnou práci s aplikací je nejprve nutné založit účetní klíč, který určí, jak a kam se zaúčtují platby na konferenci (např. SPP…“) |
Bez shrnutí editace značka: editace z Vizuálního editoru |
||
Řádek 1: | Řádek 1: | ||
Pro správnou | |||
Pro správnou práci | práci s aplikací je nejprve nutné založit účetní klíč, který určí, jak a | ||
kam se zaúčtují platby na konferenci (např. SPP prvek, číslo účtu). Bez | |||
správného účetního klíče se nepodaří úspěšně založit novou konferenci. | |||
Při založení | |||
nové akce (konference) je potřeba vyplnit veškeré povinné údaje, které jsou | |||
označeny hvězdičkou. Je nutné zadat správný účetní klíč. Aplikace rozpozná, zda | |||
je zadaný účetní klíč platný či neplatný. Mezi další důležité údaje patří měna, | |||
tajný kód a SPP prvek. | |||
Zvolená měna se | |||
bude zobrazovat v platební bráně při zaplacení konference platební kartou. | |||
Tajný kód je jedinečný identifikátor akce, který je vždy potřeba uvést | |||
v odkazu pro registraci na danou konferenci. SPP prvek je možné vyplnit | |||
pro kontrolu. | |||
Webové stránky | |||
konference musí při registraci nového účastníka vygenerovat odkaz na | |||
konferenci. Ten musí kromě adresy RAPLu obsahovat i následující parametry: | |||
- | |||
RAPL - Služba | '''''conference''''' = tajný kód – povinný | ||
parametr | |||
- | |||
'''''conferenceid''''' = id konference – | |||
povinný parametr | |||
- | |||
'''''email''''' = e-mailová adresa účastníka, | |||
která slouží jako přihlašovací jméno – povinný parametr | |||
- | |||
''firstname'' | |||
= jméno účastníka | |||
- | |||
''surname'' | |||
= příjmení účastníka | |||
- | |||
''institutionname'' | |||
= název instituce, za kterou se účastník hlásí | |||
- | |||
''institutionstreet'' | |||
= adresa instituce - ulice | |||
- | |||
''institutioncity'' | |||
= adresa instituce - obec | |||
- | |||
''institutionzip'' | |||
= adresa instituce - PSČ | |||
- | |||
''institutioncountry'' | |||
= adresa instituce - stát | |||
- | |||
''price'' | |||
= cena konference pro účastníka | |||
- | |||
''currency'' | |||
= měna, ve které bude účastník platit za konferenci, měla by být shodná | |||
s měnou založené konference | |||
Po kliknutí na | |||
odkaz vytvořený na stránkách konference se účastníkovi otevře registrační | |||
formulář s předvyplněnými údaji. Účastník konference musí vyplnit pouze | |||
chybějící informace a heslo. Po uložení registračního formuláře bude ihned | |||
přihlášen do aplikace. | |||
V případě | |||
placené konference bude uživateli po uložení registrace přidělen variabilní | |||
symbol. Zaplatit poplatek je možné ihned či později. Do aplikace se účastník | |||
může přihlásit pomocí své e-mailové adresy a hesla, které si zvolil. Účastník | |||
má k dispozici přehled všech svých registrací na konference včetně stavu | |||
plateb. | |||
== RAPL - Služba == | |||
Na adrese rapl.upol.cz/service je možné volat služby pro zakládání účastníků, zjištění stavu platby (podle guid) a vytvoření odkazu na platební bránu (podle guid). | Na adrese rapl.upol.cz/service je možné volat služby pro zakládání účastníků, zjištění stavu platby (podle guid) a vytvoření odkazu na platební bránu (podle guid). | ||
K tomuto je nutné použít metodu POST. | K tomuto je nutné použít metodu POST. | ||
Akce dostupné ve službě: | === '''Akce dostupné ve službě:''' === | ||
CreateRegistration – založení účastníka | CreateRegistration – založení účastníka | ||
CheckUserPayment – stav platby VS | CheckUserPayment – stav platby VS | ||
GetPaymentGateUrl – odkaz na platební bránu | GetPaymentGateUrl – odkaz na platební bránu | ||
Vstupní parametry: | === '''Vstupní parametry:''' === | ||
==== CreateRegistration ==== | |||
* secret – tajný kód (dodaný - podle akce) | |||
* actionid – id akce (dodané - podle akce) | |||
* firstname – jméno účastníka | |||
* surname – příjmení účastníka | |||
* email – e-mail účastníka | |||
* price – cena | |||
* returnurl – adresa, na které se očekává výsledek | |||
* paymentgatereturnurl – adresa, na kterou je účastník přesměrován po zaplacení na platební bráně | |||
* guid – jednoznačný identifikátor registrace účastníka, pokud není zadán, tak se vygeneruje sám a pošle se v odpovědi. | |||
==== CheckUserPayment ==== | |||
* guid – jednoznačný identifikátor registrace účastníka (je vrácen při registraci) | |||
==== GetPaymentGateUrl ==== | |||
* guid – jednoznačný identifikátor registrace účastníka (je vrácen při registraci) | |||
=== '''Struktura odpovědi:''' === | |||
* Guid - jednoznačný identifikátor registrace účastníka | |||
* PaymentGateUrl - odkaz na platební bránu | |||
* UserUrl - adresa registrace účastníka, na které si může zkontrolovat stav své platby | |||
* Success - identifikátor, zda služba proběhla v pořádku | |||
* Paid - stav zaplacení (zaúčtování v SAPu) | |||
* Promise - stav zaplacení kartou | |||
* Error - popis chyby, pokud nastala | |||
Odpověď ve formátu JSON přijde vždy na adresu, která | |||
je zadaná v parametru returnurl, příp. je vždy vypsaná v html stránce služby. | |||
=== '''Příklad volání:''' === | |||
<nowiki>http://rapl.upol.cz/service/CheckUserPayment?guid=77264892-9edc-47fa-adf3-e39973ac6a31&returnurl=http://</nowiki> ewic2017.upol.cz/&paymentgatereturnurl=http:// ewic2017.upol.cz/ | |||
Příklad volání: | |||
http://rapl.upol.cz/service/CheckUserPayment?guid=77264892-9edc-47fa-adf3-e39973ac6a31&returnurl=http:// ewic2017.upol.cz/&paymentgatereturnurl=http:// ewic2017.upol.cz/ |