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 |
|
The secret API key of the partner, generated by Barion.
|
| PrivateCardKey |
string |
|
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.
|