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 |
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 |
Type of request sent in payload by the merchant. |
CUSTID string |
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 |
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/card
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="}'