org.eclipse.keyple.calypso.transaction

Class PoTransaction

java.lang.Object

org.eclipse.keyple.calypso.transaction.PoTransaction

public class PoTransaction
extends java.lang.Object

This service provides the high-level API to manage transactions with a Calypso PO.

Depending on the type of operations required, the presence of a SAM may be necessary.

The CalypsoPo object provided to the build is kept and updated at each step of using the service. It is the main container of the data handled during the transaction and acts as a card image.

There are two main steps in using the methods of this service:

• A command preparation step during which the application invokes prefixed "prepare" methods that will add to an internal list of commands to be executed by the PO. The incoming data to the PO are placed in CalypsoPo.
• A processing step corresponding to the prefixed "process" methods, which will carry out the communications with the PO and if necessary the SAM. The outgoing data from the PO are placed in CalypsoPo.

Technical or data errors, security conditions, etc. are reported as exceptions.

Since:

0.9

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	PoTransaction.PinTransmissionMode Defines the PIN transmission modes: plain or encrypted.
static class	PoTransaction.SessionSetting Contains the Calypso Secure Session set of parameters.
static class	PoTransaction.SvSettings Defines the Stored Value transactions parameters

Constructor Summary

Constructors

Constructor and Description
PoTransaction(org.eclipse.keyple.core.card.selection.CardResource<CalypsoPo> poResource) Constructor.
PoTransaction(org.eclipse.keyple.core.card.selection.CardResource<CalypsoPo> poResource, PoSecuritySettings poSecuritySettings) Constructor.

Method Summary

Modifier and Type	Method and Description
void	prepareAppendRecord(byte sfi, byte[] recordData) Schedules the execution of a Append Record command to adds the data provided in the indicated cyclic file.
void	prepareCheckPinStatus() Schedules the execution of a Verify Pin command without PIN presentation in order to get the attempt counter.
void	prepareDecreaseCounter(byte sfi, int counterNumber, int decValue) Schedules the execution of a Decrease command command to decrease the target counter.
void	prepareIncreaseCounter(byte sfi, int counterNumber, int incValue) Schedules the execution of a Increase command command to increase the target counter.
void	prepareInvalidate() Schedules the execution of a Invalidate command.
void	prepareReadCounterFile(byte sfi, int countersNumber) Schedules the execution of a Read Records command to reads a record of the indicated EF, which should be a counter file.
void	prepareReadRecordFile(byte sfi, int recordNumber) Schedules the execution of a Read Records command to read a single record from the indicated EF.
void	prepareReadRecordFile(byte sfi, int firstRecordNumber, int numberOfRecords, int recordSize) Schedules the execution of a Read Records command to read one or more records from the indicated EF.
void	prepareRehabilitate() Schedules the execution of a Rehabilitate command.
void	prepareReleasePoChannel() Requests the closing of the PO channel.
void	prepareSelectFile(byte[] lid) Schedules the execution of a Select File command based on the file's LID.
void	prepareSelectFile(SelectFileControl control) Schedules the execution of a Select File command using a navigation control defined by the ISO standard.
void	prepareSetCounter(byte sfi, int counterNumber, int newValue) Schedules the execution of a command to set the value of the target counter.
void	prepareSvDebit(int amount) Schedules the execution of a SV Debit or SV Undebit command to increase the current SV balance or to partially or totally cancels the last SV debit command.
void	prepareSvDebit(int amount, byte[] date, byte[] time) Schedules the execution of a SV Debit or SV Undebit command to increase the current SV balance or to partially or totally cancels the last SV debit command and using the provided additional data.
void	prepareSvGet(PoTransaction.SvSettings.Operation svOperation, PoTransaction.SvSettings.Action svAction) Schedules the execution of a SV Get command to prepare an SV operation or simply retrieves the current SV status.
void	prepareSvReadAllLogs() Schedules the execution of Read Records commands to read all SV logs.
void	prepareSvReload(int amount) Schedules the execution of a SV Reload command to increase the current SV balance.
void	prepareSvReload(int amount, byte[] date, byte[] time, byte[] free) Schedules the execution of a SV Reload command to increase the current SV balance and using the provided additional data.
void	prepareUpdateRecord(byte sfi, int recordNumber, byte[] recordData) Schedules the execution of a Update Record command to overwrites the target file's record contents with the provided data.
void	prepareWriteRecord(byte sfi, int recordNumber, byte[] recordData) Schedules the execution of a Write Record command to updates the target file's record contents with the result of a binary OR between the existing data and the provided data.
void	processCancel() Aborts a Secure Session.
void	processClosing() Terminates the Secure Session sequence started with processOpening(SessionSetting.AccessLevel).
void	processOpening(PoTransaction.SessionSetting.AccessLevel accessLevel) Opens a Calypso Secure Session and then executes all previously prepared commands.
void	processPoCommands() Process all previously prepared PO commands outside or inside a Secure Session.
void	processVerifyPin(byte[] pin) Performs a PIN verification, in order to authenticate the card holder and/or unlock access to certain PO files.
void	processVerifyPin(java.lang.String pin) Invokes processVerifyPin(byte[]) with a string converted into an array of bytes as argument.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

