README

这是一个 Onfido REST API 的 PHP API 客户端。

我们尽量保持这个库与原始版本保持一致，因此可以按照文档说明使用。

为了运行测试，你必须更新 AbstractTest 文件中的你的 API 令牌。测试质量较差，因为它们依赖于你的 Onfido 账户中的数据（例如客户 ID）。

这些是 Onfido 提供的原始单元测试。

此分支（master）对原始 SDK 进行了修改。此版本返回数组而不是 StdClass 实例或字符串。

安装

您可以从源代码获取 onfido-php

$ git clone https://gitlab.com/mah.shamim/hits-laraval-onfido.git

或者您可以通过 composer 安装

$ composer require mahshamim/hits-onfido

使用方法

最初，您需要导入 autoload.php 文件，初始化 Config，并设置 Token

require_once('autoload.php');

\Onfido\Config::init()->set_token('YOUR TOKEN');

申请人

申请人 端点支持两个操作 - `create()`和`get()`

创建申请人

$applicant = new \Mahshamim\Onfido\Applicant();
$applicant->first_name = 'John';
$applicant->last_name = 'Smith';
$applicant->email = 'email@server.com';

$address1 = new \Mahshamim\Onfido\Address();
$address1->postcode = 'abc';
$address1->town = 'London';
$address1->country = 'GBR';

$applicant->addresses = Array($address1);

$response = $applicant->create();

检索申请人

`APPLICANT_ID` 应该是您想要检索的申请人的 ID。

$applicant = (new \Mahshamim\Onfido\Applicant())->get(APPLICANT_ID);

列出申请人

`->paginate(2, 5)` 表示获取第 2 页，每页有 5 个申请人，两者都可以为 null 以忽略

\Mahshamim\Onfido\Config::init()->set_token('YOUR TOKEN')->paginate(2, 5);

$applicants = (new \Mahshamim\Onfido\Applicant())->get();

文件

文件 端点支持一个操作 - `upload_for()`

上传文件

$document = new \Mahshamim\Onfido\Document();

$document->file_name = 'file.jpg';
$document->file_path = '/path/to/file.jpg';
$document->file_type = 'image/jpg';
$document->type = 'passport';
$document->side = 'front';

$response = $document->upload_for(APPLICANT_ID);

检查

检查 端点支持两个操作 - `create_for()`和`get()`

创建检查

$check = new \Mahshamim\Onfido\Check();
$check->type = 'standard';

$report1 = new \Mahshamim\Onfido\CheckReport();
$report1->name = 'identity';

$check->reports = Array(
    $report1
);
$response = $check->create_for(APPLICANT_ID);

检索检查

$check = (new \Mahshamim\Onfido\Check())->getCheckRetrieve(CHECK_ID);

列出检查

\Mahshamim\Onfido\Config::init()->set_token('YOUR TOKEN')->paginate(null, 5);

$checks = (new \Mahshamim\Onfido\Check())->getCheckList(APPLICANT_ID);

报告

报告 端点支持一个操作 - `get()`

检索报告

$report = (new \Mahshamim\Onfido\Report())->getReportRetrieve(REPORT_ID);

列出报告

$report = (new \Mahshamim\Onfido\Report())->getReportList(CHECK_ID);

地址选择器

您可以使用 Onfido 的 地址选择器，例如

$address = new \Mahshamim\Onfido\AddressPicker();
$address->postcode = 'SW4 6EH';
$addresses = $address->pick();

运行测试

您需要安装最新版本的 phpunit。然后

phpunit Applicants.php

将运行与申请人端点操作相关的测试，并以可读的方式显示结果。您还可以运行其他测试，如：检查、文件和报告。