Get current version of Card Product Definition
This method retrieves the current active version of the Card Product Definition, including a complete set of settings and restrictions. The ability to access the current CPD version serves as a control measure, providing clarity on the active version and ensuring the proper use of correct CPD.
URL test:
Method:
GET
Path items:
/cpds (Card Product Definition Service)
/{code} (ID code of required CPD)
Parameters:
| Parameter | Location | Type | Example | Description | Required |
|---|---|---|---|---|---|
| code | path | string | VISA_VIRT_2 | CPD code | Yes |
Example:
Responses:
200 - OK
Status Code: 200 OK
{
"id": 2,
"code": "VISA_PHYS_1",
"name": "VISA Physical Retail",
"description": "VISA Physical Retail",
"images": [
"phys_standard.png"
],
"validFrom": "2023-05-29T00:00:00Z",
"validTo": "2999-12-31T23:59:59Z",
"associationCode": "VISA",
"technology": [
"CONTACTLESS_CHIP",
"CONTACT_CHIP",
"MAGSTRIPE"
],
"cardType": "DEBIT",
"segment": [
"RETAIL"
],
"status": "ACTIVE",
"defaultValidity": 48,
"pan": {
"length": 16,
"prefix": "451161",
"lowerRange": "010000000",
"upperRange": "019999999"
},
"renewalAuto": true,
"embossNameMaxLength": 21,
"embossNameCreateMode": "LAST_FIRST",
"defaultCardStatus": "DIGITALLY_ACTIVE",
"cardActivation": "AUTOMATIC",
"defaultEcommerceStatus": true,
"limits": [
{
"limitId": "LIM_POS_AMT_D",
"name": "POS transactions",
"issuerBillingCurrency": "CZK",
"period": "DAILY",
"transactionTypes": "CSD,CSR,RTL,RTR,CBN,CBR,CNP,CNR,GAM,GAR,PRE,PRR,MTP,MTR",
"limitType": "AMOUNT",
"defaultLimitValue": 50000,
"maximumLimitValue": 100000,
"customerCanModify": true,
"customerCanView": true
},
{
"limitId": "LIM_ECOM_AMT_D",
"name": "E-commerce transactions",
"issuerBillingCurrency": "CZK",
"period": "DAILY",
"transactionTypes": "ECP,ECR,EGM,EGR,EPA,EPR",
"limitType": "AMOUNT",
"defaultLimitValue": 20000,
"maximumLimitValue": 100000,
"customerCanModify": true,
"customerCanView": true
},
{
"limitId": "LIM_ATM_AMT_D",
"name": "ATM withdrawals",
"issuerBillingCurrency": "CZK",
"period": "DAILY",
"transactionTypes": "ATM,ATR",
"limitType": "AMOUNT",
"defaultLimitValue": 50000,
"maximumLimitValue": 100000,
"customerCanModify": true,
"customerCanView": true
}
],
"handoverType": [
"POST",
"BRANCH"
],
"pinChange": true,
"pinView": true,
"embossNameGenerate": true,
"renewalMonthUpfront": 2,
"renewalType": "RENEWAL",
"deliveryTracking": true,
"persolineCompany": "GPE",
"processorCompany": "GPE",
"graphics": "41",
"restrictions": [
{
"restrictionId": "DenyCash",
"defaultRestrictionValue": "DISABLED",
"customerCanModify": true,
"customerCanView": true,
"setting": "ATM,ATR,CSD,CSR",
"evaluation": "BLACKLIST",
"name": "Cash transactions",
"restrictionType": "TRANSACTION_TYPE"
},
{
"restrictionId": "DenyCLESS",
"defaultRestrictionValue": "DISABLED",
"customerCanModify": true,
"customerCanView": true,
"setting": "CONTACTLESS",
"evaluation": "FLAG",
"name": "Contactless transactions",
"restrictionType": "TRANSACTION_FLAG"
},
{
"restrictionId": "DenyOnline",
"defaultRestrictionValue": "DISABLED",
"customerCanModify": true,
"customerCanView": true,
"setting": "ONLINE",
"evaluation": "FLAG",
"name": "Online transactions",
"restrictionType": "TRANSACTION_FLAG"
},
{
"restrictionId": "DenyMagstripe",
"defaultRestrictionValue": "DISABLED",
"customerCanModify": true,
"customerCanView": true,
"setting": "MAG_STRIPE",
"evaluation": "FLAG",
"name": "Magstripe transactions",
"restrictionType": "TRANSACTION_FLAG"
},
{
"restrictionId": "DenyChipAndPIN",
"defaultRestrictionValue": "DISABLED",
"customerCanModify": false,
"customerCanView": true,
"setting": "CHIP_AND_PIN",
"evaluation": "FLAG",
"name": "Chip&PIN transactions",
"restrictionType": "TRANSACTION_FLAG"
},
{
"restrictionId": "DenyMobileWallets",
"defaultRestrictionValue": "DISABLED",
"customerCanModify": true,
"customerCanView": true,
"setting": "MOBILE_WALLET",
"evaluation": "FLAG",
"name": "Mobile wallets transactions",
"restrictionType": "TRANSACTION_FLAG"
},
{
"restrictionId": "DenyRestrictedMCC",
"defaultRestrictionValue": "ENABLED",
"customerCanModify": false,
"customerCanView": false,
"setting": "7995,7801,7800,7802,5967",
"evaluation": "BLACKLIST",
"name": "Restricted content transactions",
"restrictionType": "MCC"
},
{
"restrictionId": "AllowOnlyPOS_ECOM",
"defaultRestrictionValue": "ENABLED",
"customerCanModify": false,
"customerCanView": false,
"setting": "ATM,ATR,CSD,CSR,RTL,RTR,CBN,CBR,RET,RER,CNP,CNR,CRP,CRR,ECP,ECR,EME,EMR,GAM,GAR,EGM,EGR,CAV,PIN,INQ,PRE,PRR,EPA,EPR,MTP,MTR",
"evaluation": "WHITELIST",
"name": "In-store and online (internet) transactions only",
"restrictionType": "TRANSACTION_TYPE"
},
{
"restrictionId": "AllowOnlyEU",
"defaultRestrictionValue": "DISABLED",
"customerCanModify": false,
"customerCanView": false,
"setting": "ALB,AND,AUT,BLR,BEL,BIH,BGR,HRV,CYP,CZE,DNK,EST,FIN,FRA,DEU,GRC,HUN,ISL,IRL,ITA,LVA,LIE,LTU,LUX,MLT,MDA,MCO,MNE,NLD,MKD,NOR,POL,PRT,ROU,SMR,SRB,SVK,SVN,ESP,SWE,CHE,UKR,GBR,VAT",
"evaluation": "WHITELIST",
"name": "European Union transactions only",
"restrictionType": "COUNTRYCODES"
}
]
}
| Parameter | Location | Type | Example | Description |
|---|---|---|---|---|
| id | body | "integer" | "3" | CPD ID |
| cpdCode | card | "string" | "94CHBIA4FX31CUPWFMNSHONI" | CPD code |
| name | card | "string" | "VISA Physical Retail" | CPD name |
| description | body | "string" | "VISA physical card with contact and contactless chip..." | Description of CPD |
| image | card | "array" | "phys_standard.png" | List of file names (including suffixes) for UI |
| validFrom | card | "string" | "2024-04-01" | |
| validTo | card | "string" | "2028-04-01" | |
| associationCode | card | "string" | "VISA" | |
| technology | body | "array" | "CONTACTLESS_CHIP","CONTACT_CHIP","MAGSTRIPE" | Card technology with which the Card will be created |
| cardType | card | "string" | "DEBIT" | |
| segment | card | "string" | "Retail" | |
| status | card | "string" | "ACTIVE" | |
| defaultValidity | body | "integer" | 48 | Default Card validity in months |
| pan | body | "object" | - | PAN ranges and prefix |
| length | pan | "integer" | 16 | Number of digits of PAN |
| prefix | pan | "string" | "484569" | Prefix of PAN |
| lowerRange | pan | "string" | "010000000" | Lower range of PAN |
| upperRange | pan | "string" | "019999999" | Upper range of PAN |
| renewalAuto | body | "boolean" | true | If Card will be automatically renewed |
| embossNameMaxLength | body | "integer" | 21 | |
| embossNameCreateMode | body | "string" | "LAST_FIRST" | Embossed name format |
| defaultCardStatus | body | "string" | "DIGITALLY_ACTIVE" | |
| cardActivation | body | "string" | "AUTOMATIC" | |
| defaultEcommerceStatus | body | "boolean" | true | |
| limits | body | "object" | - | Limits details |
| limitId | limits | "string" | LIM_POS_D | Limit ID specified in CPD |
| name | limits | "string" | "POS DAILY LIMIT" | Limit name |
| issuerBillingCurrency | limits | "string" | "CZK" | Limit currency |
| period | limits | "string" | "DAILY" | Limit period |
| transactionTypes | limits | "string" | "CSD,CSR..." | Transaction types for which limit is created |
| limitType | limits | "string" | "AMOUNT" | AMOUNT/COUNT Limit type |
| defaultlimitValue | limits | "integer" | "50000" | |
| maximumLimitValue | limits | "integer" | "50000" | |
| customerCanModify | limits | "boolean" | true | If Cardholder can modify the limit values |
| handoverType | body | "array" | "POST","INSTANT","BRANCH" | Allowed delivery types |
| pinChange | body | "boolean" | true | If Card is allowed to have PIN changed |
| pinView | body | "boolean" | true | If Card is allowed to have PIN viewed |
| embossNameGenerate | body | "boolean" | true | If card has embossed name |
| renewalMonthUpfront | body | "integer" | 2 | Number of months when the card is prepared for renewal |
| renewalType | body | "string" | "RENEWAL" | |
| deliveryTracking | body | "boolean" | true | If delivery of card is tracked |
| persolineCompany | body | "string" | "CARDPROCESSOR" | Code of the company providing processing and distribution of card |
| processorCompany | body | "string" | "CARDPROCESSOR" | Code of the card processor company code |
| graphics | body | "string" | "41" | Number of preset graphics design of Card |
| restrictions | body | "object" | - | Resctions details |
| restrictionId | restrictions | "string" | "DENYCASH" | Restriction ID specified in CPD |
| defaultRestrictionValue | restrictions | "string" | "ENABLED" | ENABLED/DISABLED value for turning ON or OFF the restriction |
| customerCanModify | restrictions | "boolean" | true | If Cardholder can modify the restriction i.e. turn ON or OFF the restriction |
| customerCanView | restrictions | "boolean" | true | If Cardholder can view the restriction |
| setting | restrictions | "string" | "ATM,ATR,CSD,CSR", | |
| evaluation | restrictions | "string" | "FLAG" | Restriction logic model |
| name | restrictions | "string" | "CASH TRANSACTIONS" | Restriction name |
| restrictionType | restrictions | "string" | "TRANSACTION_FLAG" | Restriction type |