# Change-Card-Pin

## Change Card PIN

The Change Card PIN API allows to change the card PIN.

## Input Parameters:

| Name        | Required | Definition                                                                                       | Comments |
| ----------- | -------- | ------------------------------------------------------------------------------------------------ | -------- |
| CardNumber  | Y        | Format: Numeric, 16                                                                              |          |
| CurrentPIN  | Y        | <p>Format: Numeric, 4<br>Description: A private code</p>                                         |          |
| DateOfBirth | N        | <p>Format: yyyy-mm-dd<br>Description: Cardholder must be above 17 years old</p>                  |          |
| NewPin      | Y        | <p>Format: Numeric, 4<br>Description: New PIN value of private code, represented as 4 digits</p> |          |

## Output Parameters:

No Output Parameters

## XML Samples

### Input XML

```json
<?xml version="1.0"?>
<PraxellXMLRequest>
  <AuthenticationDetails>
    <AuthCardNumber></AuthCardNumber>
    <AuthPIN>4321</AuthPIN>
    <ClientSourceIP></ClientSourceIP> 
 </AuthenticationDetails>;
  <ServiceDetails>
    <UniqueRequestId>2584564</UniqueRequestId>
    <ServiceName>ChangeCardPIN</ServiceName>
  </ServiceDetails>
  <Origin>
    <OriginType>ExtAPI</OriginType>
  </Origin>
  <ServiceParams>
    <CardNumber>1234567890123456</CardNumber>
    <CurrentPIN>1234</CurrentPIN>
    <DateOfBirth></DateOfBirth>
    <NewPIN>6045</NewPIN>
  </ServiceParams>
</PraxellXMLRequest>
```

```json
<?xml version="1.0"?>
<PraxellXMLResponse>
  <ResponseDetails>
    <ServiceName>ChangeCardPIN</ServiceName>
    <SessionId>07071612200737105</SessionId>
    <StatusCode>0</StatusCode>
    <StatusName>StatusOK</StatusName>
    <StatusDescription>NA</StatusDescription>
    <ServiceDate>2007-10-01 12:37:50</ServiceDate>
    <ServiceId>07071612200737105</ServiceId>
  </ResponseDetails>
  <ResponseParams>
  </ResponseParams>
</PraxellXMLResponse>
```

```json
<?xml version="1.0"?>
<PraxellXMLResponse>
  <ResponseDetails>
    <ServiceName>ChangeCardPIN</ServiceName>
    <SessionId>07071612200737105</SessionId>
    <StatusCode>70284</StatusCode>
    <StatusName>New PIN Identical to current PIN</StatusName>
    <StatusDescription>New PIN Identical to current PIN</StatusDescription>
    <ServiceDate>2021-10-01 12:37:50</ServiceDate>
    <ServiceId>07071612200737105</ServiceId>
  </ResponseDetails>
  <ResponseParams>
  </ResponseParams>
</PraxellXMLResponse>
```