DPS EKX ActiveX object

This ActiveX object is designed to handle decryption of data for transaction information that has been encrypted by DPS. Usually used where sensitive information like creditcard number and expiry dates are returned to your application.

Technical Specifications/Features:
Decrypt sensitive data returned from DPS with a 3DES Key specific to your account Solution to help provide migration towards a Token Billing system, by letting creditcard information be returned to the merchant while a staged implementation of converting to Tokens/Billing IDs are being carried out.

Requirements/Downloads:
DPSEKX.dll ActiveX object VB Sample Project ASP Sample Code (Encrypt) ASP Sample Code (Decrypt) Coldfusion Sample Code (Encrypt) Coldfusion Sample Code (Decrypt)

Installation Instructions

Download the latest DPSEKX Active X kit and register it in any location with the following command - "Regsvr32 [path name]\DPSEKX.dll".

Filename	Description
DPSEKX.dll	ActiveX Component

Methods

DPSEKX.dll control offers the following method to decrypt data.

DoDecrypt

InputProperties

Parameter	Required	Description
Key	Yes	48 character Hexdecimal 3DES Key - obtain from DPS
EkData	Yes	The 15 character encrypted DpsBillingId string

Output Properties

Parameter	Description
CardNumber	Plain text card number
DateExpiry	Plain text expiry date
Success	Success of the decryption. True (1) or false (0)
ReCo	2 character response code indicating why the decryption hasn't worked

DoEncrypt

InputProperties

Parameter	Required	Description
CardNumber	Yes	Plain text card number
DateExpiry	Yes	Plain text expiry date

Output Properties

Parameter	Description
EkData	The 15 character encrypted DpsBillingId string
Success	Success of the decryption. True (1) or false (0)
ReCo	2 character response code indicating why the decryption hasn't worked

Properties

Key (input)Datatype: BSTR Max 48 characters

48 character Hexdecimal 3DES Key - obtained from DPS.

EkData (input) Datatype: BSTR Max 15 characters

15 characters with or without trailing spaces containing DpsBillinId returned by PXACCESS.

CardNumber (output) Datatype: BSTR Max 16 characters

Cardnumber in plain text.

DateExpiry (output) Datatype: BSTR Max 4 characters

Expiry Date in MMYY format.

Success (output) Datatype: BOOL true/false

Indicates if the decryption was successful or not. Either False (0) or True (1)

ReCo (output) Datatype: BSTR Max 4 characters

If the DoDecrypt function fails, the "Success" property will be set to false and "ReCo" will contain a reason code, which is detailed below.

Response Codes

Reco	Description
01	EkData length not 15 characters
02	EkData not a valid DpsBillingId
03	EkData Length not 15 characters
04	Invalid Key length
05	Wrong Key