paytm developer docs logoDeveloperDocumentation
search

GETGet Token Info API

Use Case

Used to fetch token info along with real-time token status

 

Request Query/Path Param

ATTRIBUTE DESCRIPTION

mid

mandatory

 Paytm provides MID as a unique identifier to each merchant.For your staging MID, click here. You get the production MID post the account activation.
Example: INTEGR7769XXXXXX9383

tokenIndexNumber

conditional

 Unique Token Reference ID provided by Paytm Token Service Condition: tokenIndexNumber need to passed if request-id is blank

request-id

conditional

 Unique request-id sent during card provision or Order ID of the 2FA transaction. Condition: request Id need to passed if tokenIndexNumber is blank

HTTP Headers

ATTRIBUTE DESCRIPTION

version

mandatory

 Version of the API
Possible Value: V1

requestTimestamp

mandatory

 EPOCH timestamp of the time at which request is being sent
Possible Value: 1588402269

requestId

mandatory

 Merchant’s Unique Request ID for card tokenization
Possible Value: Any

signatureType

mandatory

 Authorization method for this request
Possible Value:CHECKSUM

signature

mandatory

Paytm validates the request and ensures that parameters are not tempered by verifying the signature in the request. Signature will be created using using path param (mid), mandatory HTTP headers(requestTimeStamp, version) and not empty query params (requestId, tokenIndexNumber).

For creating the checksum (signature) refer to the steps given in Form Post Checksum Logic .

Possible Value:Any

Response Attributes

Content Type : JSON

Head

AttributeDescription
Version
string

Version of the API
Possible Value: v1

responseTimestamp
string

EPOCH timestamp of the time at which request is being received

Possible Value: 1588402269

requestId
string

Merchant’s Unique Request ID for card tokenization

Possible Value: Any

Body

AttributeDescription
mid
string

Paytm provides MID as a unique identifier to each merchant.For your staging MID, click here. You get the production MID post the account activation.

Example: INTEGR7769XXXXXX9383

tokenInfo
string

Token Info object contains the card token information.Some fields will not be available if the token status is INIT. 

TokenInfo
+
AttributeDescription
tokenIndexNumber
string

Unique Token Reference ID provided by Paytm Token Service
Possible Value: Any Alphanumeric

cardScheme
string

The network used for card token generated
Possible Values: VISA, MASTER, RUPAY

tokenExpiry
string

Expiry  of the card token
Possible Value: MMYYYY format .ie 092021

issuingBankName
string

Name of the bank issuing the card
Possible Value: Any

cardSuffix
string

Last 4 digits of the actual card
Possible Value: Any

tokenUniqueReference
string

Token reference number provided by the card network for a given tokenization request.
Possible Value: Any

panUniqueReference
string

The unique reference allocated to the Primary Account Number by the card network also known as PAR.
Possible Value: Any

cardType
string

Type of the card
Possible Values: CC or DC

displayName
string

Display name of the card
Example: HDFC Bank Regalia

tokenSuffix
string

Last 4 digits of token

tokenStatus
string

The status of the token. Must be one of the four possible values.
INIT: Tokenization is not yet complete
SUSPENDED: Card Token has been temporarily disabled.
ACTIVE: Card token is active and transactions can be processed with the same.
DEAD: Card Token has been deleted permanently.
FAILED: Card Token failed by system or card network error.

tokenRequestorId
string

The token requestor ID provided by the network or issuer for a given Paytm Merchant using which this token was created/provisioned. This parameter will be provided conditionally for Diners Token.

isRetriable
string

This parameter will be returned true only if the requested Token Index Number will undergo a retry at some point of time before June 30, 2022.

requestId
string

Merchant request-id sent during card provisioning/tokenization

resultInfo
string

Status object

ResultInfo
+
AttributeDescription
resultCode
string

Response code for different failure reason

Possible Values: Any

resultStatus
string

Response status

Possible Values: S/F/U

resultMsg
string

Response message

Possible Values: Any

Response Codes & Messages

resultCoderesultStatusresultMsg
00SUCCESSSUCCESS
100PENDINGPENDING
150PENDINGSYSTEM_ERROR
400FAILEDBAD_REQUEST
401FAILEDFAILURE
405FAILEDInvalid Token Index Number
406FAILEDInvalid request id
407FAILEDIncorrect mid
408FAILEDIncorrect User ID
409FAILEDIncorrect details passed
410FAILEDMandatory fields missing
730FAILEDError from card network
440FAILEDOperation not supported by network
442FAILEDUnable to found TRID
443FAILEDTRID is not in Active state
500FAILEDINTERNAL_SYSTEM_ERROR
502FAILEDSYSTEM_ERROR
1001FAILEDSignature Validation Failure
1002FAILEDCheckSum Validation Failure
1003FAILEDJwt Validation Failure
1004FAILEDMerchant Id is missing
1005FAILEDSignature type is missing
1006FAILEDHead is missing
1400FAILEDSignature Type is invalid
700FAILEDBad Request from card Network
701FAILEDFailure from card network
702FAILEDError from Network
708FAILEDError connecting with card network
709FAILEDError communicating with card network
711FAILEDInvalid card details
712FAILEDCard not eligible
713FAILEDCard not allowed
714FAILEDFurther operations for this card are not allowed
715FAILEDRequested action for the token not allowed or token is invalid
716FAILEDCARD_DECLINED
721FAILEDError with Network
723FAILEDError While connecting to card network
724FAILEDTOKEN_NOT_FOUND
726FAILEDTOKEN_INVALID_STATE
727FAILEDINVALID_AUTHREFNO
728FAILEDTOKEN_SUSPENDED
729FAILEDTOKEN_EXPIRED
750FAILEDREQUIRE_ADDITIONAL_AUTHENTICATION
801PENDINGAwaiting response from the network
⇾
Staging
Production
https://securestage.paytmpayments.com/coft-center/coft/merchant/YOUR_MID/getTokenDetail?requestId=1698842607_001&tokenIndexNumber=654247f1417XXXXccc5161c6copy icon
REQUEST
RESPONSE
CURL
curl -X GET 'https://securestage.paytmpayments.com/coft-center/coft/merchant/YOUR_MID/getTokenDetail?requestId=1698842607_001&tokenIndexNumber=654247f1417XXXXccc5161c6' --header 'version: v1' --header 'requestTimestamp: 1637660536' --header 'requestId: 1637660536' --header 'signatureType: CHECKSUM' --header 'signature: voE4cQzEufqbFPVEvPqIzi88NfS5s8I2ALGuIv3BOidfC09lQhsV9F+WEiR2enemZY84w5fYcXRP4KW9N06eBbwcUL0CwMsN9yshuk7Seog='
copy icon