PartnerCard ChangePin v2

From Barion Documentation
Jump to navigation Jump to search

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.