Adulto Implementace

Hotové doplňky

Pokud pro provoz svého e-shopu používáte Shoptet nebo WooCommerce máme pro Vás připraveny hotové doplňky pro snadnou instalaci a použití služeb Adulto - ověření věku zákazníků.


Pro vývojáře

1. Registrace do rozhraní

Aby bylo možné nasadit na Váš web prvek Adulto Ukázka je potřeba nejprve provést registraci.

Proveďte registraci do rozhraní pro e-shopy na adrese partner.adulto.cz.


2. Nastavení služeb

Rozhraní pro e-shopy najdete na adrese partner.adulto.cz:

adulto rozhraní pro e-shopy

Po přidání webu získáte API klíče pro implementaci prvku Adulto a komunikaci s API.

Rozhraní pro e-shopy slouží pro:

  • Přidávání a správu vašich webů
  • Nastavení vzhledu a funkčnosti ověřovacího prvku
  • Nabíjení peněženky
  • Ukládání daňových dokladů za provedené platby
  • Přehledy ověření zákazníků, volání API a transakcí
funkce rozhraní pro e-shopy

3. Umístění widgetu pro vývojáře

Pro vykreslení widgetu (prvku) Adulto na vaší stránce je nutné zahrnout potřebného zdroje JavaScriptu a adulto-cz značky. Značka adulto-cz je prvek DIV s názvem třídy adulto-cz a veřejným API klíčem vašeho webu v data-sitekey atributu.

Na místo, kde chcete, aby, bylo ověřovací tlačítko, vložte kód:



Na konec HTML Vašeho webu, do patičky, před </body> vložte Javascript:


Nyní se prvek Adulto bude zobrazovat na vaší stránce. Ukázka

4. Komunikace API pro vývojáře

Pokud chcete pracovat s výsledky ověření automatizovaně, použijte následující API.



Povinné parametry pro volání API:

  • URL pro volání API: https://api.result.adulto.cz
  • Povinný GET parametr secret: Privátní API klíč získaný po registraci
  • Povinný GET parametr response: Token uživatele adultocz-uid

Odpověď API je ve formátu JSON a při správném volání obsahuje:

  • adultocz-verify-id string identifikátor
  • adultocz-verify-uid string identifikátor
  • adultocz-visit-cookie string identifikátor cookie adultocz_local uživatele
  • adultocz-visit-time YYYY-MM-DD HH:MM:SS - kdy proběhlo ověření?
  • adultocz-verify-method string bankid/mojeid/ocrid - metoda ověření
  • adultocz-verify-status true/false - proběhlo ověření?
  • adultocz-verify-adult true/false - je starší 18 let?

5. Příklad komunikace pro vývojáře

Zkontrolujte, zda proběhlo ověření:


Odešlete požadavek na API:


Zpracujte odpověď API:


Celý příklad použití v PHP:


6. Grafika pro umístění na web

Pokud chcete, můžete na svůj web umístit grafiku, která informuje zákazníky o použití ověření věku.

Různé barvy a velikosti grafických bannerů si můžete stáhnout tady.


7. Pravidla implementace pro vývojáře

  • Pro použítí musí být vaše stránka zabezpečena pomocí HTTPS.
  • V souladu s podmínkami použití Bankovní identity je zákazníka nutné ověřit při každém nákupu, nelze si ověření zákazníka ukládat pro účely více objednávek nebo pro jeho registraci.
  • Limit volání API je 500 požadavků za hodinu, pokud potřebujete vyšší limit, kontaktujte nás.
  • Při implementaci nesmíte zasahovat do vzhledu ani funkčnosti ověřovacího widgetu.

V případě porušení těchto pravidel je poskytovatel oprávněn omezit nebo zrušit poskytování služby.

8. Cena a poplatky

Služba je poskytována bez aktivačních a měsíčních poplatků.

Ověření věku zákazníka - bankovní identita: 6.80,- Kč

Ověření věku zákazníka - mojeID: 1.00,- Kč

Ověření věku zákazníka - OCR dokladu totožnosti: 8.00,- Kč

Ceny jsou uvedeny bez DPH. Dodavatel je plátcem DPH.

9. Zákaznická podpora

Pokud vám něco není srozumitelné nebo si nevíte rady, jsme připraveni pomoci: