search

POSTSaved Card API

Use Case

This API is used to access the cards saved (local or global vault cards) in your customer’s Paytm account based on the SSO token.

Request Attributes

API Content Type: JSON

ATTRIBUTE DESCRIPTION

MID

string
mandatory

Unique identifier provided to every merchant by Paytm. MID is part of your account credentials and is different on staging and production environment. Your staging MID is available here & production MID will be available once your activation is complete.

REQUEST_TYPE

string
mandatory

Type of request sent in payload by the merchant. 

CUSTID

string
mandatory

Unique Id issued to the customer by Paytm for which the merchant has requested the saved cards details.
SSO_TOKEN
optional
Unique token linked with the user's Paytm account and is provided in the response while linking user's Paytm wallet.

CHECKSUM

string
mandatory

Signature encryption for validation. It's value to be sent should be the checksum string created by using Paytm checksum library.
Note: Create the signature using all the request parameters.

Response Attributes

API Content Type: JSON

ATTRIBUTE DESCRIPTION

savedCardId

string

Unique identifier for the original saved card.

cardFirstSixDigits

string

First six digits of the saved card

cardLastFourDigits

string

Last four digits of the saved card

cardType

string

Type of the card
Possible Values: CC or DC

issuerDisplayName

string

Name of the bank issuing the card

issuerCode

string(20)

Code of the bank issuing the card

cardScheme

string

The central payment method used by the saved card to process payment
Possible Values: VISA, MASTER, MAESTRO

expiryDate

string

Expiry date of card

displayName

string

Name of the card

Example: HDFC Bank Credit Card)

Response Codes and Messages

Response Code Response Status Response Msg
0000 SUCCESS Card does not exist for given parameters
0000 SUCCESS success
0002 FAILURE Invalid data entered by user
0002 FAILURE Unable to fetch details from Mapping Service via client
0002 FAILURE Unable to fetch data from Platform+
0002 FAILURE Error in fetching data from database
Staging
Production
https://securegw-stage.paytm.in/savedcardservice/merchant/v1/get/cardcopy icon
REQUEST
RESPONSE
CURL
JAVA
NODE
PHP
PYTHON
DOTNET
curl -X POST -H 'Content-Type: application/json' https://securegw-stage.paytm.in/savedcardservice/merchant/v1/get/card -d \
'{"MID":"{mid}","REQUEST_TYPE":"DEFAULT","CUSTID":"CUST_001","SSO_TOKEN":"eyJlbmMiOiJBMjU2R0NNIiwiYWxnIjoiZGlyIn0..1oKV-U5KDx_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXfrWEuWk_5Rb2HLTO9DHAiYGiId7d85x6CG8LzrDBhg9_84A5DG65t24kAbnzRnodMz83IX-BoPjmD4LGHr4gUrY272uCa4_IejVuXFwUoiNt21E-i2SlB97vd3NyJCy2psR-OFlrd4FHMy_GjGDco7tES2BJ1Aua21A.YwvKAdb7dYEYds9-8HNEuw3300","CHECKSUM":"AGmkaW8uDXKYBrDcKSRaVH5eZ5lMMIbe6P0OPfAe9cO4cpK9lV+Vl1tCQR9YzUDkoZZN2OSzSYZDRzaI0TOJcWqa6Y6NA3vJgCUHOPJkdQQ="}'
copy icon