PartnerCard ChangePin v2

Barion API: Change the PIN of a partner card

POST	/v2/PartnerCard/ChangePin

Use cases

This endpoint can change the PIN code of a partner card.

v2 This API endpoint is available in API v2 only.

Input properties

Property name	Property type	Limitations and constraints	Description
PartnerKey	Guid	Required	The secret API key of the partner, generated by Barion.
PrivateCardKey	string	Required	The private key that was received in the reponse of PaymentCard/Prepare
CurrentPin	string	Required Min 4 Max 8 length alphanumeric string	The PIN code associated with the card
NewPin	string	Required Min 4 Max 8 length alphanumeric string	The new PIN code that should be associated from now on.

Output properties

Property name	Property type	Description
PrivateCardKey	string	The private key of the card.
PinChangeWasSuccessful	bool	True, if the process was successful.

Possible error responses

Error code	Description
InvalidCardKey	The card key provided either doesn't belong to a card or the card is already issued.
NewPinEqualsToCurrent	The new PIN code equals to current one.
InvalidCardPin	The current PIN is incorrect, did not match the stored version.
PinChangeFailed	A fatal system error occured during the process.