13 620
editací
Bez shrnutí editace značka: editace z Vizuálního editoru |
značka: editace z Vizuálního editoru |
||
(Nejsou zobrazeny 2 mezilehlé verze od stejného uživatele.) | |||
Řádek 1: | Řádek 1: | ||
V následujícím textu naleznete technické specifikace aplikace. Hledáte-li uživatelskou příručku, naleznete ji [[RAPL|'''zde''']]. | V následujícím textu naleznete technické specifikace aplikace. Hledáte-li uživatelskou příručku, naleznete ji [[RAPL|'''zde''']]. | ||
{{DISPLAYTITLE:RAPL - programátorská příručka}} | {{DISPLAYTITLE:RAPL - programátorská příručka}} | ||
==RAPL - parametry== | ==RAPL - parametry== | ||
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 prvek, číslo účtu). Bez správného účetního klíče se nepodaří úspěšně založit novou konferenci. | 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 prvek, číslo účtu). Bez správného účetního klíče se nepodaří úspěšně založit novou konferenci. | ||
Řádek 70: | Řádek 71: | ||
===Struktura odpovědi:=== | ===Struktura odpovědi:=== | ||
* Guid - jednoznačný identifikátor registrace účastníka | *Guid - jednoznačný identifikátor registrace účastníka | ||
* PaymentGateUrl - odkaz na platební bránu | *PaymentGateUrl - odkaz na platební bránu | ||
* UserUrl - adresa registrace účastníka, na které si může zkontrolovat stav své platby | *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 | *Success - identifikátor, zda služba proběhla v pořádku | ||
* PaymentState - stav zaplacení (zaúčtování v SAPu) | *PaymentState - stav zaplacení (zaúčtování v SAPu) | ||
* Error - popis chyby, pokud nastala | *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. | 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. | ||
Řádek 82: | Řádek 83: | ||
<nowiki>http://rapl.upol.cz/service/CheckUserPayment?guid=77264892-9edc-47fa-adf3-e39973ac6a31&returnurl=http://</nowiki> ewic2017.upol.cz/&paymentgatereturnurl=http:// ewic2017.upol.cz/ | <nowiki>http://rapl.upol.cz/service/CheckUserPayment?guid=77264892-9edc-47fa-adf3-e39973ac6a31&returnurl=http://</nowiki> ewic2017.upol.cz/&paymentgatereturnurl=http:// ewic2017.upol.cz/ | ||
=== služba CreateRegistrationAndPay === | ===služba CreateRegistrationAndPay=== | ||
Služba provede registraci účastníka a v případě úspěšné registrace přesměruje na platební bránu. Po zaplacení je účastník přesměrován na adresu, která je uvedena v parametru ''paymentgatereturnurl''. Pokud nastane chyba během registrace účastníka, nedochází k přesměrování na platební bránu, ale na adresu uvedenou v parametru ''returnurl'', do které se doplní výstupní parametry. | Služba provede registraci účastníka a v případě úspěšné registrace přesměruje na platební bránu. Po zaplacení je účastník přesměrován na adresu, která je uvedena v parametru ''paymentgatereturnurl''. Pokud nastane chyba během registrace účastníka, nedochází k přesměrování na platební bránu, ale na adresu uvedenou v parametru ''returnurl'', do které se doplní výstupní parametry. | ||
Řádek 190: | Řádek 191: | ||
|} | |} | ||
=== Služba CreateRegistrationAndReturn === | ===Služba CreateRegistrationAndReturn=== | ||
Služba provede registraci účastníka a přesměruje na adresu uvedenou v parametru ''returnurl'', do které se doplní výstupní parametry. | Služba provede registraci účastníka a přesměruje na adresu uvedenou v parametru ''returnurl'', do které se doplní výstupní parametry. | ||
Řádek 298: | Řádek 299: | ||
|} | |} | ||
=== Služba CheckUserPayment === | ===Služba CheckUserPayment=== | ||
Služba ověří stav platby účastníka. | Služba ověří stav platby účastníka. | ||
Řádek 337: | Řádek 338: | ||
|} | |} | ||
=== Služba GetPaymentGateUrl === | ===Služba GetPaymentGateUrl=== | ||
Vygeneruje odkaz na platební bránu pro jednu registraci účastníka na akci. | Vygeneruje odkaz na platební bránu pro jednu registraci účastníka na akci. | ||
Řádek 376: | Řádek 377: | ||
|} | |} | ||
=== Služba GetRegistrationInfo === | ===Služba GetRegistrationInfo=== | ||
Vrátí informace o registraci uživatele | Vrátí informace o registraci uživatele | ||
{| class="wikitable" | {| class="wikitable" | ||
Řádek 472: | Řádek 473: | ||
<nowiki>http://gpwebpay.cz/Content/downloads/GP_webpay_Seznameni_se_systemem_072013.pdf</nowiki> | <nowiki>http://gpwebpay.cz/Content/downloads/GP_webpay_Seznameni_se_systemem_072013.pdf</nowiki> | ||
=== GetActionRegistrations === | ===GetActionRegistrations=== | ||
Služba pro vrácení informací o registrovaném účastníkovi (účastnících) podle ExternalId. | Služba pro vrácení informací o registrovaném účastníkovi (účastnících) podle ExternalId. | ||
Řádek 511: | Řádek 512: | ||
|} | |} | ||
=== GetActionVariableSymbols === | ===GetActionVariableSymbols=== | ||
Služba pro vrácení všech variabilních symbolů k akci s identifikací zda byl zaplacen nebo ne. | Služba pro vrácení všech variabilních symbolů k akci s identifikací zda byl zaplacen nebo ne. | ||
Řádek 567: | Řádek 568: | ||
|Int | |Int | ||
|} | |} | ||
=== '''GetQRCodeByUserGuid''' === | |||
Služba pro vrácení QR kódu (obrázek). Povinný parametr – Guid registrace uživatele, které je vráceno službou CreateRegistrationAndReturn nebo CreateRegistrationAndPay. Odpověď obsahuje obrázek v base64, stačí nastavit img src=”odpověď kterou vrátí služba”. | |||
Tím, že se načte QR kód vyplní se údaje o platbě v bankovní aplikaci. Platba nejde přes platební bránu, ale převodem přímo na účet. V RAPLu se projeví až po zaúčtování platby v SAPu. Do té doby, nemáme jak zjistit, že uživatel platil. U platební brány dochází k okamžité autorizaci platby. |