Product
Query nin
Query NIN Information
Interface Information
- Endpoint:
/order/third/facade/merchant/server/queryNin - Method:
POST - Description: Query merchant NIN (National Identification Number) information
- Encryption: Both request and response must be encrypted
Request Parameters
Content-Type: application/json
| Parameter | Type | Required | Description | Example Value |
|---|---|---|---|---|
| merchantCode | String | Yes | Merchant code | MERCHANT001 |
| data | Object | Yes | Request data | {"nin": "1234567890123"} |
| timestamp | Long | Yes | Timestamp | 1714567890000 |
| sign | String | Yes | Signature | signature |
Response Parameters
Content-Type: application/json
{ "code": "100000", "message": "SUCCESS", "data": { "result": { "nin": "1234567890123", "firstname": "John", "lastname": "Doe", "middlename": "Michael", "birthdate": "1990-01-01", "phone": "08012345678", "gender": "Male", "photo": "base64_encoded_photo_string", "residence": { "address1": "123 Abuja Street", "lga": "Municipal", "state": "FCT" } } }, "merchantCode": "MERCHANT001" }
Response Field Description
| Field | Type | Description |
|---|---|---|
| result | Object | NIN verification result |
| result.nin | String | NIN number |
| result.firstname | String | First name |
| result.lastname | String | Last name |
| result.middlename | String | Middle name |
| result.birthdate | String | Date of birth |
| result.phone | String | Phone number |
| result.gender | String | Gender |
| result.photo | String | NIN photo (Base64 encoded) |
| result.residence | Object | Residence information |
| result.residence.address1 | String | Address line 1 |
| result.residence.lga | String | Local government area |
| result.residence.state | String | State |
General Notes
- Encryption: All interfaces require encryption for both request and response
- Signature Verification: All interfaces require signature verification to ensure request authenticity
- Timestamp Format: Timestamps use millisecond precision (Unix timestamp in milliseconds)
- Request/Response Format: All data is transmitted in JSON format