PIN and card security
Set and change a PIN, manage the try counter, and generate or verify the card verification values.
Service that generates a card PIN
Sets or updates the PIN for a specific debit card. Accepts card reference number, channel, and new PIN details, and applies the changes to the card securely.
Service that generates a card PIN › Request Body
channelChannel - [Optional]
shadowCardNumberShadow Card Number - [Optional]
clearPinClear Pin - [Optional]
Service that generates a card PIN › Responses
Success
successSuccess - [Optional]
encryptedPinEncrypted Pin - [Optional]
Service that enables changing the card’s PIN
Changes the PIN of a debit card using the current PIN and returns the status including encrypted PIN, success, and verification flags.
Service that enables changing the card’s PIN › Request Body
channelChannel - [Optional]
shadowCardNumberShadow Card Number - [Optional]
currentCardPinCurrent Card Pin - [Optional]
newCardPinNew Card Pin - [Optional]
Service that enables changing the card’s PIN › Responses
Success
successSuccess - [Optional]
verifiedVerified - [Optional]
changedChanged - [Optional]
encryptedPinEncrypted Pin - [Optional]
Service that validates the accuracy of the card PIN
Verifies the PIN of a card. Used to confirm cardholder authorization in debit channels.
Service that validates the accuracy of the card PIN › Request Body
channelChannel - [Optional]
shadowCardNumberShadow Card Number - [Optional]
clearCardNumberClear Card Number - [Optional]
clearPinClear Pin - [Optional]
Service that validates the accuracy of the card PIN › Responses
Success
verifiedVerified - [Optional]
lastTryCountLast Try Count - [Optional]
tryCountExceedTry Count Exceed - [Optional]
Service that validates the card PIN using an encrypted PIN block
Verifies the RSA PIN for a card. Ensures secure cardholder authorization using RSA PIN.
Service that validates the card PIN using an encrypted PIN block › Request Body
operationDateOperation Date - [Optional]
channelChannel - [Optional]
shadowCardNumberShadow Card Number - [Optional]
ePBE P B - [Optional]
Service that validates the card PIN using an encrypted PIN block › Responses
Success
verifiedVerified - [Optional]
lastTryCountLast Try Count - [Optional]
tryCountExceedTry Count Exceed - [Optional]
responseCodeResponse Code - [Optional]
responseDescriptionResponse Description - [Optional]
Service that generates the card PIN using an encrypted PIN block
Sets the RSA PIN for a card. Used for secure PIN management in debit channels.
Service that generates the card PIN using an encrypted PIN block › Request Body
operationDateOperation Date - [Optional]
channelChannel - [Optional]
shadowCardNumberShadow Card Number - [Optional]
ePBE P B - [Optional]
Service that generates the card PIN using an encrypted PIN block › Responses
Success
successSuccess - [Optional]
encryptedPinEncrypted Pin - [Optional]
responseCodeResponse Code - [Optional]
responseDescriptionResponse Description - [Optional]
Service that changes the card’s PIN using an encrypted PIN block
Changes the RSA PIN of a debit card using current and new encrypted PIN blocks. Returns encrypted PIN, success status, and response details.
Service that changes the card’s PIN using an encrypted PIN block › Request Body
operationDateOfCurrentOperation Date Of Current - [Optional]
operationDateOfNewOperation Date Of New - [Optional]
channelChannel - [Optional]
shadowCardNumberShadow Card Number - [Optional]
currentEPBCurrent E P B - [Optional]
newEPBNew E P B - [Optional]
Service that changes the card’s PIN using an encrypted PIN block › Responses
Success
successSuccess - [Optional]
encryptedPinEncrypted Pin - [Optional]
responseCodeResponse Code - [Optional]
responseDescriptionResponse Description - [Optional]
Service that increases the PIN retry counter
Increases the PIN try count for a given debit card. Accepts a ShadowCardNumber, Channel, and IncreaseCount to increment the attempt counter via the debit PIN service proxy.
Service that increases the PIN retry counter › Request Body
increaseCountIncrease Count - [Optional]
channelChannel - [Optional]
shadowCardNumberShadow Card Number - [Optional]
Service that increases the PIN retry counter › Responses
Success
Service that validates the card PIN using an encrypted PIN block
Verifies the RSA PIN with a static salt. Provides additional security for cardholder authentication using salted RSA PIN.
Service that validates the card PIN using an encrypted PIN block › Request Body
operationDateOperation Date - [Optional]
channelChannel - [Optional]
shadowCardNumberShadow Card Number - [Optional]
ePBE P B - [Optional]
staticSaltStatic Salt - [Optional]
Service that validates the card PIN using an encrypted PIN block › Responses
Success
verifiedVerified - [Optional]
lastTryCountLast Try Count - [Optional]
tryCountExceedTry Count Exceed - [Optional]
responseCodeResponse Code - [Optional]
responseDescriptionResponse Description - [Optional]
CVV validation service
Verifies the CVV of a card. Used for cardholder validation during transactions.
CVV validation service › Request Body
channelChannel - [Optional]
shadowCardNumberShadow Card Number - [Optional]
verificationValueVerification Value - [Optional]
CVV validation service › Responses
Success
verifiedVerified - [Optional]
lastTryCountLast Try Count - [Optional]
tryCountExceedTry Count Exceed - [Optional]
CVV validation service
Partially verifies the CVV of a card. Used when partial CVV verification is required for transaction purposes.
CVV validation service › Request Body
channelChannel - [Optional]
shadowCardNumberShadow Card Number - [Optional]
digitsDigits - [Optional]
CVV validation service › Responses
Success
verifiedVerified - [Optional]
lastTryCountLast Try Count - [Optional]
tryCountExceedTry Count Exceed - [Optional]
CVV generation service
Generates the CVV (Card Verification Value) for a given shadow card. Returns the verification value along with any error information. Uses the underlying debit PIN service.
CVV generation service › Request Body
channelChannel - [Optional]
shadowCardNumberShadow Card Number - [Optional]
CVV generation service › Responses
Success
hasErrorHas Error - [Optional]
errorTextError Text - [Optional]
verificationValueVerification Value - [Optional]
Service that lists the card PIN transaction history
Retrieves the PIN operation history for a debit card based on ShadowCardNumber. Returns a list of GetCardPinOperationHistory items including ChannelType, InsertDate, OperationResult, OperationResultDescription, OperationType, and OperationTypeDescription. Uses _dcidRepository.GetCardPinOperationHistory to fetch the data.
Service that lists the card PIN transaction history › Request Body
shadowCardNumberShadow Card Number - [Optional]
Service that lists the card PIN transaction history › Responses
Success
Get Card Pin Operation History List - [Optional]
Service that resets the CVV retry counter on a card
Resets the CVV attempt counter for a given shadow card. Accepts the channel and shadow card number as input. Used to allow further CVV attempts after limits are reached.
Service that resets the CVV retry counter on a card › Request Body
channelChannel - [Optional]
shadowCardNumberShadow Card Number - [Optional]
Service that resets the CVV retry counter on a card › Responses
Success