BIN

BIN (Bank Identification Number) lookup is an essential tool to verify payment transactions, prevent fraudulent activities, and ensure seamless payment processing. This service provides valuable insights into the issuing bank, card type, and geographic location associated with a given payment card, enabling businesses to make informed decisions and enhance security measures.

bin_lookup

POST https://secctrl.tutelar.io/api/v1/services/business_profile/bin_lookup

Post parameters description is given below,

Body	Type	Mandatory	Description
bin_number	String	Yes	BIN Number

Sample Request Body

{
  "bin_number": "100001"
}

200: Success Response

{
    "success": true,
    "code": 200,
    "message": "The request has been successfully completed.",
    "reference_id": "d4269f43-9443-4c5a-bc4a-60b4bafdd04c",
    "status": "completed",
    "result": {
        "bin": "100001",
        "brand": "LOCAL BRAND",
        "bank": "STATE BANK OF INDIA",
        "type": "DEBIT",
        "sub_brand": "CLASSIC",
        "country": "INDIA",
        "iso_1": "IN",
        "iso_2": "IND",
        "iso_3": "356"
    },
    "requested_at": "2024-03-19T06:44:25.255Z",
    "completed_at": "2024-03-19T06:44:25.318Z"
}

400: Validation Error Response

{
    "success": false,
    "code": 400,
    "message": "Invalid input. Please check your request and try again.",
    "error": {
        "message": "BIN Number should not be empty",
        "field": "bin_number",
        "code": "BAD_REQUEST"
    }
}

200: Failure Response

{
    "success": true,
    "code": 200,
    "message": "The request could not be completed due to an error.",
    "reference_id": "f04aa55e-9bed-4c9e-9bb8-7412a633cb01",
    "status": "failed",
    "error": {
        "message": "Card lookup not found or invalid. Please review the card information for accuracy.",
        "code": "ERROR"
    },
    "requested_at": "2024-03-15T06:46:04.111Z",
    "completed_at": "2024-03-15T06:46:05.490Z"
}