Inquiry Name Search



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


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



Request Header
Parameter Value
method POST
Content-Type application/x-www-form-urlencoded
Host sandbox.api.espay.id
Authorization Basic {base64_encode(user:password)}




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 search

ACU = Acuris
ACU COM = Acuris Company
ACU IND = Acuris Individual
DTTOT = list of suspected terrorist organizations
WMD = weapon mass destruction
IW = Internal Watchlist
OGK = Online Gambling
SIT = Information on Suspected Terrorism Funding
ALL = all source
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 Authorization: Basic ZXNwYXktc2lqaXR1Ojg3Njc4ampic3lnN3k5Mjc2Mg== 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==" } ] } If the name filtering results have no results : { "rq_uuid": "REQTESTNAMESCREENING0101010001", "rs_datetime": "2024-10-21 15:26:08", "error_code": "0000", "error_message": "Success", "total": 0, "data": [ { "url_pdf_detail": "https://sijitu-dev.espay.id/frontend/datadetail/eyJpdiI6Ik5NZEhnMjRMUkpUOWJvU0JaOVFXZkE9PSIsInZhbHVlIjoiaXUwM3hpZzI1enhkMkV4SWFQekZ0dGhpUUViRzBEczluN3I4YXRhS1c4VWdkUW5oZytFT3M0WGI5eERSMldHelpBUFwvenhBMDBGWTZRNGlHUndTR1pqNUxqeGQ0UVFPek1JUUZaN1wveVBMdmk1VEtibXpBU0pQYm12XC9aYWZaRUorSG1WY2Q1a1ZCUWxqQVRVWkplN1RcL2FBYnJiRng3Q2NtRDM0QitZd1p3ST0iLCJtYWMiOiI5OTAyMzQ2YzJmMjU0YmI5ODk5MmMxOGEzYmRiNDg0ODZmOTRlNWU5OWUzYWRhZWI1YzJiZjg3ZTNiZDAxMmM0In0=/pdf" } ] }