Adulto Implementace

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:

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í

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:

<div class="adulto-cz" data-sitekey="VEREJNY_KLIC"></div>

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

<script async src="https://api.adulto.cz"></script>

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í:

if($_POST['adultocz-uid'] != NULL){
...
}

Odešlete požadavek na API:

$adultocz = json_decode(file_get_contents('https://api.result.adulto.cz/?secret=PRIVATNI_KLIC&response='.$_POST['adultocz-uid']));

Zpracujte odpověď API:

if($adultocz->{'adultocz-verify-adult'} == 'true'){
...
}

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

if($_POST['adultocz-uid'] != NULL){

    $adultocz = json_decode(file_get_contents('https://api.result.adulto.cz/?secret=PRIVATNI_KLIC&response='.$_POST['adultocz-uid']));

    if($adultocz->{'adultocz-verify-adult'} == 'true'){

        // Odpověď pokud se zákazník ověřil a je starší 18 let
        echo 'Bylo ověřeno, že jste starší 18 let. Objednávka byla zpracována.';

        // Identifikátory ověření si můžete uložit do DB
        $adulto_id = $adultocz->{'adultocz-verify-id'};
        $adulto_uid = $adultocz->{'adultocz-verify-uid'};

    }else{

        // Odpověď pokud se zákazník ověřil a je mladší 18 let
        echo 'Nemůžeme prodávat osobám mladším 18 let.';

    }

}else{

    // Odpověď pokud se zákazník neověřil
    echo 'Váš věk nebyl ověřen a bude ověřován jinak. (např. pošlete nám scan dokladu)';

}

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.