co.poynt.os.services.v1

Interface IPoyntSecurityService

All Superinterfaces:

android.os.IInterface

All Known Implementing Classes:

IPoyntSecurityService.Stub

public interface IPoyntSecurityService
extends android.os.IInterface

Provides interfaces to upate working key (for Master Key and Working Key) and encryption using special dukpt key. All calls require the necessary permissions declared in the caller's Android Manifest file. Please refer to Poynt OS Permissions for more details.

Since:

1.0-beta4

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	IPoyntSecurityService.Stub Local-side IPC implementation stub class.

Method Summary

Modifier and Type	Method and Description
void	collectManualEntryData(java.util.List<ManualEntryInputField> inputFields, java.util.List<ManualEntryOutputField> outputFields, java.util.List<ManualEntryFieldType> electronicReferralContent, java.util.List<ManualEntryFieldType> positiveIdContent, byte[] msrToken, IPoyntManualEntryDataListener callback) Request to collect card data and other requested fields through card reader (second screen) securely.
void	collectNewPin(IPoyntNewPINListener callback) Request to collect a new PIN from the consumer.
void	encryptDukpt(DukptData dataToEncrypt, IPoyntDataEncryptionListener callback) Encrypts the given data using Dukpt key for external data encryption.
void	updateSessionKey(int keySlotId, byte[] encryptedSessionKey, byte[] sessionKeyMac, byte[] keyId, IPoyntKeyUpdateListener callback) Update current session (aka working) key with the given new encrypted key.
void	updateSessionKeyLegacy(int keySlotId, byte[] encryptedSessionKey, byte[] keyId, IPoyntKeyUpdateListener callback) Legacy update current session key with the given new encrypted key.

Methods inherited from interface android.os.IInterface

asBinder

Method Detail

encryptDukpt

void encryptDukpt(DukptData dataToEncrypt,
                  IPoyntDataEncryptionListener callback)
           throws android.os.RemoteException

Encrypts the given data using Dukpt key for external data encryption. Returns the encrypted data along with KSN through the callback.

Parameters:

data - to encrypt

callback - IPoyntDataEncryptionListener

Throws:

android.os.RemoteException

updateSessionKey

void updateSessionKey(int keySlotId,
                      byte[] encryptedSessionKey,
                      byte[] sessionKeyMac,
                      byte[] keyId,
                      IPoyntKeyUpdateListener callback)
               throws android.os.RemoteException

Update current session (aka working) key with the given new encrypted key. The new session key must be encrypted with the corresponding master key.

Parameters:

key - slot if for the master key that corresponds to this session key

encrypted - session key

session - key mac

keyId - an 8-byte identifier for the key for identification purposes

callback - IPoyntKeyUpdateListener

Throws:

android.os.RemoteException

collectNewPin

void collectNewPin(IPoyntNewPINListener callback)
            throws android.os.RemoteException

Request to collect a new PIN from the consumer. Returns the encrypted PIN along with KSN through the callback. NOTE that this method only works if a transaction is waiting for an online authorization response.

Parameters:

callback - IPoyntDataEncryptionListener

Throws:

android.os.RemoteException

collectManualEntryData

void collectManualEntryData(java.util.List<ManualEntryInputField> inputFields,
                            java.util.List<ManualEntryOutputField> outputFields,
                            java.util.List<ManualEntryFieldType> electronicReferralContent,
                            java.util.List<ManualEntryFieldType> positiveIdContent,
                            byte[] msrToken,
                            IPoyntManualEntryDataListener callback)
                     throws android.os.RemoteException

Request to collect card data and other requested fields through card reader (second screen) securely.

Parameters:

inputFields -

outputFields -

electronicReferralContent - fields to include in the electronic Referral field if requested

positiveIdContent - fields to include in the positiveId field if requested

msrToken - to use same DUKPT key used for card data encryption in the previous swipe txn

manualEntryDataListener - callback

Throws:

android.os.RemoteException

updateSessionKeyLegacy

void updateSessionKeyLegacy(int keySlotId,
                            byte[] encryptedSessionKey,
                            byte[] keyId,
                            IPoyntKeyUpdateListener callback)
                     throws android.os.RemoteException

Legacy update current session key with the given new encrypted key. The new session key must be encrypted with the corresponding master key.

Parameters:

key - slot if for the master key that corresponds to this session key

encrypted - session key

keyId - an 8-byte identifier for the key for identification purposes

callback - IPoyntKeyUpdateListener

Throws:

android.os.RemoteException