PoTransaction

public PoTransaction(org.eclipse.keyple.core.card.selection.CardResource<CalypsoPo> poResource,
                     PoSecuritySettings poSecuritySettings)

Constructor.

Secure operations are enabled by the presence of PoSecuritySettings.

Parameters:

poResource - the PO resource (combination of Reader and CalypsoPo)

poSecuritySettings - a set of security settings (PoSecuritySettings) including a CardResource based on a CalypsoSam.

Since:

0.9

PoTransaction

public PoTransaction(org.eclipse.keyple.core.card.selection.CardResource<CalypsoPo> poResource)

Constructor.

Parameters:

poResource - the PO resource (combination of Reader and CalypsoPo)

Since:

0.9

Method Detail

processOpening

public final void processOpening(PoTransaction.SessionSetting.AccessLevel accessLevel)

Opens a Calypso Secure Session and then executes all previously prepared commands.

It is the starting point of the sequence:

• processOpening(SessionSetting.AccessLevel)
• [processPoCommands()]
• [...]
• [processPoCommands()]
• processClosing()

Each of the steps in this sequence may or may not be preceded by the preparation of one or more commands and ends with an update of the CalypsoPo object provided when PoTransaction was created.

As a prerequisite for calling this method, since the Calypso Secure Session involves the use of a SAM, the PoTransaction must have been built in secure mode, i.e. the constructor used must be the one expecting a reference to a valid PoSecuritySettings object, otherwise a CalypsoPoTransactionIllegalStateException is raised.

The secure session is opened with the PoTransaction.SessionSetting.AccessLevel passed as an argument depending on whether it is a personalization, reload or debit transaction profile..

The possible overflow of the internal session buffer of the PO is managed in two ways depending on the setting chosen in PoSecuritySettings.

• If the session was opened with the PoTransaction.SessionSetting.ModificationMode.ATOMIC mode and the previously prepared commands will cause the buffer to be exceeded, then an CalypsoAtomicTransactionException is raised and no transmission to the PO is made.
  
• If the session was opened with the PoTransaction.SessionSetting.ModificationMode.MULTIPLE mode and the buffer is to be exceeded then a split into several secure sessions is performed automatically. However, regardless of the number of intermediate sessions performed, a secure session is opened at the end of the execution of this method.

Be aware that in the "MULTIPLE" case we lose the benefit of the atomicity of the secure session.

PO and SAM exchanges in detail

When executing this method, communications with the PO and the SAM are (in that order) :

• Sending the card diversifier (Calypso PO serial number) to the SAM and receiving the terminal challenge
• Grouped sending to the PO (in a CardRequest) of
  • the open secure session command including the challenge terminal.
  • all previously prepared commands
• Receiving grouped responses and updating CalypsoPo with the collected data.

For optimization purposes, if the first command prepared is the reading of a single record of a PO file then this one is replaced by a setting of the session opening command allowing the retrieval of this data in response to this command.

Other operations carried out

• The card KIF, KVC and card challenge received in response to the open secure session command are kept for a later initialization of the session's digest (see processClosing()).
• All data received in response to the open secure session command and the responses to the prepared commands are also stored for later calculation of the digest.
• If a list of authorized KVCs has been defined in PoSecuritySettings and the KVC of the card does not belong to this list then a CalypsoUnauthorizedKvcException is thrown.

