PHPackages madmatt/id3global-service - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Authentication & Authorization](/categories/authentication) 4. / 5. madmatt/id3global-service ActiveLibrary[Authentication & Authorization](/categories/authentication) madmatt/id3global-service ========================= Allows a PHP-powered website to communicate with the GBG ID3global API to verify identities. This library is not affiliated with GBG PLC in any way. 1.1.0(4y ago)79.0k↓50%10[1 issues](https://github.com/madmatt/id3global-service/issues)1BSD-3-ClausePHPPHP ^7.4||^8.0 Since May 31Pushed 4y ago4 watchersCompare [ Source](https://github.com/madmatt/id3global-service)[ Packagist](https://packagist.org/packages/madmatt/id3global-service)[ Docs](https://github.com/madmatt/id3global-service/)[ RSS](/packages/madmatt-id3global-service/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (7)Dependencies (4)Versions (12)Used By (1) id3global-service ================= [](#id3global-service) Allows a PHP-powered website to communicate with the [GBG ID3global API](http://www.gbgplc.com/uk/products/gbg-id3global/) to verify identities. Installation ------------ [](#installation) ``` composer require madmatt/id3global-service ``` If you're not already using [Composer](https://getcomposer.org/) for dependency management, please consider doing so. If you'd prefer not to, you can download the latest release from the [Releases section](https://github.com/madmatt/id3global-service/releases). Usage ----- [](#usage) The WSDL file gives an overview of the values that can be provided, these will vary by country. - [Online WSDL viewer](http://www.id3globalsupport.com/Website/content/Web-Service/WSDL%20Page/WSDL%20HTML/ID3%20Global%20WSDL-%20Live.xhtml) - [Sample code per country](http://www.id3globalsupport.com/Website/Sample-Code.html) Please see the [Full Code Example](docs/full-code-example.md) that provides a complete overview of usage of this module. ### Accessing the underlying ID3global request and response [](#accessing-the-underlying-id3global-request-and-response) Depending on your use case, you may need to access the underlying request sent to ID3global, or the response returned by the ID3global API. Typical use cases of this are for auditing purposes - to confirm that identity information hasn't changed since the last time an identity verification was performed for example. In order to facilitate this, the `GlobalAuthenticationService` class has a number of helper methods to give you access to the underlying data. All of the below code assumes that you have already called the `->verifyIdentity()` method and that either you have a valid BandText, or you have caught the `IdentityVerificationFailureException` that may be thrown. ``` // Assumes $service is an instance of ID3Global\Service\GlobalAuthenticationService // Return the last SOAP request made to the ID3global API as a string $lastRawRequest = $service->getLastRawRequest(); // Returns the SoapClient interpreted response from the API (this will be an object of type \stdClass, or null if the SOAP request failed entirely // For example you can access the BandText of a valid response with $lastResponse->AuthenticateSPResult->BandText $lastResponse = $service->getLastVerifyIdentityResponse(); // Access the underlying SoapClient object to perform more detailed debugging $gateway = $service->getGateway(); // Returns a ID3Global\Gateway\GlobalAuthenticationGateway object $soapClient = $gateway->getSoapClient(); // Returns a ID3Global\Gateway\SoapClient\ID3GlobalSoapClient object // You can then do anything you'd normally do on SoapClient, such as: $lastRawRequestHeaders = $soapClient->__getLastRequestHeaders(); // Returns an array of the headers sent to the API $lastRawResponse = $soapClient->__getLastResponse(); // Returns the last response returned by the API ``` ### Debugging identity verification failures [](#debugging-identity-verification-failures) In certain circumstances, generally when the ID3Global API produces unexpected results, you may get an `IdentityVerificationFailureException` returned to you. This can happen in a number of scenarios, such as required fields being missing from the request, or data being in an invalid format. You should also wrap your `->verifyIdentity()` calls within a try/catch to prevent users from seeing these exceptions. By default, this library does not expose information in the exception message that would leak personally identifiable information, however this can be enabled if you are confident that the exception is properly handled (e.g. is being forwarded to a GDPR-compliant logging service). Sometimes this level of detail is necessary to determine why the API request failed. You can enable logging of this information via the exception message with the following configuration: ``` $service = new ID3Global\Service\GlobalAuthenticationService; // Must be set before calling ->verifyIdentity() $service->setVerboseExceptionHandling(true); // Either way, regardless of whether or not you enable verbose exception handling, IdentityVerificationFailureException will still contain the response try { $service->verifyIdentity($identity, 'customer reference'); } catch (IdentityVerificationFailureException $e) { /** @var stdClass $response */ $response = $e->getResponse(); } ``` ### Health Score 39 — LowBetter than 86% of packages Maintenance17 Infrequent updates — may be unmaintained Popularity31 Limited adoption so far Community19 Small or concentrated contributor base Maturity75 Established project with proven stability Bus Factor1 Top contributor holds 56.9% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~200 days Recently: every ~21 days Total 11 Last Release 1627d ago Major Versions 0.2.0 → 1.0.02021-09-02 PHP version history (3 changes)0.1.0PHP ~5.6 0.2.0PHP ^5.6||^7.1 1.0.0PHP ^7.4||^8.0 ### Community Maintainers ![](https://www.gravatar.com/avatar/a496a763166447513522eeff7b822da348a006ce474e5224b1fddbd839c736dc?d=identicon)[madmatt](/maintainers/madmatt) --- Top Contributors [![elnurvl](https://avatars.githubusercontent.com/u/7970970?v=4)](https://github.com/elnurvl "elnurvl (37 commits)")[![madmatt](https://avatars.githubusercontent.com/u/893117?v=4)](https://github.com/madmatt "madmatt (19 commits)")[![Firesphere](https://avatars.githubusercontent.com/u/680570?v=4)](https://github.com/Firesphere "Firesphere (7 commits)")[![mark1979smith](https://avatars.githubusercontent.com/u/6839964?v=4)](https://github.com/mark1979smith "mark1979smith (2 commits)") --- Tags identityidentity verificationID3GlobalGBGGBG PLC ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/madmatt-id3global-service/health.svg) ``` [![Health](https://phpackages.com/badges/madmatt-id3global-service/health.svg)](https://phpackages.com/packages/madmatt-id3global-service) ``` ### Alternatives [league/oauth2-client OAuth 2.0 Client Library 3.8k118.6M1.2k](/packages/league-oauth2-client)[league/oauth1-client OAuth 1.0 Client Library 99698.8M106](/packages/league-oauth1-client)[onelogin/php-saml PHP SAML Toolkit 1.3k44.0M107](/packages/onelogin-php-saml)[facile-it/php-openid-client OpenID (OIDC) Client 42592.7k7](/packages/facile-it-php-openid-client)[adam-paterson/oauth2-stripe Stripe OAuth 2.0 Client Provider for The PHP League OAuth2-Client 172.4M4](/packages/adam-paterson-oauth2-stripe)[telesign/telesign TeleSign SDK 162.1M2](/packages/telesign-telesign) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)