README

VerifyOnce 验证服务集成库。

使用方法

通过 Composer 将库添加到您的项目中

composer require ultraleet/verify-once

通过实例化核心类初始化库

$verifyOnce = new \Ultraleet\VerifyOnce\VerifyOnce([
    'username' => '', // Integrator username
    'password' => '', // Integrator password
]);

要启动验证交易，请执行以下操作

$response = $verifyOnce->initiate();

响应将包含 'transactionId' 和 'url' 属性的对象。您应将交易 ID 与用户信息一起存储，并将用户重定向到提供的 URL 以进行验证过程。

验证完成后，VerifyOnce 将包含验证信息的 JWT 签名有效负载发布到您的回调 URL。要验证有效负载，您可以使用库的 verify 方法。

$body = file_get_contents('php://input');
$info = $verifyOnce->verify($body);

确保捕获任何表示有效负载验证不成功的异常。

$info 将包含验证信息。您可以通过 $info->transaction->id 获取交易 ID 以与之前存储的值进行比较，以找到执行验证的用户。

根据您是否想要验证用户的身份、地址或两者，您需要检查 $info->identityVerification 和/或 $info->addressVerification。如果其中任何一个为空，则表示尚未成功验证。

接下来，您将想要检查验证状态，这是上述对象中的 status 属性。它可以包含以下值

  UNINITIATED
  INITIATED
  PENDING
  VERIFIED
  FAILED
  LOCKED

这些应该相当直观。

如果状态是 VERIFIED，您可以继续检查所需字段的值，以确认您有正确的用户/地址。