v1

latestOpenAPI 3.1.02026-07-2414704.6 MB

TAN Verification Plus

Instantpay's TAN Verification Plus API Solution goes beyond standard TAN (Tax Deduction and Collection Account Number) verification, offering a heightened level of business authentication. Seamlessly integrating this advanced tool allows organisations to verify TAN details with precision and enrich their databases with supplementary data points.

Elevate your due diligence processes with TAN Verification Plus, ensuring compliance with tax regulations while gaining a more comprehensive view of your clientele. Streamline verification, reduce the risk of errors, and enhance the security of financial operations with Instantpay's TAN Verification Plus API, a crucial component for businesses seeking advanced identity authentication.

post/verifyTan

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

tanNumberstring
latitudestring

End Customer Latitude.

longitudestring

End Customer Longitude.

externalRefstring

Your Unique Transaction id

consentstring

Consent should be accepted by customer

Response

200

statuscodestring
{"stackTrail":"paths:/verifyTan:post:responses:200:content:application/json:schema:properties:actcode","oasType":"schema","type":"unknown"}
statusstring
timestampstring
ipay_uuidstring
orderidstring
environmentstring
{"stackTrail":"paths:/verifyTan:post:responses:200:content:application/json:schema:properties:internalCode","oasType":"schema","type":"unknown"}

Example response

{
  "statuscode": "TXN",
  "status": "Transaction Successful",
  "data": {
    "tanDetail": {
      "tanNumber": "PNEA28XXXX",
      "userFullName": "Business Name",
      "tanAllotmentDate": "25-10-2018",
      "userAddress": {
        "line1": "ADD_LINE_1",
        "line2": "JEWADI ROAD",
        "line3": "XRBIA,",
        "line5": "PUNE, PUNE",
        "stateCode": "19",
        "full": "Full Address"
      },
      "userEmail": "help@instantpay.in",
      "userPhoneNumber": "7428585742"
    },
    "pool": {
      "referenceId": "1231005103330VNFPB",
      "openingBalance": "47.77",
      "paymentAmount": "3.54",
      "mode": "DR",
      "closingBalance": "44.23"
    }
  },
  "timestamp": "2023-10-05 10:33:30",
  "ipay_uuid": "h0069a4b4df1-1c60-49f7-a0ff-78902a0953e2-YcyXJlTNHQtU",
  "orderid": "1231005103330VNFPB",
  "environment": "LIVE"
}