All unexpected results (communication errors, data or security errors, etc. are notified to the calling application through dedicated exceptions.

Note: to understand in detail how the secure session works please refer to the PO specification documents.

Parameters:

accessLevel - An PoTransaction.SessionSetting.AccessLevel enum entry.

Throws:

CalypsoPoTransactionIllegalStateException - if no PoSecuritySettings is available

CalypsoAtomicTransactionException - if the PO session buffer were to overflow

CalypsoUnauthorizedKvcException - if the card KVC is not authorized

CalypsoPoTransactionException - if a functional error occurs (including PO and SAM IO errors)

CalypsoPoCommandException - if a response from the PO was unexpected

CalypsoSamCommandException - if a response from the SAM was unexpected

Since:

0.9

processPoCommands

public final void processPoCommands()

Process all previously prepared PO commands outside or inside a Secure Session.

• All APDUs resulting from prepared commands are grouped in a CardRequest and sent to the PO.
• The CalypsoPo object is updated with the result of the executed commands.
• If a secure session is opened, except in the case where reloading or debit SV operations have been prepared, the invocation of this method does not generate communication with the SAM. The data necessary for the calculation of the terminal signature are kept to be sent to the SAM at the time of the call to processClosing().
  The PO channel is kept open.
• If no secure session is opened, the PO channel is closed depending on whether or not prepareReleasePoChannel has been called.
• The PO session buffer overflows are managed in the same way as in processOpening(SessionSetting.AccessLevel). For example, when the PoTransaction.SessionSetting.ModificationMode.MULTIPLE mode is chosen, the commands are separated in as many sessions as necessary to respect the capacity of the PO buffer.

Throws:

CalypsoPoTransactionException - if a functional error occurs (including PO and SAM IO errors)

CalypsoPoCommandException - if a response from the PO was unexpected

CalypsoSamCommandException - if a response from the SAM was unexpected

Since:

0.9

processClosing

public final void processClosing()

Terminates the Secure Session sequence started with processOpening(SessionSetting.AccessLevel).

Nominal case

The previously prepared commands are integrated into the calculation of the session digest by the SAM before execution by the PO by anticipating their responses.

Thus, the session closing command containing the terminal signature is integrated into the same APDU group sent to the PO via a final CardRequest.

Upon reception of the CardRequest PO, the signature of the PO is verified with the SAM.

If the method terminates normally, it means that the secure session closing and all related security checks have been successful; conversely, if one of these operations fails, an exception is raised.

Stored Value

If the SV counter was debited or reloaded during the session, an additional verification specific to the SV is performed by the SAM.

Ratification

A ratification command is added after the close secure session command when the communication is done in a contactless mode.

The logical channel is closed or left open depending on whether the prepareReleasePoChannel() method has been called before or not.

PO and SAM exchanges in detail

• All the data exchanged with the PO so far, to which are added the last prepared orders and their anticipated answers, are sent to the SAM for the calculation of the session digest. The terminal signature calculation request is also integrated in the same CardRequest SAM.
• All previously prepared commands are sent to the PO along with the session closing command and possibly the ratification command within a single CardRequest.
• The responses received from the PO are integrated into CalypsoPo.
  Note: the reception of the answers of this final CardRequest PO is tolerant to the non-reception of the answer to the ratification order.
• The data received from the PO in response to the logout (PO session signature and possibly SV signature) are sent to the SAM for verification.

Throws:

CalypsoPoTransactionException - if a functional error occurs (including PO and SAM IO errors)

CalypsoPoCommandException - if a response from the PO was unexpected

CalypsoSamCommandException - if a response from the SAM was unexpected

Since:

0.9

processCancel

public final void processCancel()

Aborts a Secure Session.

Send the appropriate command to the PO

Clean up internal data and status.

Throws:

CalypsoPoTransactionException - if a functional error occurs (including PO and SAM IO errors)

CalypsoPoCommandException - if a response from the PO was unexpected

Since:

0.9

processVerifyPin

public final void processVerifyPin(byte[] pin)

Performs a PIN verification, in order to authenticate the card holder and/or unlock access to certain PO files.

This command can be performed both in and out of a secure session. The PIN code can be transmitted in plain text or encrypted according to the parameter set in PoSecuritySettings (by default the transmission is encrypted).

If the execution is done out of session but an encrypted transmission is requested, then PoTransaction must be constructed with PoSecuritySettings

If PoTransaction is constructed without PoSecuritySettings the transmission in done in plain.

The PO channel is closed if prepareReleasePoChannel is called before this command.

Parameters:

pin - the PIN code value (4-byte long byte array)

Throws:

CalypsoPoTransactionException - if a functional error occurs (including PO and SAM IO errors)

CalypsoPoCommandException - if a response from the PO was unexpected

CalypsoPoPinException - if the PIN presentation failed (the remaining attempt counter is update in Calypso). See CalypsoPo.isPinBlocked() and CalypsoPo.getPinAttemptRemaining() methods

CalypsoPoTransactionIllegalStateException - if the PIN feature is not available for this PO or if commands have been prepared before calling this process method.

Since:

0.9

processVerifyPin

public final void processVerifyPin(java.lang.String pin)

Invokes processVerifyPin(byte[]) with a string converted into an array of bytes as argument.

The provided String is converted into an array of bytes and processed with processVerifyPin(byte[]).

E.g. "1234" will be transmitted as { 0x31,0x32,0x33,0x34 }

Parameters:

pin - an ASCII string (4-character long)

Since:

0.9

See Also:

processVerifyPin(byte[])

prepareReleasePoChannel

public final void prepareReleasePoChannel()

Requests the closing of the PO channel.

If this command is called before a "process" command (except for processOpening) then the last transmission to the PO will be associated with the indication CLOSE_AFTER in order to close the PO channel.

Note: this command must imperatively be called at the end of any transaction, whether it ended normally or not.

In case the transaction was interrupted (exception), an additional call to processPoCommands must be made to effectively close the channel.

Since:

0.9

prepareSelectFile

public final void prepareSelectFile(byte[] lid)

Schedules the execution of a Select File command based on the file's LID.

Once this command is processed, the result is available in CalypsoPo through the CalypsoPo.getFileBySfi(byte) and ElementaryFile.getHeader() methods.

Parameters:

lid - the LID of the EF to select

Since:

0.9

prepareSelectFile

public final void prepareSelectFile(SelectFileControl control)

Schedules the execution of a Select File command using a navigation control defined by the ISO standard.

Once this command is processed, the result is available in CalypsoPo through the CalypsoPo.getFileBySfi(byte) and ElementaryFile.getHeader() methods.

Parameters:

control - A SelectFileControl enum entry

Since:

0.9

prepareReadRecordFile

public final void prepareReadRecordFile(byte sfi,
                                        int recordNumber)

Schedules the execution of a Read Records command to read a single record from the indicated EF.

Once this command is processed, the result is available in CalypsoPo.

See the method CalypsoPo.getFileBySfi(byte), the objects ElementaryFile, FileData and their specialized methods according to the type of expected data: e.g. FileData.getContent(int).

Parameters:

sfi - the SFI of the EF to read

recordNumber - the record number to read

Throws:

java.lang.IllegalArgumentException - if one of the provided argument is out of range

Since:

0.9

prepareReadRecordFile

public final void prepareReadRecordFile(byte sfi,
                                        int firstRecordNumber,
                                        int numberOfRecords,
                                        int recordSize)

Schedules the execution of a Read Records command to read one or more records from the indicated EF.

Once this command is processed, the result is available in CalypsoPo.

See the method CalypsoPo.getFileBySfi(byte), the objects ElementaryFile, FileData and their specialized methods according to the type of expected data: e.g. FileData.getContent().

Parameters:

sfi - the SFI of the EF

firstRecordNumber - the record number to read (or first record to read in case of several records)

numberOfRecords - the number of records expected

recordSize - the record length

Throws:

java.lang.IllegalArgumentException - if one of the provided argument is out of range

Since:

0.9

prepareReadCounterFile

public final void prepareReadCounterFile(byte sfi,
                                         int countersNumber)

Schedules the execution of a Read Records command to reads a record of the indicated EF, which should be a counter file.

The record will be read up to the counter location indicated in parameter.
Thus all previous counters will also be read.

Once this command is processed, the result is available in CalypsoPo.

See the method CalypsoPo.getFileBySfi(byte), the objects ElementaryFile, FileData and their specialized methods according to the type of expected data: e.g. FileData.getAllCountersValue() (int)}.

