Pro vývojáře

1. Registrace do rozhraní

Aby bylo možné nasadit na váš e-shop prvek Adulto Ukázka je potřeba nejprve provést registraci. Po registraci získáte možnost získat pro doménu API klíče.

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 integraci prvku Adulto a komunikaci s API.

Rozhraní pro e-shopy slouží pro:

• Přidávání a správu vašich webů
• Nastavení vzhledu 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 byl umístěn ověřovací widget, vložte kód:

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

Na konec HTML kódu stránky, kde se bude zobrazovat widget, před </body> vložte:

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

Nyní se widget Adulto bude zobrazovat na vaší stránce.

Pokud chcete, aby zákazníci měli na vašem e-shopu při ověření věku k dispozici SMS/EMAIL ověření, které funguje napříč e-shopy a je určeno pro opakované ověření zákazníků, je potřeba označit textová pole <input> do kterých při objednávce zákazník zadává emailovou adresu a telefonní číslo.

Pole input pro e-mailovou adresu označte: data-adultocz="customer_email"

Pole input pro telefonní číslo označte: data-adultocz="customer_phone"

Díky označení polí bude widget Adulto schopen číst jejich obsah a vytvářet z nich unikátní HASH, který porovná s dřívějším ověřením věku zákazníka. Zákazník, který se dříve přes Adulto ověřil, díky tomu získá možnost při dalších nákupech ověřit věk verifikačním kódem.

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ý pro konkrétní doménu
• 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?

Ukázka odpovědi ve formátu JSON:

{
    "adultocz-verify-id":"2029010101",
    "adultocz-verify-uid":"95240b123f0aadf1c1e1d4ef1fga2f121f397325e342",
    "adultocz-visit-cookie":"a877e311-fc21-5500-8011-ab9a7b7f06566-1702076000000",
    "adultocz-visit-time":"2023-12-31 08:15:44",
    "adultocz-verify-status":"true",
    "adultocz-verify-adult":"true"
}

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'};

        // Smazáním cookie bude zapomenuto ověření před uplynutím časového limitu
        unset($_COOKIE['adultocz_local']);
        setcookie('adultocz_local', '', -1, '/');

    }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.';

}

6. API stav kreditu

Pokud chcete, můžete pomocí API získat informaci o aktuálním stavu kreditu (max. 5 minut zpoždění) v kreditní peněžence vašeho uživatelského účtu.

Povinné parametry pro volání API:

• URL pro volání API: https://api.result.adulto.cz/credit.status/
• Povinný GET parametr secret: Privátní API klíč získaný pro některou doménu učtu
• Povinný GET parametr response: Uživatelské jméno uživatele do rozhraní pro e-shopy

Ukázka odpovědi ve formátu JSON:

{
    "adultocz-credit-value":"1679.92"
}

8. 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é varianty odznaků ve formátu PNG a SVG pro umístění na web si můžete stáhnout tady.

9. Cena a poplatky

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

Platíte pouze za jednotlivá provedená ověření věku, dle platného ceníku.

Poplatky za ověření jsou odečítány z vaší kreditní peněženky, kterou si nabíjíte dle potřeby.