EncryptedPIN Property

DUKPT DES encrypted pin block, retrieved from a PIN pad.

Syntax

char* GetEncryptedPIN();

int SetEncryptedPIN(char* lpszEncryptedPIN);

Default Value

Remarks

A 16-byte encrypted PIN and associated KSN are required for all debit Sale and Credit transactions. These values must be retrieved from a certified DUKPT DES pin pad device.

The EncryptedPIN and KSN are not required for ReverseLastTransaction transactions.

The following code snippet shows how to send a simple debit sale transaction with all required properties.

FDMSDebit1.MerchantNumber = "YOURNUMBER"
FDMSDebit1.MerchantTerminalNumber = "YOURTERMID"
FDMSDebit1.DatawireId = "YOURDID"
FDMSDebit1.URL = "https://staging1.datawire.net/sd"; // test server
FDMSDebit1.TransactionNumber = 4;
FDMSDebit1.TransactionAmount = "100";
FDMSDebit1.Card.EntryDataSource = edsTrack2;
FDMSDebit1.Card.MagneticStripe = "9876543210012341234=12041200000001"; // (pin 1234)
FDMSDebit1.EncryptedPIN = "0082943935BA205D";
FDMSDebit1.KSN = "8765432109003000012";
FDMSDebit1.ReceiptNumber = "123456";
FDMSDebit1.Sale();

If the transaction is successful, the ResponseApprovalCode will start with "AP", and the ResponseCaptureFlag will be true. Even though debit transactions are on-line transactions, it is still necessary to settle them with First Data. The following example shows how to send a simple settlement. The first thing to do is to set up the FDMSSettle class's properties with the same information used for the debit sale:

FDMSSettle1.MerchantNumber = FDMSDebit1.MerchantNumber;
FDMSSettle1.MerchantTerminalNumber = FDMSDebit1.MerchantTerminalNumber;
FDMSSettle1.DatawireId = FDMSDebit1.DatawireId;
FDMSSettle1.URL = FDMSDebit1.URL;
FDMSSettle1.MerchantServiceNumber = "8001234567";
FDMSSettle1.BatchSequenceNumber = "101";  
FDMSSettle1.IndustryType = itRetail;

Then all that needs to be done is add the detail record from the debit sale to the settlement component and call the SendSettlement method.

FDMSSettle1.DetailRecords.Add(new FDMSRecordType(FDMSDebit1.GetDetailAggregate());

FDMSSettle1.SendSettlement();

Note that in a live system you would store detail records in a database and send multiple records in a single batch at the end of the business day.

Data Type

String

EncryptedPIN Property

Syntax

Default Value

Remarks

Data Type

Questions / Feedback?