> For the complete documentation index, see [llms.txt](https://docs.verifone.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verifone.com/psdk-latest/psdk-downloads-and-class-intro/release-notes/3.68.md). # 3.68 ## PSDK\_3.68.27 | Type | Description | | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Feature | Added `TransactionQuery::setTransactionIds()` / `getTransactionIds()` for querying transaction history by gateway transaction UUIDs. Accepts a list of UUIDs and returns only matching transactions, enabling follow-on operations (e.g. linked refunds) from a different terminal than the original sale. Mutually exclusive with `setPayments()`; empty strings are ignored. Nexo only — has no effect on SCA. | | Bugfix | (Nexo) Preserve `Payment::getPreviousBalance()` on stored-value reversal responses when payment instrument data is also present in the response. Follow-up to the 3.68.26 fix that addressed a regression where both fields were not populated together. | ## PSDK\_3.68.26 | Type | Description | | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Bugfix | (Nexo) Populate `Payment::getPreviousBalance()` for stored-value reversal responses. `VF_PreviousBalance` from AGPA was already mapped for sale responses but was being dropped when parsing reversal responses, leaving `getPreviousBalance()` empty on stored-value voids. | ## PSDK\_3.68.25 | Type | Description | | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Bugfix | (Nexo) Provide EMV tag `4F` (Application Identifier) under its canonical key even when AGPA returns only tag `84` (Dedicated File Name). Both tags carry the same AID value; when `4F` is absent the value is now populated from `84`, so integrators reading the EMV tag map can always look up the AID at key `"4F"` without having to fall back to `"84"` themselves. | ## PSDK\_3.68.24 | Type | Description | | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Bugfix | (Nexo) Expose `StoredValueCardInformation` on `PaymentCompletedEvent` when voiding a stored-value (gift) card. Reversal responses from AGPA do not carry `PaymentInstrumentData`, so PSDK previously mapped the balance only to `CardInformation` and `getStoredValueCardInformation()` returned null. PSDK now constructs a full `StoredValueCardInformation` object whenever `VF_PaymentHostData.StoredValueAccountStatus.CurrentBalance` is present, matching the sale-response behavior. | | Feature | Added `StoredValueCardInformation::getClassCode()` — returns the host- or payment-application-assigned class code identifying the stored-value card class or category. Populated from `VF_ClassCode` on Nexo and from the equivalent SCA field. Optional. | | Feature | (SCA) Added `Payment::getAuthResponseCode()` support for SCA — the host response code is now mapped from the SCA `HOST_RESPCODE` field, matching the Nexo behavior. | | Feature | (Nexo) Reversal responses now populate `PaymentInstrumentData`-derived fields (PAN, expiry, brand, account type) on the resulting `Payment` object, allowing integrators to obtain card details from a void without a separate lookup. | ## PSDK\_3.68.23 | Type | Description | | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Feature | Added `TransactionManager::TERMINAL_ID_KEY` configuration parameter (Nexo only). When supplied through `PsdkInitialization`, PSDK issues a `VF_SetDeviceID` admin request carrying the TerminalID during connection setup. May be used together with `VHQ_DEVICE_ID_KEY` — both values are sent in a single admin request when both are configured. Initialization fails immediately with `Status::NOT_ALLOWED` if `TERMINAL_ID_KEY` is supplied when the configured protocol is SCA (`DEVICE_PROTOCOL_SCI`). Empty TerminalID strings are rejected with `INVALID_ARGUMENTS`. | | Feature | (Nexo) Broaden `TransactionManager::SUPPRESS_DISPLAY_MESSAGES_CAPABILITY` to cover general payment transactions. When the capability is enabled at sale time, PSDK now emits a `VF_CustomerDisplayControl` extension on the Nexo `PaymentRequest`, instructing the terminal to suppress customer-facing display messages for the duration of the payment. Previously this capability affected stored-value operations only. | | Feature | Added support for multi-round terminal diagnoses on Nexo. New `DiagnosisType` enum (`DIAGNOSIS1`–`DIAGNOSIS5`), new `DiagnosisStatus` record (`diagnosisType`, `isOk`, optional `receipt`), and a new `DeviceVitals::diagnosisStatuses` list. `TransactionManager::requestDeviceVitals()` now runs the five Nexo diagnosis rounds sequentially and aggregates each round's status, OK flag, and optional printed receipt into `DeviceVitals::diagnosisStatuses`. Non-Nexo protocols (SCA, SoftPOS, Stub) return `UNSUPPORTED_COMMAND` for the typed diagnosis call. | ## PSDK\_3.68.22 | Type | Description | | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Feature | Added Nordic token support (Nexo only). New `NordicTokenRequest`, `NordicToken`, and `NordicTokenResponse` records together with `NordicTokenRequestedType` (`CUSTOMER`/`TRANSACTION`), `NordicTokenRetrievalType` (`CREATE_IF_NOT_EXISTING`/`RETRIEVE_ONLY`), `NordicTokenEnrolment` (`ALLOWED`/`FORBIDDEN`), `NordicTokenEnrolmentStatus`, and `NordicTokenResult` enums describe the request, returned token, and per-request response respectively. Integrators set requests via `CardAcquisitionRequest::setNordicTokenRequests()` or `Payment::setNordicTokenRequests()`; the terminal's responses are exposed through `CardInformationReceivedEvent::getNordicTokens()`/`getNordicTokenResponses()` and `PaymentCompletedEvent::getNordicTokens()`/`getNordicTokenResponses()`. Each request may specify a token scheme id and a brand priority list for multi-application cards. Malformed token or token-response entries that are missing mandatory fields are now logged and skipped rather than silently producing default-constructed values. | | Feature | Added `TransactionType::FUND_TRANSFER` for fund-transfer transactions between accounts (Nexo only). The flow involves entering the transfer amount, swiping the customer card, selecting source/destination account type, and entering PIN for authorization. `FUND_TRANSFER` is mapped to the Nexo `FUNDS_TRANSFER` payment function; SCA returns the same error as for any other unsupported transaction type. | | Feature | (Nexo) Align response-data parsing with AGPA across stored-value, balance-inquiry, and reversal responses. Newly parsed fields surfaced through the existing `Payment` API: `ApprovalCode` → `getHostAuthCode()`; `AcquirerPOIID` → `getAcquirerPoiId()`; `MerchantID` → `getMerchantId()`; `VF_PreviousBalance` → `getPreviousBalance()` (balance-inquiry); `AuthResponseText` and `RequestedAmounts` on reversal responses. `VF_PaymentInstrumentData` is now read from reversal responses, populating expiry, brand, and account type. Cardholder name now falls back to the cardholder field from `PaymentAppSpecificData` when not provided in the standard fields, and the SDK now reports `AccountType::STORED_VALUE` for stored-value instruments when no explicit account type is given. Existing integrations that read these getters automatically see the additional data with no API change. | ## PSDK\_3.68.21 | Ticket | Type | Description | | --------- | ------- | -------------------------------------------------------------- | | PSDK-7231 | Feature | Add support of new instruction NFC\_PT\_Adv\_TxRx | | PSDK-7013 | Feature | PSDK: add support for new virtual keys for navigator PIN entry | ## PSDK\_3.68.20 | Ticket | Type | Description | | -------------- | ------ | ------------------------------------------------------------------------------------------------ | | ESAMDOCS-56569 | Bugfix | BAC - TransactionManager.EnableReader ends with an unexpected Transaction Canceled notification. | ## PSDK\_3.68.19 | Ticket | Type | Description | | -------------- | ------ | ----------------------------------------------------------------------------------------------------- | | PSDK-6892 | Bugfix | Did not receive AuthResult for stored value operations | | ESAMDOCS-56918 | Bugfix | Terminal stuck on "Please wait" screen when loading a non-activated Valutec card after receipt screen | | PSDK-7222 | Bugfix | VerifoneSDK init Fail | | ESAMDOCS-56925 | Bugfix | \[CM5 PROD] PSDK -20 Awaiting Terminal | | PSDK-7152 | Bugfix | Protocol cache miss | ## PSDK\_3.68.18 | Ticket | Type | Description | | --------- | ------- | ------------------------------------------------------------------------------------ | | PSDK-7234 | Bugfix | For AGPA integration strip slash from ExpiryDate when serializing | | PSDK-7233 | Bugfix | Fix SCA LoyaltyResponse not propagating error status to CardInformationReceivedEvent | | PSDK-7176 | Feature | Add getStoredValueCardBalanceWith to allow to restrict card entry modes for AGPA | ## PSDK\_3.68.17 | Ticket | Type | Description | | --------- | ------- | ------------------------------------------------------------------------------------ | | PSDK-5824 | Feature | Integrate e-receipt functionality with NFC target actions and NDEF creation | | PSDK-7034 | Feature | Add dynamic transaction descriptor support to Payment interface | | PSDK-7180 | Bugfix | Align SCA LoyaltyAccounts and CardInformation with AGPA | | PSDK-7114 | Feature | Allow CardAcquisition out of session | | PSDK-7176 | Feature | Add Presentation Methods to the Stored Value Request (Balance check is an exception) | ## PSDK\_3.68.16 | Ticket | Type | Description | | --------- | ------- | ----------------------------------------------------------------------------------------------------------------------------- | | PSDK-7132 | Feature | Added capability to suppress NEXO display messages for gift card (Stored Value) operations | | PSDK-7133 | Feature | Added support to send SCA Loyalty Request when setLoyaltyHandling(LoyaltyHandlingType.REQUIRED) is called on requestCardData2 | ## PSDK\_3.68.15 | Ticket | Type | Description | | --------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | | PSDK-7128 | Bugfix | Fixed a PSDK bug leading to blocked initialization/tearing down during a terminal reboot/busy state | | PSDK-7078 | Feature | Implemented the extension to set the VHQ Device Id for the nexo terminals using the Admin Requests and the VHQ\_DEVICE\_ID\_KEY PSDK configuration parameter. | ## PSDK\_3.68.14 | Ticket | Type | Description | | --------- | ------- | ------------------------------------------------------------------------------------------------------ | | PSDK-7082 | Feature | Return Original Transaction ID/Timestamp for reversals in Payment::getOriginalRetrievalReferenceNumber | ## PSDK\_3.68.13 | Ticket | Type | Description | | --------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------- | | PSDK-7050 | Feature | Empty string value passed to StoredValueCardInformation::setCardPan and CardInformation::setCardPan no longer add empty tags sent to SCA | ## PSDK\_3.68.12 | Ticket | Type | Description | | --------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | PSDK-6956 | Feature | Added capability to suppress SCA display messages for gift card operations | | PSDK-7032 | Bugfix | Updated Nexo driver to correctly read and report previous balance for Gift card response | | PSDK-7031 | Feature | Implemented VF\_SecondaryTransactionID Nexo extension to pass Braintree Global Transaction ID to POS from AGPA. The corresponding PSDK call is Payment::getSecondaryAcquirerTransactionId() | ## PSDK\_3.68.11 | Ticket | Type | Description | | --------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | PSDK-7051 | Feature | PsdkDeviceInformation::model and PsdkDeviceInformation::serialNumber are now populated on successful PaymentSdk::Initialize call completion as opposed to being populated on successful TransactionManager::login previously | ## PSDK\_3.68.10 | Ticket | Type | Description | | --------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------- | | PSDK-6956 | Feature | Added capability to suppress SCA display messages for gift card operations | | PSDK-6659 | Feature | PaymentSdk::getDeviceInformation::model now contains model designation for SCA devices | | PSDK-6971 | Feature | SCA startSession will return Status::DEVICE\_NOT\_READY and CommandStatus::CONFIGURATION\_IN\_PROGRESS when SCA config is in progress | ## PSDK\_3.68.9 | Ticket | Type | Description | | --------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | PSDK-7024 | Feature | Added new CTLS transaction option enumeration values to PSDK-SDI: TXNOP\_SEND\_POI\_INFORMATION, TXNOP\_BEEP\_BY\_BUZZER, TXNOP\_BEEP\_OS\_VOLUME and LOGO\_LED\_AUTO\_SWITCH. | ## PSDK\_3.68.8 | Ticket | Type | Description | | --------- | ------- | -------------------------------------------------------------------------------------------------------------------------------- | | PSDK-6980 | Bugfix | Update PSDK to avoid sending double connection lost events. | | PSDK-6314 | Bugfix | Fixed possible deadlock on multi connection protocol disconnection. | | PSDK-6932 | Feature | Allow to populate card expiration data in CardInformation when using Tokens as payment instrument, required for Chase processing | ## PSDK\_3.68.7 | Ticket | Type | Description | | --------- | ------- | ------------------------------------------------------------------------------------------------ | | PSDK-6724 | Bugfix | Populate MedicalAmounts | | PSDK-6840 | Feature | Support reporting payment acquirer data when processing StoredValueCardEvent for balance enquiry | | PSDK-6726 | Feature | Add support for silent abort in SCI | | PSDK-6753 | Feature | add support to build with 16kb paging for android | ## PSDK\_3.68.6 | Ticket | Type | Description | | --------- | ------- | ----------------------------------------------------------------------------------------------------------- | | PSDK-6628 | Feature | Implemented APIs to support AGPA setting/reporting Navigator configuration | | PSDK-6562 | Bugfix | Move 5F2D EMV tag processing into the correct element layer, this will be present for all card acquisitions | ## PSDK\_3.68.5 | Ticket | Type | Description | | --------- | ----------- | ------------------------------------------------------------------------------------- | | PSDK-6413 | Enhancement | Add Customer ID and Partner ID fields for SCI and NEXO | | PSDK-6414 | Enhancement | Added getAcquirerTransactionId() API returning transaction ID as set by acquirer host | | PSDK-6271 | Bugfix | Fix Dankort and Bankaxept reported as non-PCI cards | | PSDK-6511 | Enhancement | Added getStoredValueCardInformation to CardInformationReceivedEvent | ## PSDK\_3.68.4 | Ticket | Type | Description | | --------- | ------ | -------------------------------------------------------------------------------------------------------------- | | PSDK-6300 | BugFix | Fix windows PSDK hanging when time is rolled back | | PSDK-6514 | BugFix | PSDK Android (non-SDI) introduced the serial\_high\_speed device connection type to meet the 921600 baud rate. | | PSDK-6540 | BugFix | Updated windows SDK to 19041 (matches windows 10 2004 patch level). | ## PSDK\_3.68.3 | Ticket | Type | Description | | --------- | ------ | ------------------------------------------------------------------ | | PSDK-6318 | BugFix | SDI - For SDI avoid calling Context.WINDOW\_SERVICE on Android 13+ | ## PSDK\_3.68.2 | Ticket | Type | Description | | --------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | PSDK-6444 | BugFix | SDI - resolved bug when returned IV was ignored in case of missing IV in the request for SdiCrypto::encrypt, SdiCrypto::sign, SdiData::getEncData, SdiData::getEncDataWith, SdiData::getMsgDataWith, SdiData::getMsgSignature and SdiData::getMsgSignatureWith | ## PSDK\_3.68.1 | Ticket | Type | Description | | -------------- | ------ | ------------------------------------------------------------------------------------------------------- | | ESAMDOCS-53210 | BugFix | SDI - resolved bug when returned IV was ignored in case of missing IV in the request for getEncMsgData. | ## PSDK\_3.68.0 | Ticket | Type | Description | | --------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------ | | PSDK-3601 | Enhancement | Added terminal payment configuration elements to psdk device information object. | | PSDK-5057 | Enhancement | Added complete support for loyalty handling for GPA/AGPA terminals. | | PSDK-5337 | Enhancement | Implemented support for USB Serial for PSDK-SDI. | | PSDK-5568 | Enhancement | Fixed a crash caused during disconnection on SCA terminals. | | PSDK-5652 | Enhancement | Removed greenrobot usage from PSDK Android java ref app | | PSDK-5810 | Enhancement | For SDI added cardDetectCallback that receives SdiResultCode and SdiCardTechnology typed parameters. | | PSDK-5910 | Enhancement | Added method isSessionOpen() in TransactionManager interface | | PSDK-5928 | Enhancement | Fixed missing PSDK localization in iOS simulator builds. | | PSDK-5948 | Enhancement | Updated NotificationEvent SAF\_STATUS\_UPDATE with Void Response support for GPA/AGPA. | | PSDK-5950 | Enhancement | Added API in PSDK to get the Battery Status. | | PSDK-5961 | Enhancement | Added SDI API getPinTouchButtonsWithBypassBtn() that returns the bypass button value. | | PSDK-5963 | Enhancement | Added ORDER TYPE in POS response for all supported commands which already had ORDER TYPE in POS request | | PSDK-5985 | Enhancement | Changed CardInformation::MASTER\_CARD string constant value to MASTERCARD, reflecting accurate scheme naming. | | PSDK-5986 | Enhancement | Added Greenbox specific UUID that identifies this device and is used to execute follow-on operations in an omnichannel setup for GPA/AGPA. | | PSDK-6011 | Enhancement | Implemented USB serial support for off-device integrations on Android OS | | PSDK-6049 | Enhancement | Added PsdkInitializationConstants into the Windows .Net API | | PSDK-6117 | Enhancement | Populated preferred languages in cardinformation from emv tags for GPA/AGPA. | | PSDK-6132 | Enhancement | Handled line breaks outside of the table structure in HTML Receipt for GPA/AGPA. | | PSDK-6145 | Enhancement | Added newline symbols support to SCA presentUserOptions header string. | | PSDK-6170 | Enhancement | Updated PSDK to send CARD\_PRESENTED NotificationType for SCA. | | PSDK-6224 | Enhancement | Build .Net PSDK versions against .Net Framework 4.6.2 for backwards compatibility. | | PSDK-6231 | Enhancement | Fixed issue with setDisconnectCallback API for PSDK-SDI. | | PSDK-6252 | Enhancement | Added UI button and reference code to detect and read the Uid from mifare card on java-sdi and kotlin-sdi reference app. | | PSDK-5983 | BugFix | Implemented populating fields required for SCA L2 data processing | | PSDK-6034 | BugFix | Exposed access to SdiTlv object in SdiEmvTxn. | | PSDK-6255 | BugFix | Added a get API for nfc/vas data for PSDK-SDI. | | PSDK-6277 | BugFix | For Android USB comms resolve a bug blocking re-initialization on error | | PSDK-6282 | BugFix | For the PSDK nexo protocol fixed a bug to avoid dropping the connection on which slow-speed data exchange happens. | | PSDK-6286 | BugFix | Updated PSDK state machine to handle PinEvents in error scenario. | --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.verifone.com/psdk-latest/psdk-downloads-and-class-intro/release-notes/3.68.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.