Sentry Search

Sentry is an inhouse built risk management system that is used to calculate each transaction’s risk score. As the transaction starts processing, we must pass request id, request type, service type, device id, request time, request status, merchant details, customer details and service details in request. If the request has valid details, we will get a score along with a weightage: low, medium, or high of the transaction.

Node Url: https://kraken.airpay.co.in/airpay/ms/sentry/api/node_search

Python Url:https://kraken.airpay.co.in/airpay/ms/sentry/api/python_search

POSTHIDE

https://kraken.airpay.co.in/airpay/ms/invoicepay/api/create

Header

Field	Type	Description
content-type	String	application/json (required)
affiliate	Text	Will be provided by Airpay (required)
checksum	Text	$string = $param.self::$secret_key; (required) sha256(<concate all values+SECRET KEY>); (required)
processor-key	Text	Will be provided by airpay ( required)

Parameter

Field	Type	Required	Description
request_id	Number	Yes	Request ID (length 8)
request_type	String	Yes	Request type can be either transaction or register (length 15)
service_type	String	Yes	Service type based on request_type. For transaction, values can be: pg - Payment Gateway nb - Net Banking (length 10)
device_id	String	No	Device ID (length 8)
request_time	Date	Yes	API request hitting time
request_status	String	Yes	Request status values can be fail, success, initiated, pending, etc.
merchant_id	Number	Yes	Merchant ID
merchant_state	String	Yes	Merchant State (length 20)
merchant_city	String	Yes	Merchant City (length 20)
activation_date	Date	Yes	Merchant activation date (YYYY-MM-DD HH:MM:SS)
merchant_type	String	Yes	Merchant type e.g. AQ, AC, DT (length 10)
company_name	String	No	Company Name (length 20)
owner_name	String	Yes	Owner Name (length 20)
zone	String	Yes	Zone based on state. Possible values: North, South, West, East (length 4)
name	String	Yes	Name (length 4-50)
phone	Number	Yes	Phone Number (length 10-15)
email	String	Yes	Email Address (length 6-50)
city	String	Yes	City Name (length 2-50)
state	String	Yes	State Name (length 2-50)
customer_ip	Number	Yes	Customer IP
domain	URL	Yes	Domain URL (length 1-50)
ip	Number	Yes	Customer IP
amount	Number	Yes	Amount (length 10-20)
card_f6	Number	Yes	First 6 digits of the card used in the transaction (length 6)
card_e4	Number	Yes	Last 4 digits of the card used in the transaction (length 4)
currency_code	String	Yes	Currency code in numeric format. Examples: 356 (IND), 784 (AED), 834 (TZS) (length 3)

Request-Example(Node):

curl --location --request POST 'https://kraken.airpay.co.in/airpay/ms/sentry/api/node_search' \
--header 'affiliate: 91f5evhk72f56432ec678sdfes685h42sd2t21k430912508233b7r37562g2hps' \
--header 'content_type: application/json' \
--header 'processor-key: 91f5evhk72f56432ec678sdfes685h42sd2t21k430912508233b7r37562g2hps' \
--header 'checksum: 91f5evhk72f56432ec678sdfes685h42sd2t21k430912508233b7r37562g2hps' \
--data-raw {
"request_id":"12345678",
"request_type":"transaction",
"service_type":"pg",
"device_id":"",
"request_time":"2022-10-31 19:10:47",
"request_status":"INITIATED",
"merchant_details":{
    "merchant_id":"78543",
    "merchant_state":"Kerala",
    "merchant_city":"Kochi",
    "activation_date":"2015-01-21 11:15:49",
    "merchant_type":"AQ",
    "company_name":"",
    "owner_name":"John",
    "zone":"South"
},
"customer_details":{
    "name":"Prayag P",
    "phone":"9XXXXXX686",
    "email":"xyz@airpay.co.in",
    "city":"Thrissur",
    "state":"Kerala",
    "customer_ip":"100.123.00.00"
},
"service_details":{
    "domain":"http:\\/\\/localhost_test",
    "ip":"100.123.00.00",
    "amount":"10.16",
    "card_f6":"612345",
    "card_e4":"9876",
    "currency_code":"inr"
}
}

Request-Example(Python):

curl --location --request POST 'https://kraken.airpay.co.in/airpay/ms/sentry/api/python_search' \
--header 'affiliate: 91f5evhk72f56432ec678sdfes685h42sd2t21k430912508233b7r37562g2hps' \
--header 'content_type: application/json' \
--header 'processor-key: 91f5evhk72f56432ec678sdfes685h42sd2t21k430912508233b7r37562g2hps' \
--header 'checksum: 91f5evhk72f56432ec678sdfes685h42sd2t21k430912508233b7r37562g2hps' \
--data-raw {
"request_id":"12345678",
"request_type":"transaction",
"service_type":"pg",
"device_id":"",
"request_time":"2022-10-31 19:10:47",
"request_status":"INITIATED",
"merchant_details":{
    "merchant_id":"78543",
    "merchant_state":"Kerala",
    "merchant_city":"Kochi",
    "activation_date":"2015-01-21 11:15:49",
    "merchant_type":"AQ",
    "company_name":"",
    "owner_name":"John",
    "zone":"South"
},
"customer_details":{
    "name":"Prayag P",
    "phone":"9XXXXXX686",
    "email":"xyz@airpay.co.in",
    "city":"Thrissur",
    "state":"Kerala",
    "customer_ip":"100.123.00.00"
},
"service_details":{
    "domain":"http:\\/\\/localhost_test",
    "ip":"100.123.00.00",
    "amount":"10.16",
    "card_f6":"612345",
    "card_e4":"9876",
    "currency_code":"inr"
}
}

Success 200

Field	Type	Description
status	Numeric	400- fail,200-success(length 3)
message	Text	success, fail
data	Text	{ “request_id”: “12345678”, “score”: 0, “weightage”: “Low” }

Success-Response:

{
  "status": 200,
  "message": "success",
  "data": {
"request_id": "12345678",
"score": 0,
 "weightage": "Low"
}

Error-Response:

{
    "status": "400",
    "message": "Failed",
    "data": ""
}