---
title: "Reverse PIN Change [EXPERIMENTAL]"
method: POST
path: "/cardManagement/actions/{actionKey}/reverse"
tags: ["Card Management"]
---

# Reverse PIN Change \[EXPERIMENTAL\]

`POST /cardManagement/actions/{actionKey}/reverse`

## Request

- Base URL: `https://eu-west-1.api.silverflow.com/v1`
- URL: `https://eu-west-1.api.silverflow.com/v1/cardManagement/actions/{actionKey}/reverse`
- Auth: one of:
  - HTTP basic
  - HTTP bearer
- TypeScript: <https://skmtc.dev/silverflow/apis/silverflow-api/docs/cardManagement/actions/:actionKey/reverse/post.ts> (a function with typed inputs; its response is checked against the schema)

Reverse a previously approved PIN change. The reversal can itself be declined.

Permissions: `cardManagement:Create`, `cardManagement:All`

## Path parameters

- `actionKey` string, required: Uniquely identifies a card-management action.

## Response `201`

Created

- ReversePinChangeResponse
  - `key` string, required: Uniquely identifies a card-management action.
  - `reversedActionKey` string, required: Uniquely identifies a card-management action.
  - `type` 'pin_change_reversal', required
  - `result` 'approved' | 'declined', required: The result of the authorization.
  - `authorizationIsoFields` AuthorizationIsoFields, required: The values from the ISO8583 response message received from the network.
    - `responseCode` string, required: Contents of field 39
    - `responseCodeDescription` string, required: The description of the `responseCode`
    - `authorizationCode` string: Contents of field 38
    - `networkCode` string, required: Contents of field 63, subfield 1
    - `systemTraceAuditNumber` string, required: Contents of field 11
    - `retrievalReferenceNumber` string, required: Contents of field 37
    - `networkSpecificFields` union, required
      - VisaNetworkFields: Visa specific ISO8583 raw values
        - `network` 'visa', required: Card network
        - `transactionIdentifier` string, required: Contents of field 62, subfield 2
      - MastercardNetworkFields: Mastercard specific ISO8583 raw values
        - `network` 'mastercard', required: Card network
        - `banknetReference` string, required: Contents of field 63, subfield 2
        - `traceId` string, required: The trace ID can be used to refer to the original authorization when reversing it. The value is constructed from the contents of field 63, subfield 1, field 63, subfield 2, and field 15. The value intentionally ends with two spaces.
  - `created` string, iso-8601-date-time, required: The date and time this object was created
  - `version` integer, required: The version of this object

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/silverflow/apis/silverflow-api.md) - [All operations](https://skmtc.dev/silverflow/apis/silverflow-api/llms.txt) - [OpenAPI document](https://skmtc.dev/silverflow/apis/silverflow-api/revisions/43ecbe4fd6ea?raw)