onfido / onfido-php
The Onfido API (v3.6)
Requires
- php: ^7.4 || ^8.0
- ext-curl: *
- ext-json: *
- ext-mbstring: *
- guzzlehttp/guzzle: ^7.3
- guzzlehttp/psr7: ^1.7 || ^2.0
Requires (Dev)
- friendsofphp/php-cs-fixer: ^3.5
- phpunit/phpunit: ^8.0 || ^9.0
- dev-master
- 8.1.0
- 8.0.0
- 7.5.0
- 7.4.0
- 7.3.1
- 7.3.0
- 7.2.0
- 7.1.0
- 7.0.0
- 6.8.0
- 6.7.0
- 6.6.0
- 6.5.0
- 6.4.0
- 6.3.0
- 6.2.0
- 6.1.0
- 6.0.0
- 5.2.1
- 5.2.0
- 5.1.0
- 5.0.2
- 5.0.1
- 5.0.0
- 4.3.0
- 4.2.0
- 4.1.3
- 4.1.2
- 4.1.0
- 4.0.1
- 4.0.0
- 3.1.0
- 3.0.0
- 2.1.0
- 2.0.0
- 1.6.0
- 1.5.0
- 1.4.0
- 1.3.0
- 1.2.0
- 1.1.1
- 1.1.0
- 1.0.1
- 1.0.0
- dev-release-upgrade
- dev-dependabot/composer/symfony/process-7.1.7
- dev-dvacca-onfido-patch-1
This package is auto-updated.
Last update: 2024-11-08 16:45:04 UTC
README
The official PHP library for integrating with the Onfido API.
Documentation can be found at https://documentation.onfido.com.
This version uses Onfido API v3.6. Refer to our API versioning guide for details of which client library versions use which versions of the API.
Installation & Usage
Requirements
PHP 7.4 and later. Should also work with PHP 8.0.
Installation
Composer
To install the bindings via Composer, add the following to composer.json
:
{ "repositories": [ { "type": "vcs", "url": "https://github.com/onfido/onfido-php.git" } ], "require": { "onfido/onfido-php": "*@dev" } }
Then run composer install
Manual Installation
Download the files and include autoload.php
:
<?php require_once('/path/to/OpenAPIClient-php/vendor/autoload.php');
Getting Started
Please follow the installation procedure and then run the following:
<?php require_once(__DIR__ . '/vendor/autoload.php'); $configuration = Onfido\Configuration::getDefaultConfiguration(); $configuration->setApiToken($_ENV['ONFIDO_API_TOKEN']); $configuration->setRegion(Onfido\Region::EU); // Supports `EU`, `US` and `CA` $onfidoApi = new Onfido\Api\DefaultApi( new \GuzzleHttp\Client([ 'timeout' => 30, 'connect_timeout' => 30, 'read_timeout' => 30 ]), $configuration);
Making a call to the API
try { $applicant = $onfidoApi->createApplicant( new Onfido\Model\ApplicantBuilder( [ 'first_name' => 'First', 'last_name' => 'Last' ]) ); // To access the information use the getter for the desired property on the object, for example: $applicant->getFirstName(); // ... } catch (Onfido\ApiException $ex) { // Handle API exception echo 'Caught exception: ', $ex->getMessage(), "\n"; }
Webhook event verification
Webhook events payload needs to be verified before it can be accessed. Library allows to easily decode the payload and verify its signature before returning it as an object for user convenience:
try { $verifier = new Onfido\WebhookEventVerifier(getenv('ONFIDO_WEBHOOK_SECRET_TOKEN')); $signature = 'a0...760e'; $event = $verifier->readPayload('{"payload":{"r...3"}}', $signature); } catch (Onfido\OnfidoInvalidSignatureError $ex) { // Invalid webhook signature }
Recommendations
Do not use square bracket syntax
Except for accessing Task object's outputs, retain from using the square bracket syntax (i.e. []
) to access not defined properties to avoid breaking changes when these fields will appear.
Contributing
This library is automatically generated using OpenAPI Generator (version: 7.9.0); therefore all the contributions, except tests files, should target Onfido OpenAPI specification repository instead of this repository.
For contributions to the tests instead, please follow the steps below:
- Fork repository
- Create your feature branch (
git checkout -b my-new-feature
) - Make your changes
- Commit your changes (
git commit -am 'Add some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create a new Pull Request
Versioning policy
Semantic Versioning policy is used for library versioning, following guidelines and limitations below:
- MAJOR versions (x.0.0) might:
- target a new API version
- include non-backward compatible change
- MINOR versions (0.x.0) might:
- add a new functionality, non-mandatory parameter or property
- deprecate an old functionality
- include non-backward compatible change to a functionality which is:
- labelled as alpha or beta
- completely broken and not usable
- PATCH version (0.0.x) might:
- fix a bug
- include backward compatible changes only
More documentation
More documentation and code examples can be found at https://documentation.onfido.com.
Support
Should you encounter any technical issues during integration, please contact Onfido's Customer Support team via the Customer Experience Portal which also includes support documentation.