digikraaft/zeeh-php

PHP Implementation of Zeeh API

v1.1.0 2023-09-08 13:06 UTC

This package is auto-updated.

Last update: 2024-05-08 14:54:53 UTC


README

run-tests Build Status Scrutinizer Code Quality Code Intelligence Status License: MIT

This package provides an expressive and convenient way to interact with the Zeeh API.

Installation

You can install the package via composer:

composer require digikraaft/zeeh-php

Usage

All APIs documented in Zeeh's API Reference are currently supported by this package.

Authentication

Before using any of the available methods, ensure to set the public and private keys of your app. You can get this from the Zeeh's dashboard.

<?php 

include_once('vendor/autoload.php');


use Digikraaft\Zeeh\Zeeh;


Zeeh::setPrivateKey('privk_1234abcd');
Zeeh::setPublicKey('pubk_1234abcd');

Available Methods

A list of the available methods are documented below:

Account

  • all() : Array|Object - Gets all accounts available for a particular institution
  • authorize(string $accountId) : Array|Object - Authorize a Customer for transactions
  • details(string $accountId) : Array|Object - Gets a particular account in a financial institution
  • identity(string $accountId) : Array|Object - Obtains customer details
  • sync(string $accountId) : Array|Object - Make a request for a data sync operation

Bvn

  • advancedLookUp(string $bvn) : Array|Object - Generates user data from BVN
  • simpleLookUp(string $bvn) : Array|Object - Generates user data from BVN
  • verifySelfie(string, $bvn, string $base64ImageString) : Array|Object - Perform selfie verification using a valid BVN

Cac

  • advancedLookUp(string $rcNumber) : Array|Object - Fetch and verify SMEs, corporate organizations and individuals using Corporate Affairs Commission (CAC)
  • simpleLookUp(string $rcNumber) : Array|Object - Fetch and verify SMEs, corporate organizations and individuals using Corporate Affairs Commission (CAC)

DriverLicense

  • lookUp(string $licenseNumber) : Array|Object - Lookup and verify Driving License

Nin

  • lookUp(string $nin) : Array|Object - Fetch and verify customers details using National Identification Number NIN
  • verifySelfie(string, $nin, string $base64ImageString) : Array|Object - Perform selfie verification using NIN

Nuban

  • lookUp(string $bankAccountNumber) : Array|Object - Generate user data from the Nuban

Passport

  • lookUp(string $passportNumber, string $lastName, string $firstName, string $dateOfBirth) : Array|Object - Verify an international passport

PhoneNumber

  • advancedLookUp(string $phoneNumber) : Array|Object - Get advanced details of a phone number
  • simpleLookUp(string $phoneNumber) : Array|Object - Get details of a phone number

Tin

  • lookUp(string $taxIdentificationNumber) : Array|Object - Verify Tax Identification Number

Transaction

  • list(string $accountId) : Array|Object - Fetch transactions connected to an account
  • fetchStatement(string $accountId, int $period) : Array|Object - Fetch transactions connected to an account filtered by period

Vin

  • lookUp(string $vin, string $state, string $lastName) : Array|Object - Verify Voter's Identification Number

Zeeh

  • getPrivateKey(): string
  • getPublicKey() : string
  • setPrivateKey(string $privateKey) - Set your Zeeh Private Key
  • setPublicKey(string $publicKey) - Set your Zeeh Public Key
  • walletBalance() : Array|Object - Fetch current balance in your Zeeh wallet

This package returns the exact response from the Zeeh's API but as the stdClass type.

Testing

composer test

More Good Stuff

Check here for more awesome free stuff!

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Contributions are welcome! Please see CONTRIBUTING for details.

Security

If you discover any security related issues, please email hello@digikraaft.ng instead of using the issue tracker.

Credits

License

The MIT License (MIT). Please see License File for more information.