Parameters:

sfi - the SFI of the EF

countersNumber - the number of the last counter to be read

Throws:

java.lang.IllegalArgumentException - if one of the provided argument is out of range

Since:

0.9

prepareAppendRecord

public final void prepareAppendRecord(byte sfi,
                                      byte[] recordData)

Schedules the execution of a Append Record command to adds the data provided in the indicated cyclic file.

A new record is added, the oldest record is deleted.

Note: CalypsoPo is filled with the provided input data.

Parameters:

sfi - the sfi to select

recordData - the new record data to write

Throws:

java.lang.IllegalArgumentException - if the command is inconsistent

Since:

0.9

prepareUpdateRecord

public final void prepareUpdateRecord(byte sfi,
                                      int recordNumber,
                                      byte[] recordData)

Schedules the execution of a Update Record command to overwrites the target file's record contents with the provided data.

If the input data is shorter than the record size, only the first bytes will be overwritten.

Note: CalypsoPo is filled with the provided input data.

Parameters:

sfi - the sfi to select

recordNumber - the record number to update

recordData - the new record data. If length < RecSize, bytes beyond length are left unchanged.

Throws:

java.lang.IllegalArgumentException - if record number is < 1

java.lang.IllegalArgumentException - if the request is inconsistent

Since:

0.9

