Zpět / Back
Integrace platebního tlačítka QRabbit (Pro vývojáře)
Tento dokument popisuje, jak správně integrovat platební tlačítko QRabbit do vašich fakturačních systémů, HTML e-mailových šablon nebo webových stránek.
1. Základní princip
Služba QRabbit nevyžaduje žádné API klíče ani registraci. K vytvoření platebního kiosku stačí vygenerovat správnou URL adresu obsahující detaily platby (jako URL parametry) a vložit ji do běžného HTML odkazu (<a>).
<a href="https://qrabbit.eu/?a=123456789/0100&v=1500&c=CZK" target="_blank" rel="noopener noreferrer" style="display:inline-block; background-color:#ffffff; border:2px solid #f97316; border-radius:8px; padding:6px 16px; text-decoration:none; color:#111827; font-weight:bold;">
Zaplatit přes QRabbit
</a>
Zaplatit přes QRabbit
</a>
Kritické bezpečnostní pravidlo: Vždy používejte atributy
target="_blank" a rel="noopener noreferrer". E-mailoví klienti často vykreslují e-maily v přísně izolovaných iframech (sandbox). target="_blank" zaručí, že se kiosek otevře čistě v novém panelu.2. URL Parametry
| Parametr | Povinné | Význam |
|---|---|---|
| a | Ano | Číslo účtu nebo IBAN (např. 123456/0100) |
| v | Ano | Částka (např. 1500.50) |
| c | Ano | Měna (CZK nebo EUR) |
| n | Ne | Jméno příjemce (např. Moje Firma) |
| m | Ne | Zpráva pro příjemce (např. Faktura 001) |
| vs, ss, ks | Ne | Variabilní, specifický a konstantní symbol. Povoleny pouze číslice! |
3. Příklady sestavení URL (Generování na backendu)
Příklad v PHP
$params = http_build_query([
'a' => '107107/2250',
'v' => 1478.00,
'c' => 'CZK',
'n' => 'Firma s.r.o.',
'vs' => '202640521'
]);
$buttonUrl = "https://qrabbit.eu/?" . $params;
echo '<a href="' . htmlspecialchars($buttonUrl) . '" target="_blank" rel="noopener noreferrer">Zaplatit fakturu</a>';
'a' => '107107/2250',
'v' => 1478.00,
'c' => 'CZK',
'n' => 'Firma s.r.o.',
'vs' => '202640521'
]);
$buttonUrl = "https://qrabbit.eu/?" . $params;
echo '<a href="' . htmlspecialchars($buttonUrl) . '" target="_blank" rel="noopener noreferrer">Zaplatit fakturu</a>';
Příklad v C# / .NET
var query = HttpUtility.ParseQueryString(string.Empty);
query["a"] = "107107/2250";
query["v"] = "1478.00";
query["c"] = "CZK";
query["n"] = "Firma s.r.o.";
query["vs"] = "202640521";
string buttonUrl = "https://qrabbit.eu/?" + query.ToString();
query["a"] = "107107/2250";
query["v"] = "1478.00";
query["c"] = "CZK";
query["n"] = "Firma s.r.o.";
query["vs"] = "202640521";
string buttonUrl = "https://qrabbit.eu/?" + query.ToString();
4. Tipy a časté chyby
- PDF Faktury: Pokud generujete faktury přímo do formátu PDF, mějte na paměti, že některé prohlížeče PDF nezvládají složitá HTML tlačítka. Doporučujeme pod tlačítko nebo QR kód přidat i prostý textový odkaz (např. Pro platbu klikněte zde: https://qrabbit.eu/?a=...).
- Validace symbolů: Variabilní (vs), konstantní (ks) a specifický symbol (ss) smějí obsahovat pouze číslice a jejich délka je omezena (typicky max 10 znaků). Přítomnost písmen způsobí, že bankovní aplikace platbu odmítne.
- Bezstavovost: Služba funguje jako tzv. "bezstavová" (stateless). Nic se neukládá na server. Jakákoliv data předaná přes URL parametry jsou použita výhradně k vykreslení kiosku přímo v prohlížeči uživatele.