PELEZA

Identification check provider

API detail

Authentication

To create a new request you need to generate API token. Token is a combination of ApiKeys, Timestamp and Client ID

$CLIENT_ID = 1;//CLIENT_ID Assigned By Peleza
$apikey = "apikey"//apikey assigned by Peleza
$TIMESTAMP = date('Ymdhms');//current TIMESTAMP in format Ymdhms
$token = base64_encode(hash("sha256",$CLIENT_ID.$apikey.intval($TIMESTAMP)));

ApiKeyAuth

Use the token generated

| Security Scheme Type | API Key |
| Header parameter name: | Authorization |


id request

| Country Code | Alpha-3 Code e.g KEN,TZN,UGA |
|Identity Type: | NATIONAL IDENTITY , PASSPORT NUMBER , SERIAL NUMBER , ALIEN IDENTITY|

Create request to verify ID Numbers for different countries

This API is used to perform ID Check request. This API requires a token to passed in the header.

curl -X POST -H "Authorization: OGY3OGMwNDIwMmFjZTM5MGI2MmQ0ZjJjNzhiZjY2Y2EzNw==" -H "Content-Type: application/json" -d '{
"country_code": "TZN",
"identity_type": "NATIONAL IDENTITY",
"identity_number": "50067889",
"transaction_id": "1",
"callbackURL": "https://f923-41-80-98-83.eu.ngrok.io ",
"timestamp": 20220615070105,
"client_id": 336
}' "https://api.psmt.pidva.africa/api/v1/identity/request"
POST /api/v1/identity/request HTTP/1.1
Host: api.psmt.pidva.africa
Authorization: OGY3OGMwNDIwMmFjZTM5M2JhMTM2MmM4NzMDYzMGI2MmQ0ZjJjNzhiZjY2Y2EzNw==
Content-Type: application/json

{
"country_code": "TZN",
"identity_type": "NATIONAL IDENTITY",
"identity_number": "50067889",
"transaction_id": "1",
"callbackURL": "https://f923-41-80-98-83.eu.ngrok.io ",
"timestamp": 20220615070105,
"client_id": 336
}
Status200 OK
{
    "identity_type": "NATIONAL IDENTITY",
    "identity_number": "34903726",
    "identity_name": "SURNAME FIRSTNAME MIDDLENAME",
    "date_of_birth": "6/27/1998 12:00:00 AM",
    "gender": "MALE",
    "photo": "",
    "transaction_id": "1",
    "usr_password": "4*88",
    "place_of_birth": "",
    "place_of_live": "",
    "date_of_issue": "",
    "id_serial_number": "",
    "expiry_date": ""
}
Status900
{
"description": "Insufficient Credits",
"status": 900
}
Status500
{
"description": "Server Error",
"status": 500
}

dl request

| Country Code | Alpha-3 Code e.g KEN,TZN,UGA |
|Identity Type: | DLV |

Create request to verify Driving License for different countries

This API is used to perform Drivers License Check request. This API requires a token to passed in the header.

curl -X POST -H "Authorization: OGY3OGMwNDIwMmFjZTM5M2JhMTM2MmM4NzBhNTkyNzk3ZTlmYWZkNzY4MDYzMGI2MmQ0ZjJjNzhiZjY2Y2EzNw==" -H "Content-Type: application/json" -d '{
"country_code": "TZN",
"identity_type": "DLV",
"identity_number": "50067859",
"transaction_id": "1",
"callbackURL": "https://f923-41-80-98-83.eu.ngrok.io ",
"timestamp": 20220615070105,
"client_id": 336
}' "https://api.psmt.pidva.africa/api/v1/dl/request"
POST /api/v1/dl/request HTTP/1.1
Host: api.psmt.pidva.africa
Authorization: OGY3OGMwNDIwMmFjZTM5M2JhMTM2MmM4NzBhNTkyNzk3ZTlmYWZkNzY4MDYzMGI2MmQ0ZjJjNzhiZjY2Y2EzNw==
Content-Type: application/json

{
"country_code": "TZN",
"identity_type": "DLV",
"identity_number": "50067859",
"transaction_id": "1",
"callbackURL": "https://f923-41-80-98-83.eu.ngrok.io ",
"timestamp": 20220615070105,
"client_id": 336
}
Status202
{
"description": "Request is being Processed,response will be sent to callback URl",
"status": 202
}
Status900
{
    "description": "Insufficient Credits",
    "status": 900
}
Status500
{
    "description": "Server Error",
    "status": 500
}