Premium Balance Check API

This API will confirm policy premium and balance confirmation by Affiliate. We must pass order id, amount and banktxnid in request. If the request has valid details, we will get a success response against the order id.

POST

URL_to_be_provided_by_affiliate

Header

Field	Type	Description
content-type	string	Value : application/x-www-form-urlencoded (required)
AFFKEY	string	Unique key for every affiliate. eg YWltdGM= (length 10)
AIRPAYKEY	string	Authentication key for airpay. Eg 91f5evhk72f56432ec678sdfes685h42sd2t21k430912508233b7r37562g2hps (length 20, required)
CHECKSUM	string	Sha256 of value of hash(‘sha256’,’(oderid)(affiliateid)(ampunt)(companyid),AIRPAYKEY) (required)

Parameter

Field	Type	Description
orderid	Alphanumeric	Reference txnid shared by affiliatewhile initiating the transaction (length 20(fixed), required)
amount	Numeric	The premium amount that will be deducted by insurance company (length 10,2; required)
banktxnid	string	Bank transaction reference id(required)

Request-Example:

--header 'content_type: application/x-www-form-urlencoded' \
--header 'processor-key: xvAvkuxKczNf8sapHZv5ia9qzPEB9iPRvtLr4iJn4SzmMjfuWgVvSsXvyw==' \
--header 'checksum: d1e2629f8b5818all186a4b7d8e5d9a03b6aef297842ec571ad0cc2278bcfcf93' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Cookie: _csrf=103936bf3ssa2098165c59d08c9288e68459dcac60bba4d83cdb7c0a17163ea6a%3A2%3A%7Bi%3A0%3Bs%3A5%3A%22_csrf%22%3Bi%3A1%3Bs%3A32%3A%22XORQcv-kviZ_teErDmi5drwuAhdUQpZE%22%3B%7D' \
--data-urlencode 'order_id=MAWEB107051612117107' \
--data-urlencode 'affiliate_id=AF0028SF1644819013' \
--data-urlencode 'amount=100.00' \
--data-urlencode 'banktxnid=ABCDXXXX'

Success 200

Field	Type	Description
status	Numeric	Api status [1- success,0-fail](length 1)
data	Jsonarray	data provided will be with orderid
message	string	Message (length 50)

Success-Response:

{
    "status": "1",
    "data": [
        {
            "orderid": 12345678901234567000
        }
    ],
    "message": "success"
}

Error-Response:

{
    "status": "0",
    "data": [
        {
            "orderid": 12345678901234567000
        }
    ],
    "message": "Duplicate Order"
}