prepareWriteRecord

public final void prepareWriteRecord(byte sfi,
                                     int recordNumber,
                                     byte[] recordData)

Schedules the execution of a Write Record command to updates the target file's record contents with the result of a binary OR between the existing data and the provided data.

If the input data is shorter than the record size, only the first bytes will be overwritten.

Note: CalypsoPo is filled with the provided input data.

Parameters:

sfi - the sfi to select

recordNumber - the record number to write

recordData - the data to overwrite in the record. If length < RecSize, bytes beyond length are left unchanged.

Throws:

java.lang.IllegalArgumentException - if record number is < 1

java.lang.IllegalArgumentException - if the request is inconsistent

Since:

0.9

prepareIncreaseCounter

public final void prepareIncreaseCounter(byte sfi,
                                         int counterNumber,
                                         int incValue)

Schedules the execution of a Increase command command to increase the target counter.

Note: CalypsoPo is filled with the provided input data.

Parameters:

counterNumber - >= 01h: Counters file, number of the counter. 00h: Simulated Counter file.

sfi - SFI of the file to select or 00h for current EF

incValue - Value to add to the counter (defined as a positive int <= 16777215 [FFFFFFh])

Throws:

java.lang.IllegalArgumentException - if the decrement value is out of range

java.lang.IllegalArgumentException - if the command is inconsistent

Since:

0.9

prepareDecreaseCounter

public final void prepareDecreaseCounter(byte sfi,
                                         int counterNumber,
                                         int decValue)

Schedules the execution of a Decrease command command to decrease the target counter.

Note: CalypsoPo is filled with the provided input data.

Parameters:

counterNumber - >= 01h: Counters file, number of the counter. 00h: Simulated Counter file.

sfi - SFI of the file to select or 00h for current EF

decValue - Value to subtract to the counter (defined as a positive int <= 16777215 [FFFFFFh])

Throws:

java.lang.IllegalArgumentException - if the decrement value is out of range

java.lang.IllegalArgumentException - if the command is inconsistent

Since:

0.9

prepareSetCounter

public final void prepareSetCounter(byte sfi,
                                    int counterNumber,
                                    int newValue)

Schedules the execution of a command to set the value of the target counter.

It builds an Increase or Decrease command and add it to the list of commands to be sent with the next process command in order to set the target counter to the specified value.
The operation (Increase or Decrease) is selected according to whether the difference between the current value and the desired value is negative (Increase) or positive (Decrease).

Note: it is assumed here that:

• the counter value has been read before,
• the type of session (and associated access rights) is consistent with the requested operation: reload session if the counter is to be incremented, debit if it is to be decremented.
  No control is performed on this point by this method; the closing of the session will determine the success of the operation..

Parameters:

counterNumber - >= 01h: Counters file, number of the counter. 00h: Simulated Counter file.

sfi - SFI of the file to select or 00h for current EF

newValue - the desired value for the counter (defined as a positive int <= 16777215 [FFFFFFh])

Throws:

java.lang.IllegalArgumentException - if the desired value is out of range or if the command is inconsistent

CalypsoPoTransactionIllegalStateException - if the current counter value is unknown.

Since:

0.9

prepareCheckPinStatus

public final void prepareCheckPinStatus()

Schedules the execution of a Verify Pin command without PIN presentation in order to get the attempt counter.

The PIN status will made available in CalypsoPo after the execution of process command.
Adds it to the list of commands to be sent with the next process command.

See CalypsoPo.isPinBlocked() and CalypsoPo.getPinAttemptRemaining() methods.

Throws:

CalypsoPoTransactionIllegalStateException - if the PIN feature is not available for this PO.

Since:

0.9

prepareSvGet

public final void prepareSvGet(PoTransaction.SvSettings.Operation svOperation,
                               PoTransaction.SvSettings.Action svAction)

Schedules the execution of a SV Get command to prepare an SV operation or simply retrieves the current SV status.

Once this command is processed, the result is available in CalypsoPo.

See the methods CalypsoPo.getSvBalance(), CalypsoPo.getSvLoadLogRecord() ()}, CalypsoPo.getSvDebitLogLastRecord(), CalypsoPo.getSvDebitLogAllRecords().

