v1

latestOpenAPI 3.1.02026-07-2414704.6 MB

PIN Code Lookup

Instantpay's PIN Code Verification Service gives businesses data on specific postal PIN codes. This helps them make better decisions and work more efficiently. This service verifies a PIN code. It then provides detailed location info. This helps with logistics, service delivery, and demographics.

The PIN Code Verification Service is ideal for businesses needing accurate regional data. It helps ensure compliance with specific geographic requirements. Use this solution to streamline location-based processes. It will improve customer service and support planning with accurate data.

get/lookup

Headers

X-Ipay-Auth-Codestring

Auth Code

X-Ipay-Client-Idstring

Unique Client Id Provided by Instantpay

X-Ipay-Client-Secretstring

Unique Client Secret Provided by Instantpay

X-Ipay-Endpoint-Ipstring

End Customer IP Address

Request body

pincodestring

pin code.

latitudestring

End Customer Latitude.

longitudestring

End Customer Longitude.

externalRefstring

Your Unique Transaction id

Response

200

statuscodestring

{"stackTrail":"paths:/lookup:get:responses:200:content:application/json:schema:properties:actcode","oasType":"schema","type":"unknown"}

statusstring

timestampstring

ipay_uuidstring

orderidstring

environmentstring

{"stackTrail":"paths:/lookup:get:responses:200:content:application/json:schema:properties:internalCode","oasType":"schema","type":"unknown"}

Example response

{
  "statuscode": "TXN",
  "status": "Transaction Successful",
  "data": {
    "poolReferenceId": "1230918180511SJUVR",
    "pool": {
      "account": "7428585742",
      "openingBal": "6.93",
      "mode": "DR",
      "amount": "0.12",
      "closingBal": "6.81"
    },
    "pincodeDetails": {
      "pincode": "110025",
      "district": "SOUTH DELHI",
      "stateName": "DELHI",
      "stateCode": "DL",
      "gstStateCode": "07",
      "stateZone": "N",
      "geoLat": "28.5621470000",
      "geoLong": "77.4532100000"
    }
  },
  "timestamp": "2023-09-18 18:05:11",
  "ipay_uuid": "h0689a29bcc1-26e3-4989-8308-d5e3398ee686-ipPleKMgk49d",
  "orderid": "1230918180511SJUVR",
  "environment": "LIVE"
}