search
Your Paytm for business app is working and will keep working beyond March 15th, 2024. Click to know more

POSTFetch Saved Cards

Use Case

Used by merchant to fetch both saved and token cards mapped to Unique customer identifier and MID combination

Request Attributes

Content Type : JSON

Head

AttributeDescription
tokenType
string
mandatory

Authorization method for this request.

Possible values: CHECKSUM

token
string
mandatory

Authorization string corresponding to the CHECKSUM

Example: 8FPPqG5VXXXNVFTEJFBy+kGy8gSrfKjEQnsS2ySxF2ixXXXXx7sK9okoN+e7/NgSv2+Bq0djRN1y5uubI4Em8H+1EwOgZ6+jHAwhDqaMxSA=

Body

AttributeDescription
mid
string
mandatory

Paytm provides MID as a unique identifier to each merchant.

Example: INTEGR7769XXXXXX9383

custId
string
mandatory

Unique customer identifier of the merchant’s customer.

filterTokenCards
boolean
optional

To filter out tokenised cards and return only saved cards

Response Attributes

Content Type : JSON

Body

AttributeDescription
savedCardId
string(45)

Unique for every card binding to user

cardType
string

Type of the card
Possible Values: CC or DC

cardScheme
string

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

expiryDate
string

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

cardSuffix
string

Last 4 digits of the card or card token

panUniqueReference
string

Token reference number provided by card network.
Possible Value: Any

issuerCode
string

Code of the bank issuing the card

issuingBankName
string

Name of the bank issuing the card
Possible Value: Any

displayName
string

Display name of the card
Example: HDFC Bank Regalia

cardFirstSixDigits
string

Bank Identifier Number of Card

isEligibleForCoft
string

Status whether bin is eligible for card on file tokenization or not.

Possible Values: true, false

isCardCoft
string

This flag indication whether card is already tokenized or not

tokenBin
string

Bank Identifier Number 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.

⇾
Staging
Production
https://securegw-stage.paytm.in/savedcardservice/merchant/coft/cardscopy icon
REQUEST
RESPONSE
CURL
PHP
DOTNET
NODE
PYTHON
curl -X POST 'https://securegw-stage.paytm.in/savedcardservice/merchant/coft/cards' \
--header 'Content-Type: application/json' \
--data '{"head":{"tokenType":"CHECKSUM","token":"8FPPqG5VXXXNVFTEJFBy+kGy8gSrfKjEQnsS2ySxF2ixXXXXx7sK9okoN+e7/NgSv2+Bq0djRN1yXXubI4Em8H+1EwOgZ6+jHXXXDqaMxSA="},"body":{"mid":"{mid}","custId":"{custId}"}}'
copy icon