espay logo

Inquiry Name Search



Process of checking customer data based on the name that has previously registered with the related party.



Download Image

Partners will send data to Espay then Espay will respond with JSON format containing name search results


Flow Message

Merchant -> Espay

Method

HTTP Post

API URL

Development : https://sandbox-api.espay.id/cdd/sijitu/inquiryname
Production : https://api.espay.id/cdd/sijitu/inquiryname



Parameter Request:
Parameter Name Max Length Mandatory Description
rq_uuid 64 Yes Request identifier. Unique id to identify this message with other messages
rq_datetime 19 Yes Date and time on the Espay application server when the message was sent
sender_id 32 Yes Merchant identity code registered on the Espay app
user_id 64 Yes E-mail registered at Sijitu
organization_id 32 Yes Merchant code registered at Sijitu
find_name 64 Yes Name to Search

Names that can be tested in development are as follows:

Individual Type
1. Yaw Ametepey
2. Katuicia

Entity Type / Corporation
1. Oracle
2. Sportivniye
similarity 32 No Percentage of similarity
search_type 32 No data searched (ACU = Acuris, DTTOT = list of suspected terrorists of terrorist organizations, WMD = weapon mass destruction, IW = Internal Watchlist)
country_code 2 No Country code based on ISO
dob_year 4 No Year of birth of the data being searched
is_category 1 No (Y / N).
Get value category based on result name search.
Example result :
"category": { "RCA": true, "PEP": false, "SIE": false, "SIP": false }
signature 64 Yes Signature that must be validated by Espay. Click this for details


Parameter Response:
Parameter Name Max Length Mandatory Description
rq_uuid 64 Ya Request identifier. Unique id to identify this message with other messages
rs_datetime 32 Ya Date and time on the Espay application server when the message was sent
error_code 4 Ya Error code in web service, 0000 means success
error_message 32 Ya Error description
total 32 Ya Total Data
Data 64 Ya Contains data search results by name with format Array Object

person_entity_id : ID entity

category : true / false if client send is_category = Y in parameter Request

full_name : Full Name

first_name : First Name

middle_name : Middle Name

surname : Surname

similarity : psimilarity with format number

birth_date : Birth Date based on result search, there is 3 format YYYY , YYYY-MM or YYYY-MM-DD.

source_info : Source Search results

source_info_code : Search Source Code

country_name : Country Name

occupation_category : Occupation Category

source_info_desc : Description Search source

image_profile : Profile photo Search results

url_detail : Search Result Details

 


Request

    POST /cdd/sijitu/inquiryname HTTP/1.1
    Content-Type: application/x-www-form-urlencoded
    Content-Length: 266
    Accept: /
    Host: sandbox.api.espay.id

    rq_uuid=SALDOMUSALDOMU156834234812VKI9SK1M&
    rq_datetime=2019-09-13+09:39:08&sender_id=SALDOMU&
    user_id=hendy@gmail.com&organization_id=000&find_name=setya novanto&similarity=30&search_type=DW&country_code=id&dob_year=1995&signature=aaf46a05d4a1cf7a43dfe76fac
    b784596ac09a84068ba34ab514817deba86e30
    

Response
{
    "rq_uuid": "testinquirynamesearch876PROD0045001",
    "rs_datetime": "2023-05-09 11:49:11",
    "error_code": "0000",
    "error_message": "Success",
    "total": 1,
    "data": [
        {
            "person_entity_id": "726223",
            "category": {
                "RCA": false,
                "PEP": false,
                "SIE": false,
                "SIP": true
            },
            "full_name": "Setya Novanto",
            "first_name": "Setya Novanto",
            "middle_name": "",
            "surname": "",
            "similarity": 100,
            "birth_date": "1955-11-12",
            "source_info": "Acuris",
            "source_info_code": "ACU",
            "country_name": "Indonesia",
            "occupation_category": "Special Interest Person (SIP)",
            "source_info_desc": "Acuris",
            "image_profile": "http://seputarnusantara.com/wp-content/uploads/2010/02/Setyo-N.jpg",
            "url_detail": "https://secure.sijitu.co.id/entity-detail/eyJpdiI6IlhoS293SzAzYnQ0bUFkYWZScUsrSEE9PSIsInZhbHVlIjoiSElLbHNqQkNlZ3Vra211K0tqaWxuQ2N4SXJlenNOaXliVmNmcGpMU1VTcE1DMng1akxzc3FDUmNQMXc2cWJ2dEI5YUR0a1RIQ0RaNHFwU1ROUkZvVTNzMVBEZjJaNnY2ZlNEV1wvNGk2aDhRPSIsIm1hYyI6Ijk4MTkyZmQ2YjRiYzc4YWViZjU5OTE0MzY1MTJjYzU0ZDk3YzIxYmRkMzYxZGZmZWYyOGRhYjBiZTk1MThmN2MifQ=="
        }
    ]
}