PHPackages                             smile-identity/smile-identity-core - 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 &amp; Authorization](/categories/authentication)
4. /
5. smile-identity/smile-identity-core

ActiveLibrary[Authentication &amp; Authorization](/categories/authentication)

smile-identity/smile-identity-core
==================================

The Official Smile Identity PHP library

v4.0.3(2y ago)265.7k↓14.7%5MITPHPPHP &gt;=7.4CI passing

Since Dec 25Pushed 4mo ago2 watchersCompare

[ Source](https://github.com/smileidentity/smile-identity-core-php)[ Packagist](https://packagist.org/packages/smile-identity/smile-identity-core)[ Docs](https://github.com/smileidentity/smile-identity-core-php)[ RSS](/packages/smile-identity-smile-identity-core/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (8)Dependencies (3)Versions (11)Used By (0)

Smile Identity PHP Server Side SDK
==================================

[](#smile-identity-php-server-side-sdk)

Smile Identity provides the best solutions for real time Digital KYC, identity verification, user onboarding, and user authentication across Africa. Our server side libraries make it easy to integrate us on the server-side. Since the library is server-side, you will be required to pass the images (if required) to the library.

If you haven’t already, [sign up for a free Smile Identity account](https://usesmileid.com/talk-to-an-expert), which comes with Sandbox access.

Please see [CHANGELOG.md](CHANGELOG.md) for release versions and changes.

Features
--------

[](#features)

The library exposes four classes namely; the WebApi class, the IDApi class, the Signature class, and the Utilities class.

The WebApi class has the following public methods:

- `submit_job` - handles submission of any of Smile Identity products that requires an image i.e. [Biometric KYC](https://docs.usesmileid.com/products/biometric-kyc), [Document Verification](https://docs.usesmileid.com/products/document-verification), [SmartSelfieTM Authentication](https://docs.usesmileid.com/products/biometric-authentication) and [Business Verification](https://docs.usesmileid.com/products/for-businesses-kyb/business-verification).
- `get_web_token` - handles generation of web token, if you are using the [Hosted Web Integration](https://docs.usesmileid.com/web-mobile-web/web-integration-beta).

The IDApi class has the following public method:

- `submit_job` - handles submission of [Enhanced KYC](https://docs.usesmileid.com/products/identity-lookup) and [Basic KYC](https://docs.usesmileid.com/products/id-verification).

The Signature class has the following public methods:

- `generate_signature` - generate a signature which is then passed as a signature param when making requests to the Smile Identity server
- `confirm_signature` - ensure a response is truly from the Smile Identity server by confirming the incoming signature

The Utilities Class allows you as the Partner to have access to our general Utility functions to gain access to your data. It has the following public methods:

- `get_job_status` - retrieve information &amp; results of a job. Read more on job status in the [Smile Identity documentation](https://docs.usesmileid.com/further-reading/job-status).
- `get_smile_id_services` - general information about different smile identity products such as required inputs for each supported id type.

Dependencies
------------

[](#dependencies)

- Composer build tool

- php: &gt;= 7.4
- ext-curl: \*
- ext-json: \*
- ext-openssl: \*
- ext-zip: \*
- guzzlehttp/guzzle: ^7.0
- letsdrink/ouzo-goodies: ~1.0

Documentation
-------------

[](#documentation)

For extensive instructions on usage of the library and sample codes, please refer to the [official Smile Identity documentation](https://docs.usesmileid.com/server-to-server/php).

Before that, you should take a look at the examples in the [examples](/examples) folder.

Installation
------------

[](#installation)

### Installing from the Repository

[](#installing-from-the-repository)

Download [smile-identity-core-php repository](https://github.com/smileidentity/smile-identity-core-php) to a directory on your server where PHP and Composer is installed.

In that directory, run `composer install`

### Installing from Packagist

[](#installing-from-packagist)

View the package on [Packagist](https://packagist.org/packages/smile-identity/smile-identity-core).

Alternatively, the package can be searched locally from a composer-based project by typing the command `composer search ` in the command line where `PACKAGE_NAME` can the full name of the package (in this case `smile-identity/smile-identity-core`) or any part of the name distinct enough to return a match.

In the project's directory, run:

```
composer require smile-identity/smile-identity-core
```

Getting Help
------------

[](#getting-help)

For usage questions, the best resource is [our official documentation](https://docs.usesmileid.com/). However, if you require further assistance, you can file a [support ticket via our portal](https://portal.usesmileid.com/partner/support/tickets) or visit the [contact us page](https://usesmileid.com/company/contact-us) on our website.

Contributing
------------

[](#contributing)

Bug reports and pull requests are welcome on GitHub at

License
-------

[](#license)

MIT License

###  Health Score

44

—

FairBetter than 92% of packages

Maintenance51

Moderate activity, may be stable

Popularity36

Limited adoption so far

Community20

Small or concentrated contributor base

Maturity59

Maturing project, gaining track record

 Bus Factor3

3 contributors hold 50%+ of commits

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 ~111 days

Total

10

Last Release

964d ago

Major Versions

v1.0 → v2.0.02021-10-07

v2.0.0 → v3.0.02022-02-15

v3.2.0 → v4.0.02022-12-06

PHP version history (2 changes)v2.0.0PHP ~7.4

v3.1.0PHP &gt;=7.4

### Community

Maintainers

![](https://www.gravatar.com/avatar/df55f84fd5f7374a78adbee86bfab53790b3b70b177dcfd7e3bc367bb8db0e03?d=identicon)[smileidentity](/maintainers/smileidentity)

![](https://www.gravatar.com/avatar/a3b0d23dfe849025b2f7c949842bd4ed288f1e578900a8a786e0bb54dd042331?d=identicon)[barnabas-smile](/maintainers/barnabas-smile)

---

Top Contributors

[![ArlonTM](https://avatars.githubusercontent.com/u/4691611?v=4)](https://github.com/ArlonTM "ArlonTM (30 commits)")[![macphilips](https://avatars.githubusercontent.com/u/15909231?v=4)](https://github.com/macphilips "macphilips (16 commits)")[![osazemeu](https://avatars.githubusercontent.com/u/7466259?v=4)](https://github.com/osazemeu "osazemeu (14 commits)")[![bbares](https://avatars.githubusercontent.com/u/24418708?v=4)](https://github.com/bbares "bbares (13 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (6 commits)")[![ayinloya](https://avatars.githubusercontent.com/u/8738215?v=4)](https://github.com/ayinloya "ayinloya (5 commits)")[![mldangelo](https://avatars.githubusercontent.com/u/7235481?v=4)](https://github.com/mldangelo "mldangelo (3 commits)")[![nii-mants3](https://avatars.githubusercontent.com/u/117258864?v=4)](https://github.com/nii-mants3 "nii-mants3 (2 commits)")[![olalekan-agbaje](https://avatars.githubusercontent.com/u/1033208?v=4)](https://github.com/olalekan-agbaje "olalekan-agbaje (2 commits)")[![Kennyinspire](https://avatars.githubusercontent.com/u/30475043?v=4)](https://github.com/Kennyinspire "Kennyinspire (2 commits)")[![Yigaue](https://avatars.githubusercontent.com/u/47338915?v=4)](https://github.com/Yigaue "Yigaue (1 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/smile-identity-smile-identity-core/health.svg)

```
[![Health](https://phpackages.com/badges/smile-identity-smile-identity-core/health.svg)](https://phpackages.com/packages/smile-identity-smile-identity-core)
```

###  Alternatives

[josiasmontag/laravel-recaptchav3

Recaptcha V3 for Laravel package

2641.6M2](/packages/josiasmontag-laravel-recaptchav3)[rahul900day/laravel-captcha

Different types of Captcha implementation for Laravel Application.

10715.9k](/packages/rahul900day-laravel-captcha)[simplesamlphp/simplesamlphp-module-oidc

A SimpleSAMLphp module adding support for the OpenID Connect protocol

5016.9k1](/packages/simplesamlphp-simplesamlphp-module-oidc)[kinde-oss/kinde-auth-php

Kinde PHP SDK for authentication

2369.5k3](/packages/kinde-oss-kinde-auth-php)[descope/descope-php

Descope SDK for PHP

3814.0k](/packages/descope-descope-php)[njoguamos/laravel-turnstile

A laravel wrapper for https://developers.cloudflare.com/turnstile/

2315.9k2](/packages/njoguamos-laravel-turnstile)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
