https://github.com/smileidentity/smile-identity-core-ruby
The Official Smile Identity Ruby Gem
https://github.com/smileidentity/smile-identity-core-ruby
gem ruby
Last synced: 11 months ago
JSON representation
The Official Smile Identity Ruby Gem
- Host: GitHub
- URL: https://github.com/smileidentity/smile-identity-core-ruby
- Owner: smileidentity
- Created: 2019-07-19T08:11:37.000Z (almost 7 years ago)
- Default Branch: main
- Last Pushed: 2025-01-09T12:02:32.000Z (over 1 year ago)
- Last Synced: 2025-07-28T15:55:03.664Z (11 months ago)
- Topics: gem, ruby
- Language: Ruby
- Homepage: https://docs.smileidentity.com
- Size: 233 KB
- Stars: 2
- Watchers: 3
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
Awesome Lists containing this project
README
# Smile Identity Ruby 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
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 & results of a job. Read more on job status in the [Smile Identity documentation](https://docs.usesmileid.com/further-reading/job-status).
## Installation
View the package on [Rubygems](https://rubygems.org/gems/smile-identity-core).
Add this line to your application's Gemfile:
```ruby
gem 'smile-identity-core'
```
and require the package:
```ruby
require 'smile-identity-core'
```
Or install it to your system as:
```shell
gem install smile-identity-core
```
## 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/ruby).
Before that, you should take a look at the examples in the [examples](/examples) folder.
## 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://portal.usesmileid.com/partner/support/tickets) on our website.
## Contributing
Bug reports and pull requests are welcome on GitHub [here](https://github.com/smileidentity/smile-identity-core-ruby).
## License
MIT License