--- title: "Get Card Management Action [EXPERIMENTAL]" method: GET path: "/cardManagement/actions/{actionKey}" tags: ["Card Management"] --- # Get Card Management Action \[EXPERIMENTAL\] `GET /cardManagement/actions/{actionKey}` ## Request - Base URL: `https://eu-west-1.api.silverflow.com/v1` - URL: `https://eu-west-1.api.silverflow.com/v1/cardManagement/actions/{actionKey}` - Auth: one of: - HTTP basic - HTTP bearer - TypeScript: (a function with typed inputs; its response is checked against the schema) Retrieve a single action by its key. Permissions: `cardManagement:Get`, `cardManagement:All` ## Path parameters - `actionKey` string, required: Uniquely identifies a card-management action. ## Response `200` OK - union - GetPinChangeResponse - `key` string, required: Uniquely identifies a card-management action. - `type` 'pin_change', required - `result` 'approved' | 'declined' | 'reversed', required - `card` MaskedCard, required: Card data for ATM transactions. ATM transactions do not support processor tokenization. - `maskedNumber` string, required: The card number used to create this action, masked according to PCI standards. For card numbers with 16 or more digits, the first 8 and the last 4 digits are visible. For card numbers with 13-15 digits, the first 6 and the last 4 digits are visible. For cards numbers with less than 13 digits, the first 6 and last 2 digits are visible. - `merchantAcceptorRef` MerchantAcceptorRef, required - `key` string, required: Uniquely identifies a merchant acceptor. - `version` integer, required: The version of this object - `terminalEntryMode` 'chip' | 'contactless' | 'magstripe' | 'magstripe_fallback' | 'contactless_magstripe', required: The method used for PAN entry on the ATM terminal. When set to `chip` or `contactless`, `emvData` is required. - `terminal` SchemasTerminal, required: Details about the ATM terminal. - `id` string, required: ATM terminal's ID - `capabilities` SchemasTerminalCapability[], required: The capabilities of the ATM terminal. This can be one or multiple. - `transactionReference` string: Unique ID assigned by the merchant or payment service provider for the transaction. Used to identify the transaction. - `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. - `localTransactionDateTime` string, iso-8601-date-time: Date and time of the transaction in the local timezone. - `created` string, iso-8601-date-time, required: The date and time this object was created - `lastModified` string, iso-8601-date-time: The date and time this object was last modified - `version` integer, required: The version of this object - GetPinUnblockResponse - `key` string, required: Uniquely identifies a card-management action. - `type` 'pin_unblock', required - `result` 'approved' | 'declined', required: The result of the authorization. - `card` MaskedCard, required: Card data for ATM transactions. ATM transactions do not support processor tokenization. - `maskedNumber` string, required: The card number used to create this action, masked according to PCI standards. For card numbers with 16 or more digits, the first 8 and the last 4 digits are visible. For card numbers with 13-15 digits, the first 6 and the last 4 digits are visible. For cards numbers with less than 13 digits, the first 6 and last 2 digits are visible. - `merchantAcceptorRef` MerchantAcceptorRef, required - `key` string, required: Uniquely identifies a merchant acceptor. - `version` integer, required: The version of this object - `terminalEntryMode` 'chip' | 'contactless' | 'magstripe' | 'magstripe_fallback' | 'contactless_magstripe', required: The method used for PAN entry on the ATM terminal. When set to `chip` or `contactless`, `emvData` is required. - `terminal` SchemasTerminal, required: Details about the ATM terminal. - `id` string, required: ATM terminal's ID - `capabilities` SchemasTerminalCapability[], required: The capabilities of the ATM terminal. This can be one or multiple. - `transactionReference` string: Unique ID assigned by the merchant or payment service provider for the transaction. Used to identify the transaction. - `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. - `localTransactionDateTime` string, iso-8601-date-time: Date and time of the transaction in the local timezone. - `created` string, iso-8601-date-time, required: The date and time this object was created - `version` integer, required: The version of this object - GetBalanceInquiryResponse - `key` string, required: Uniquely identifies a card-management action. - `type` 'balance_inquiry', required - `result` 'approved' | 'declined', required: The result of the authorization. - `card` MaskedCard, required: Card data for ATM transactions. ATM transactions do not support processor tokenization. - `maskedNumber` string, required: The card number used to create this action, masked according to PCI standards. For card numbers with 16 or more digits, the first 8 and the last 4 digits are visible. For card numbers with 13-15 digits, the first 6 and the last 4 digits are visible. For cards numbers with less than 13 digits, the first 6 and last 2 digits are visible. - `merchantAcceptorRef` MerchantAcceptorRef, required - `key` string, required: Uniquely identifies a merchant acceptor. - `version` integer, required: The version of this object - `terminalEntryMode` 'chip' | 'contactless' | 'magstripe' | 'magstripe_fallback' | 'contactless_magstripe', required: The method used for PAN entry on the ATM terminal. When set to `chip` or `contactless`, `emvData` is required. - `terminal` SchemasTerminal, required: Details about the ATM terminal. - `id` string, required: ATM terminal's ID - `capabilities` SchemasTerminalCapability[], required: The capabilities of the ATM terminal. This can be one or multiple. - `transactionReference` string: Unique ID assigned by the merchant or payment service provider for the transaction. Used to identify the transaction. - `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. - `localTransactionDateTime` string, iso-8601-date-time: Date and time of the transaction in the local timezone. - `created` string, iso-8601-date-time, required: The date and time this object was created - `version` integer, required: The version of this object - 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 - `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)