TransForm P2PE

Document created by matthew.milner on May 10, 2016Last modified by Chris Jennings on Jun 1, 2016
Version 3Show Document
  • View in full screen mode

Get more secure payment processing with point-to-point encryption (P2PE) provided through devices from industry leading hardware manufacturers. Express maximizes card data protection and transaction security from the point of swipe all the way to authorization. All of our EMV capable devices support P2PE as well. This document provides information on using an encrypted device via a direct integration with the Express processing platform.

 

Developers Need To Know

  1. The device must be encrypted with an Express encryption key, and depending on your integration method, may or may not support keyboard-emulation.
  2. Encrypted Swiped/Keyed Data and Card Data Key Serial Number alpha characters should be capitalized when submitted to the Express platform.

 

Input Fields

Name

Value

I/O

Max

Object

Description

EncryptedTrack1Data

String

I

300

Card

Encrypted Track 1 data

EncryptedTrack2Data

String

I

200

Card

Encrypted Track 2 data

EncryptedCardData

String

I

200

Card

Encrypted card (keyed) data

CardDataKeySerialNumber

String

I

26

Card

Card data key serial number

EncryptedFormat

Enum

I

2

Card

Terminal encryption format:

XML input/SOAP input (description)

** 0/Default (Default)

** 1/Format1 (MagTek)

** 2/Format2 (IngenicoDPP)

** 3/Format3 (IngenicoOn-Guard)

** 4/Format4 (ID Tech)

** 5/Format5 (VerifoneVxdevices)

** 6/Format6 (IPC devices)

** 7/Format7 (VerifoneMxdevices)

TerminalSerialNumber

String

I

40

Terminal

Device serial number

 

Field Names and Attributes

Note  All fields are listed for clarity.  If a field is not used, it need not be present in the XML.

 

Field Name

Attributes

DvcMsg

Ver= Device Message Version

Dvc

App= Application Name

AppVer= Application Version

DvcType= Device Type

DvcSN= Device Serial Number

Entry=CardEntryMethod(SWIPE, MANUAL, ...)

Card

ETrk1= Encrypted Track 1

ETrk2= Encrypted Track 2

ECData= Encrypted Card Data (Card Number=ExpDate=Security Code)

CDataKSN= Card Data KSN

DbtPINB= Debit PIN

DbtKSN= Debit KSN

MskPAN= Masked PAN

Exp= Expiration Date

CHolder= Cardholder Name

EFormat= Encrypted Format

Addr

AVSAddr= AVS Address

AVSZip= AVSZipcode

Tran

TranType= (CREDIT, DEBIT, ...)

Amt= Amount

TipAmt= Tip Amount

SigCap= Signature Capture (Base64 encoded)

CashBackAmt= Cash Back Amount

 

XML Example - Credit Card Swipe

<DvcMsg Ver=”1.2”> 
<Dvc   
App=”EDGE”  
AppVer=”2.2”  
DvcType = “ElementPinPad”  
DvcSN=”002044004256” Entry=”SWIPE”> 
</Dvc> 
<Card  
ETrk2=” F753F933E3C1177DAA0BF09270365E1FE58C265E97EF44C752C3D94A3CA97471A371A95563C916DA” 
CDataKSN=” A08B000C0000002000E6”  
MskPAN="4003********6781"  
CHolder="GLOBAL PAYMENTS TEST CARD/”> 
</Card> 
<Tran  
TranType=”CREDIT”  
TipAmt=”5.52”> 
</Tran> 
</DvcMsg> 
CrLf 

 

XML Example - Credit Card Manually Keyed

<DvcMsg Ver=”1.2”> 
<Dvc   
App=”EDGE”  
AppVer=”2.2”  
DvcType = “ElementPinPad”  
DvcSN=”002044004256”  
Entry=”MANUAL”> 
</Dvc> 
<Card   
ECData=” D7DBAD35858E484D0CC7FF3DE0914CE4426B08FB04455B4D210F45C75AA1727CD58026F4333640E11244AA13C1D4B2F2”  
CDataKSN=”A08B000C0000002000E6”  
Exp=”1012”  
MskPAN="4003********6781"  
CHolder="GLOBAL PAYMENTS TEST CARD/"   
DbtPINB =””  
DbtKSN=””> 
</Card> 
<Addr  
AVSAddr=”123”  
AVSZip=”91111”> 
</Addr> 
<Tran  
TranType=”CREDIT”  
TipAmt=”5.52”> 
</Tran> 
</DvcMsg> 
CrLf 

 

XML Example - Debit Card Swipe

<DvcMsg Ver=”1.2”> 
<Dvc   
App=”EDGE”  
AppVer=”2.2”  
DvcType = “ElementPinPad”  
DvcSN=”002044004256”  
Entry=”SWIPE”> 
</Dvc> 
<Card   
ETrk2=” F753F933E3C1177DAA0BF09270365E1FE58C265E97EF44C752C3D94A3CA97471A371A95563C916DA”  
CDataKSN=”A08B000C0000002000E6”  
Exp=”1012”  
MskPAN="4003********6781"  
CHolder="GLOBAL PAYMENTS TEST CARD/"   
DbtPINB =” 785AB86460106585”  
DbtKSN=” FFFF3D0100000480002F”> 
</Card> 
<Tran  
TranType=”DEBIT”  
TipAmt=”5.52”> 
</Tran> 
</DvcMsg> 
CrLf 

 

Mapping from XML to Express Interface Specification Fields

 

Transaction Type

XML

ExpressPayfield

Credit Card Swipe

ETrk1

OR

ETrk2

EncryptedTrack1Data

OR

EncryptedTrack2Data

CDataKSN

CardDataKeySerialNumber

EFormat

EncryptedFormat

DvcSN

TerminalSerialNumber

Credit Card Manually Keyed

ECData

EncryptedCardData

CDataKSN

CardDataKeySerialNumber

EFormat

EncryptedFormat

DvcSN

TerminalSerialNumber

Debit Card Swipe

ETrk2

EncryptedTrack2Data

CDataKSN

CardDataKeySerialNumber

EFormat

EncryptedFormat

DbtPINB

PINBlock

DbtKSN

KeySerialNumber

DvcSN

TerminalSerialNumber

1 person found this helpful

Attachments

    Outcomes