Parameters:

svOperation - informs about the nature of the intended operation: debit or reload

svAction - the type of action: DO a debit or a positive reload, UNDO an undebit or a negative reload

Throws:

CalypsoPoTransactionIllegalStateException - if the SV feature is not available for this PO.

Since:

0.9

prepareSvReload

public final void prepareSvReload(int amount,
                                  byte[] date,
                                  byte[] time,
                                  byte[] free)

Schedules the execution of a SV Reload command to increase the current SV balance and using the provided additional data.

Note #1: a communication with the SAM is done here.

Note #2: the key used is the reload key.

Parameters:

amount - the value to be reloaded, positive or negative integer in the range -8388608..8388607

date - 2-byte free value

time - 2-byte free value

free - 2-byte free value

Throws:

CalypsoPoTransactionIllegalStateException - if the SV feature is not available for this PO.

Since:

0.9

prepareSvReload

public final void prepareSvReload(int amount)

Schedules the execution of a SV Reload command to increase the current SV balance.

Note #1: the optional SV additional data are set to zero.

Note #2: a communication with the SAM is done here.

Note #3: the key used is the reload key.

Parameters:

amount - the value to be reloaded, positive integer in the range 0..8388607 for a DO action, in the range 0..8388608 for an UNDO action.

Throws:

CalypsoPoTransactionIllegalStateException - if the SV feature is not available for this PO.

Since:

0.9

prepareSvDebit

public final void prepareSvDebit(int amount,
                                 byte[] date,
                                 byte[] time)

Schedules the execution of a SV Debit or SV Undebit command to increase the current SV balance or to partially or totally cancels the last SV debit command and using the provided additional data.

It consists in decreasing the current balance of the SV by a certain amount or canceling a previous debit according to the type operation chosen in when invoking the previous SV Get command.

Note #1: a communication with the SAM is done here.

Note #2: the key used is the reload key.

Parameters:

amount - the amount to be subtracted or added, positive integer in the range 0..32767 when subtracted and 0..32768 when added.

date - 2-byte free value

time - 2-byte free value

Since:

0.9

prepareSvDebit

public final void prepareSvDebit(int amount)

Schedules the execution of a SV Debit or SV Undebit command to increase the current SV balance or to partially or totally cancels the last SV debit command.

It consists in decreasing the current balance of the SV by a certain amount or canceling a previous debit.

Note #1: the optional SV additional data are set to zero.

Note #2: a communication with the SAM is done here.

Note #3: the key used is the reload key.The information fields such as date and time are set to 0. The extraInfo field propagated in Logs are automatically generated with the type of transaction and amount.

Note #4: operations that would result in a negative balance are forbidden (SV Exception raised).

Note #5: the key used is the debit key

Parameters:

amount - the amount to be subtracted or added, positive integer in the range 0..32767 when subtracted and 0..32768 when added.

Since:

0.9

prepareSvReadAllLogs

public final void prepareSvReadAllLogs()

Schedules the execution of Read Records commands to read all SV logs.

The SV transaction logs are contained in two files with fixed identifiers:

• The file whose SFI is 0x14 contains 1 record containing the unique reload log.
• The file whose SFI is 0x15 contains 3 records containing the last three debit logs.

At the end of this reading operation, the data will be accessible in CalypsoPo in raw format via the standard commands for accessing read files or in the form of dedicated objects (see CalypsoPo.getSvLoadLogRecord() and CalypsoPo.getSvDebitLogAllRecords())

Once this command is processed, the result is available in CalypsoPo.

See the methods CalypsoPo.getSvBalance(), CalypsoPo.getSvLoadLogRecord() ()}, CalypsoPo.getSvDebitLogLastRecord(), CalypsoPo.getSvDebitLogAllRecords(). *

Since:

0.9

prepareInvalidate

public final void prepareInvalidate()

Schedules the execution of a Invalidate command.

This command is usually executed within a secure session with the SESSION_LVL_DEBIT key (depends on the access rights given to this command in the file structure of the PO).

Throws:

CalypsoPoTransactionIllegalStateException - if the PO is already invalidated

Since:

0.9

prepareRehabilitate

public final void prepareRehabilitate()

Schedules the execution of a Rehabilitate command.

This command is usually executed within a secure session with the SESSION_LVL_PERSO key (depends on the access rights given to this command in the file structure of the PO).

Throws:

CalypsoPoTransactionIllegalStateException - if the PO is not invalidated

Since:

0.9