--- page_title: Card Info product: SmartGateway TranPortal Integration page_source: https://smartgateway.hdfc.bank.in/docs/smartgateway-tranportal-integration/docs/tranportal-integration/card-info openapi: https://smartgateway.hdfc.bank.in/docs/api/swagger?document=https%3A%2F%2Fsmartgateway.hdfc.bank.in%2Fdocs%2Fsmartgateway-tranportal-integration%2Fdocs%2Ftranportal-integration%2Fcard-info llms_txt: https://smartgateway.hdfc.bank.in/docs/llms.txt product_llms_txt: https://smartgateway.hdfc.bank.in/docs/smartgateway-tranportal-integration/llms.txt --- ## API Version: default # Card Info Get Card details using card bin upto 9 digits. You can also use this API to check if a card is eligible for ATM PIN, Mandate, direct OTP payments or tokenization. This S2S API requires authentication and accepts bin upto 9 digits. > **Warning** > Networks have shifted to using 9-digit BINs for more accurate information. We are still maintaining the existing 6-digit BINs for compatibility. Merchants are requested to move to the 9 digits bin based fetching card information by December 10th, 2023 ## Endpoints: - Sandbox: https://smartgateway.hdfcuat.bank.in/cardbins/{cardbin} - Production: https://smartgateway.hdfc.bank.in/cardbins/{cardbin} ## Request Type: GET ## Authorization: #### Authorization: **Basic Auth *** Base64 Encoded Username:Password Consists of two parts: * Username: API Key obtained from Juspay dashboard * Password: Empty string Example:-Basic MUQ2QUxxxxxxxxxxxxU5QTIxQzNFNTQwNkFDMEZCOg== - Tags: String, Mandatory ## Headers: #### x-resellerid: Reseller ID provided by bank - Value: hdfc_reseller - Tags: String, Required ## Sample Code Snippets: ### Sample Request: #### Request Code Snippet: ```request curl -X GET https://smartgateway.hdfc.bank.in/cardbins/405028700 \ -u your_api_key: ``` #### Request - Mandate Eligibility Code Snippet: ```request - mandate eligibility curl -X GET https://smartgateway.hdfcbank.com/cardbins/405028700?merchant_id=merchantId&options.check_mandate_support=true' \ -u your_api_key: ``` #### Request - DOTP Eligibility Code Snippet: ``` request - dotp eligibility curl -X GET https://smartgateway.hdfcbank.com/cardbins/405028700?merchant_id=merchantId&options.check_direct_otp_support=true' \ -u your_api_key: ``` #### Request - Tokenization Eligibility Code Snippet: ``` request - tokenization eligibility curl -X GET https://smartgateway.hdfcbank.com/cardbins/405028700?merchant_id=merchantId&options.check_tokenize_support=true' \ -u your_api_key: ``` ### Sample Response: #### Response: ```json { "country": "INDIA", "extended_card_type": "CREDIT", "brand": "VISA", "juspay_bank_code": "JP_HDFC", "object": "cardbin", "id": "405028700", "card_sub_type": "BHARAT", "type": "CREDIT", "bank": "HDFC Bank" } ``` #### Mandate Eligibility: ```json { "country": "INDIA", "extended_card_type": "CREDIT", "brand": "VISA", "juspay_bank_code": "JP_HDFC", "object": "cardbin", "id": "405028700", "card_sub_type": "BHARAT", "type": "CREDIT", "bank": "HDFC Bank", "mandate_support": true } ``` #### DOTP Eligibility: ```json { "country": "INDIA", "extended_card_type": "CREDIT", "brand": "VISA", "juspay_bank_code": "JP_HDFC", "object": "cardbin", "id": "405028700", "card_sub_type": "BHARAT", "type": "CREDIT", "bank": "HDFC Bank", "direct_otp_support": true } ``` #### Tokenization Eligibility: ```json { "country": "INDIA", "extended_card_type": "CREDIT", "brand": "VISA", "juspay_bank_code": "JP_HDFC", "object": "cardbin", "id": "405028700", "card_sub_type": "BHARAT", "type": "CREDIT", "bank": "HDFC Bank", "tokenize_support": true } ``` #### CVV Less Eligibility: ```json { "country": "INDIA", "extended_card_type": "CREDIT", "brand": "VISA", "juspay_bank_code": "JP_HDFC", "object": "cardbin", "id": "405028700", "card_sub_type": "BHARAT", "type": "CREDIT", "bank": "HDFC Bank", "cvv_less_support": true, "cvv_less_supported_gateways": [ "PAYU", "PAYTM_V2", "CYBERSOURCE", "RAZORPAY" ], } ``` ## Path Parameters: #### cardbin: Card bin details are required, with a variable length ranging from 6 to 9 digits. - Value: Example:- 524368 - Tags: String, Mandatory ## Query Parameters: #### merchant_id: Merchant ID which represents the merchant storing the card - Tags: string #### options.check_mandate_support: This is a boolean variable and accepts true/false. If set to `true`, then the card eligibility check for mandate transactions - Tags: boolean #### options.check_direct_otp_support: This is a boolean variable and accepts true/false. If set to true, then the card eligibility check for OTP payments will be done. - Tags: boolean #### options.check_tokenize_support: This is a boolean variable and accepts true/false. If set to true, then the card eligibility check for Tokenization payments will be done. - Tags: boolean #### options.check_cvv_less_support: This works only for Token Bins - Tags: Boolean #### is_token_bin: To check for a Token Bin instead of Card Bin - Tags: Boolean ## API Responses: ### 200: #### Card Info: - Value: - **Id**: - Description: The length, varying from 6 to 9 digits, depends on available bin data. Defaulting to a maximum length of 9 digits, with fallback to 7 or 6 digits if higher length bin information is unavailable. - Tags: String - **Card_sub_type**: - Tags: String - **Brand**: - Tags: String - **Bank**: - Tags: String - **Object**: - Tags: String - **Type**: - Tags: String - **Juspay_bank_code**: - Tags: String - **Country**: - Tags: String - Tags: JSON #### Mandate Eligibility: - Value: - **Id**: - Tags: String - **Card_sub_type**: - Tags: String - **Mandate_support**: - Tags: Boolean - **Brand**: - Tags: String - **Bank**: - Tags: String - **Object**: - Tags: String - **Type**: - Tags: String - **Juspay_bank_code**: - Tags: String - **Country**: - Tags: String - Tags: JSON #### DOTP Eligibility: - Value: - **Id**: - Tags: String - **Card_sub_type**: - Tags: String - **Brand**: - Tags: String - **Bank**: - Tags: String - **Object**: - Tags: String - **Type**: - Tags: String - **Direct_otp_support**: - Tags: Boolean - **Juspay_bank_code**: - Tags: String - **Country**: - Tags: String - Tags: JSON #### Tokenization Eligibility: - Value: - **Id**: - Tags: String - **Object**: - Tags: String - **Brand**: - Tags: String - **Bank**: - Tags: String - **Country**: - Tags: String - **Type**: - Tags: String - **Card_sub_type**: - Tags: String - **Juspay_bank_code**: - Tags: String - **Tokenize_support**: - Tags: Boolean - Tags: JSON ### 404: #### status: - Description: invalid_request_error The API returns a 404 error for unavailable bin information or when the bin length is outside the 6-9 digit range - Tags: string #### error_code: - Description: object_not_found - Tags: string #### error_message: - Description: Cannot find what you are looking for - Tags: string --- ## See Also - [Delete Card](https://smartgateway.hdfc.bank.in/docs/smartgateway-tranportal-integration/docs/tranportal-integration/delete-card) - [ALT_ID via other TR](https://smartgateway.hdfc.bank.in/docs/smartgateway-tranportal-integration/docs/tranportal-integration/altid-via-other-tr)