QUIQQER Verification

quiqqer/verification

<?php

use QUI\Verification\Interface\LinkVerificationHandlerInterface;
use QUI\Verification\Interface\PhoneNumberVerificationHandlerInterface;
use QUI\Verification\Interface\AddressVerificationHandlerInterface;

class MyLinkVerificationHandler implements LinkVerificationHandlerInterface
{
  // Implement the interface
}

class MyPhoneNumberVerificationHandler implements PhoneNumberVerificationHandlerInterface
{
  // Implement the interface
}

class MyAddressVerificationHandler implements AddressVerificationHandlerInterface
{
  // Implement the interface
}

<?php
use QUI\Verification\VerificationFactory;
use QUI\Verification\Enum\PhoneNumberVerificationStrategy;
use QUI\Verification\Verifier;
use QUI\Verification\VerificationRepository;

$factory = new VerificationFactory();

// Link verification
$linkVerification = $factory->createLinkVerification(
    'my-custom-identifier', // use any string that uniquely identifies your verification process
    new MyLinkVerificationHandler(),
    [
        'customData' => 'my custom data' // customer data is available in the verification that is returned
    ],
    false // overwrite existing verifications with the same identifier if it already exists; otherwise an exception is thrown if the verification with the same identifier already exists
);

$url = $linkVerification->getVerificationUrl();

// If this special URL is called, an instance of MyLinkVerificationHandler will be called
// Depending on if the hash is valid and the verification process is not expired, onSuccess() or onError() will be called

// Phone number verification
$phoneNumberVerification = $factory->createPhoneNumberVerification(
    'my-custom-identifier',
    new \QUI\PhoneApi\Entity\PhoneNumber('+49123456789'), // entity class can be found in quiqqer/phone-api
    PhoneNumberVerificationStrategy::CALL, // or ::SMS
    new MyPhoneNumberVerificationHandler(),
    [
        'customData' => 'my custom data'
    ],
    'ABC123' // Optional: You can provide a specific verification code; if omitted, a random one will be generated
);

// The user gets a call or SMS with a verification code
// You have to build a form where this code can be entered
// Then you fetch the verification instance by identifier depending on the context; e.g.:

$verificationRepository = new VerificationRepository();
$phoneNumberVerification = $verificationRepository->findByIdentifier('my-custom-identifier');

// The code can be verified in the following way:
$verifier = new Verifier();

// This will verify the code, call an instance of MyPhoneNumberVerificationHandler and additionally throw an exception on any kind of verification error (which you can just catch and ignore if you want your handler to handle everything)
$verifier->verifyPhoneNumberVerification($phoneNumberVerification, 'code_entered_by_user');

// Address verification
$addressVerification = $factory->createAddressVerification(
    'my-custom-identifier',
    new \QUI\Verification\Entity\Address('John Doe', 'My Street', '2B', '12345', 'My City', 'DE'),
    new MyAddressVerificationHandler(),
    [
        'customData' => 'my custom data'
    ],
    'ABC123' // Optional: You can provide a specific verification code; if omitted, a random one will be generated
);

// Send the letter (e.g. with quiqqer/letter-dispatch)

// The verification process is identical to the phone number
$verifier->verifyAddressVerification($addressVerification, 'code_entered_by_user');