Adulto implementace

1. Registrace do rozhraní

Aby bylo možné nasadit na váš e-shop prvek Adulto Ukázka je potřeba nejprve provést registraci. Na základě registrace získáte API klíče potřebné pro implementaci.

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 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 verifikaci, která funguje napříč e-shopy, 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šími ověření dokladem totožnosti. Zákazník, který se dříve přes Adulto ověřil dokladem totožnosti, díky tomu získá možnost ověřit věk SMS 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?

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

}

7. 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.

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 - ověření dokladu totožnosti: 8.00,- Kč

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