Use the session key and a 16-digit token to generate an encrypted PIN block<\/a>. This PIN block contains the new PIN that your cardholder wants to assign to their Adyen-issued card. You must send the PIN block to Adyen in a POST \/pins\/change<\/a> request. Adyen then decrypts the PIN block and registers the new PIN. <\/p>\n The following sequence diagram illustrates the workflow.<\/p>\n As shown in the diagram, the steps for changing a PIN are:<\/p>\n Make sure that:<\/p>\n You need a base64-encoded RSA<\/a> public key to generate an encrypted session key<\/a>. You must use the Configuration API<\/a> to get the public key from Adyen.<\/p>\n To get a public key:<\/p>\n Make a GET \/publicKey<\/a> request with the query parameter purpose<\/a> set to pinChange<\/strong>.<\/p>\n The response contains:<\/p>\n Pass the publicKey<\/a> to your front end.<\/p>\n<\/li>\n<\/ol>\n You need a 256-bit AES<\/a> encryption key to generate an encrypted session key<\/a>. You can generate this key by using a random bit generator.<\/p>\n You need an encrypted symmetric session key to securely request the PIN change<\/a> to Adyen. To generate the encrypted session key, encrypt the AES key you generated<\/a> in the previous step.<\/p>\n For the encryption, use:<\/p>\n You need a token as an intermediate step to generate the encrypted PIN block<\/a>. To get a token, generate a 16-digit random number that does not contain zeros. <\/p>\n Example token: 8374188662676926<\/strong><\/p>\n You must embed the PIN in an encrypted PIN block before sending it to Adyen. Encrypt the PIN block using the ISO format 4 (ISO-4)<\/a> encryption method.<\/p>\n To encrypt a PIN block using the ISO format 4 method:<\/p>\n The hexadecimal string is the encrypted PIN block that you must send to Adyen when you request the PIN change<\/a>.<\/p>\n To request a PIN change, make a POST \/pins\/change<\/a> call and specify the following request parameters:<\/p>\n The following code sample shows how to request a PIN change.<\/p>\n![\"\"](\"\/user\/pages\/docs\/07.issuing\/17.manage-card-data\/08.change-pin\/pin-change.svg?decoding=auto&fetchpriority=auto\")
<\/p>\n\n
Requirements<\/h2>\n
\n
Get a public key from Adyen<\/h2>\n
\n
\n
Generate an AES key<\/h2>\n
Generate an encrypted session key<\/h2>\n
\n
Generate an encryption token<\/h2>\n
Generate an encrypted PIN block<\/h2>\n
\n
\n
\nExample: 4<\/strong> + 8374188662676926<\/strong> + 000000000000000<\/strong><\/li>\n<\/ol><\/li>\n\n
\nExample: 44<\/strong> + 5454<\/strong> + AAAAAAAAAA<\/strong><\/span> + 70cd3917e96891f8<\/strong><\/span><\/li>\n<\/ol><\/li>\nRequest a PIN change to Adyen<\/h2>\n
\n\n
\n \nParameter<\/th>\n Description<\/th>\n<\/tr>\n<\/thead>\n \n paymentInstrumentId<\/a><\/td>\n The unique identifier of the card for which you are changing the PIN.<\/td>\n<\/tr>\n \n encryptedKey<\/a><\/td>\n The symmetric session AES key.<\/td>\n<\/tr>\n \n token<\/a><\/td>\n The token that you used to generate the encrypted PIN block.<\/td>\n<\/tr>\n \n encryptedPinBlock<\/a><\/td>\n The encrypted PIN block<\/a>.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
![\"\"](\"https:\/\/docs.adyen.com\/user\/pages\/docs\/07.issuing\/17.manage-card-data\/08.change-pin\/pin-change.svg?decoding=auto&fetchpriority=auto\")
","request-pin-change.js":"