Example Transactions

Sale Transaction (Type 02) with Protegrity Universal Token (TV)

This sale transaction type is used to request Voltage Numeric Token (VN).

Request

0001,02<–Transaction Type–>
0002.50.50 <–Base Currency Transaction Amount–>
0003,ID:7248510956390312<–Token on request/Token on response–>
0004,1219 <-Credit Card Expiration Date->
0007,02210127 <-Reference Number ->
0017,25.00 <- Cash Back->
0025,082714 <- Business Date ->
0047,5;1;1;1;0;1;6;0;4;1;3;4;0;4* <- POS Data Code ->
0054,05* <- POS Entry Mode ->
0060,51563621 <- Unique Device ID/MasterCard land ID ->
0070,4180001 <- Customer Code ->
0071,1 <-Tax Included Indicator ->
0072,0.50 <- Tax Amount - >
0109,TERM1 <- Terminal ID ->
0110,101 <- Cashier ID ->
0115,030 <- Transaction Qualifier ->
0647,1 <- Partial Authorization Acceptance ->
1008,ID: <- Unique ID Field ->
5026,TV <-Token Type Provided ->
5027,VN <- Token Type Requested ->
8002,LOC1 <- Location Name ->
8006,CHAIN1 <- Chain Code ->

Response

0001,02 <– Transaction Type–>
0002.50.50 <–Base Currency Transaction Amount–>
0003,ID:1161329569969734<–Token on request/Token on response–>
0004,1219 <-Credit Card Expiration Date->
0006,002209 <- Approval Code ->
0007,02210127 <-Reference Number ->
0009,00 <- Batch Number->
0013,082714 <- Transaction Date->
0014,101422 <- Transaction Time ->
0017,25.00 <- Cash Back ->
0025,082714 <- Business Date ->
0030,1 <- Online Indicator ->
0032,122702 <- Original Transaction Date ->
0033,110245 <- Original Transaction Time ->
0034,N <- Authorization Characteristics Ind. ->
0035,00 <- Validation Code ->
0037,5 <- Authorizer ->
0038,00 <- MERIT Reason Code ->
0040,1 <- Compliance Field 1 ->
0041,Y <- Compliance Field 2 ->
0047,5;1;1;1;0;1;6;0;4;1;3;4;0;4* <- POS Data Code ->
0054,05* <- POS Entry Mode ->
0060,51563621 <- Unique Device ID/MasterCard land ID ->
0070,4180001 <- Customer Code ->
0071,1 <-Tax Included Indicator ->
0072,0.50 <- Tax Amount - > 0072,0.50
0109,TERM1 <- Terminal ID ->
0110,101 <- Cashier ID ->
0115,030 <- Transaction Qualifier ->
0125,000000000000 <- CPS Retrieval Reference Number ->
0126,2 <- Card Entry Indicator ->
0127, <- CPS Miscellaneous Data ->
0128,50.50 <- Original Authorization Amount ->
0130,50.50 <- Total Authorized Amount ->
0647,1 <- Partial Authorization Acceptance ->
1000,VI <- Card Type ->
1000,VISA <- Card Name ->
1002,Test Card 1 <- Cardholder Name -> 1003,0000 <- Gateway Response Code -> 1008,ID: <- Unique ID Field ->
5026,TV <-Token Type Provided ->
5027,VN <- Token Type Requested ->
8002,LOC1 <- Location Name ->
8006,CHAIN1 <- Chain Code ->
1004,APPROVAL 002209 <- Host Response Message ->
1005,999999999999 <- Merchant Number ->
1008,xxxxxxxxxxxx0038 <- Unique ID Field ->
1009,00 <- Host Response Code ->
1010,COMPLETE <- Gateway Response Message ->
5026,TV <- Token Type Provided ->
5027,VN <- Token Type Requested ->
7007,1114223661260032 <- Transaction Identifier ->
8002,LOC1 <- Location Name ->
8006,CHAIN1 <- Chain Code ->

Sale Transaction (Type 02) with PAN

This Sale Transaction Type is used to request a Voltage Numeric Token (VN).

Request
0001,02 <-Transaction Type ->
0002,50.50 <- Base Currency Transaction Amount ->
0003,4018XXXXXXXX1881 <- PAN on request/Token on response ->
0004,1219 <- Credit Card Expiration Date ->
0007,02210127 <- Reference Number ->
0017,25.00 <- Cash Back ->
0025,082714 <- Business Date ->
0047,5;1;1;1;0;1;6;0;4;1;3;4;0;4* <- POS Data Code ->
0054,05* <- POS Entry Mode ->
0060,51563621 <- Unique Device ID/MasterCard land ID
0070,4180001 <- Customer Code - >
0071,1 <- Tax Included Indicator - >
0072,0.50 <- Tax Amount ->
0109,TERM1 <- Terminal ID ->
0110,101 <- Cashier ID ->
0115,030 <- Transaction Qualifier ->
0647,1 <- Partial Authorization Acceptance ->
1008,ID: <- Unique ID Field ->
5027,VN <- Token Type Requested ->
8002,LOC1 <- Location Name ->
8006,CHAIN1 <- Chain Code ->

Response
0001,02 <- Transaction Type ->
0002,50.50 <- Base Currency Transaction Amount ->
0003,ID:1161329569969734 <- PAN on request/Token on response ->
0004,1219 <- Credit Card Expiration Date ->
0006,002209 <- Approval Code ->
0007,02210127 <- Reference Number ->
0009,00 <- Batch Number ->
0013,082714 <- Transaction Date ->
0014,101422 <- Transaction Time ->
0017,25.00 <- Cash Back ->
0025,082714 <- Business Date ->
0030,1 <- Online Indicator ->
0032,122702 <- Original Transaction Date ->
0033,110245 <- Original Transaction Time ->
0034,N <- Authorization Characteristics Ind. ->
0035,00 <- Validation Code -> br>
0037,5 <- Authorizer ->
0038,00 <- MERIT Reason Code ->
0040,1 <- Compliance Field 1 ->
0041,Y <- Compliance Field 2 ->
0047,5;1;1;1;0;1;6;0;4;1;3;4;0;4 <- POS Data Code ->
0054,05 <- POS Entry Mode ->
0060,51563621 <- Unique Device ID/MasterCard land ID ->
0070,4180001 <- Customer Code ->
0071,1 <- Tax Included Indicator ->
0072,0.50 <- Tax Amount ->
0109,TERM1 <- Terminal ID ->
0110,101 <- Cashier ID ->
0115,030 <- Transaction Qualifier ->
0125,000000000000 <- CPS Retrieval Reference Number ->
0126,2 <- Card Entry Indicator ->
0127, <- CPS Miscellaneous Data ->
0128,50.50 <- Original Authorization Amount ->
0130,50.50 <- Total Authorized Amount ->
0647,1 <- Partial Authorization Acceptance ->
1000,VI <- Card Type ->
1001, VISA <- Card Name ->
1002, Test Card 1 <- Cardholder Name ->
1003,0000 <- Gateway Response Code ->
1004,APPROVAL 002209 <- Host Response Message ->
1005,999999999999 <- Merchant Number ->
1008,xxxxxxxxxxxx0038 <- 1008,ID: Unique ID Field ->
1009,00 <- Host Response Code ->
1010,COMPLETE <- Gateway Response Message ->
5027,VN <- Token Type Requested ->
7007,1114223661260031 <- Transaction Identifier ->
8002,LOC1 <- Location Name -> 8006,CHAIN1 <- Chain Code ->

note

*This field is not required for transactions through Simplify.

Token Request Transaction (Type 37)

Request
0001,37 <- Transaction Type ->
0003,4018XXXXXXXX1881 <- PAN on request / Token on response ->
0007,12140924 <- Reference Number ->
0109,TERM1 <- Terminal ID ->
0110,CASHIER <- Cashier ID ->
0115,010 <- Transaction Qualifier ->
1008,ID: <- Unique ID Field ->
5027,VN <- Token Type Requested ->
8002,LOC1 <- Location Name ->
8006,CHAIN1 <- Chain Code ->

Response
0001,37 <- Transaction Type ->
0003,ID:1161329569969734 <- PAN on request / Token on response ->
0007,12140924 <- Reference Number ->
0109,TERM1 <- Terminal ID ->
0110,CASHIER <- Cashier ID ->
0115,010 <- Transaction Qualifier ->
1000,VI <- Card Type ->
1001,VISA <- Card Name ->
1003,0000 <- Gateway Response Code ->
10004,ACKNOWLEDGED <- Host Response Text ->
1008,xxxxxxxxxxxx1881 <- Unique ID Field ->
1010,COMPLETE <- Gateway Response Message ->
5027,VN <- Token Type Requested ->
7007,1114223661260033 <- Transaction Identifier ->
8002,LOC1 <- Location Name ->
8006,CHAIN1 <- Chain Code ->

Card Request Transaction (Type 38)

Request
0001,38 <- Transaction Type ->
0003, ID:1161329569969734 <- Token on request / PAN on response ->
0007,12140928 <- Reference Number ->
0109,TERM1 <- Terminal ID ->
0110,CASHIER <- Cashier ID ->
0115,010 <- Transaction Qualifier ->
1008,ID: <- Unique ID Field* ->
5026,TV <- Token Type Provided ->
8002,LOC1 <- Location Name -> 8006,CHAIN1 <- Chain Code ->

Response
0001,38 <- Transaction Type ->
0003, 4018XXXXXXXX1881 <- Token on request / PAN on response ->
0007,12140928 <- Reference Number ->
0109,TERM1 <- Terminal ID ->
0110,CASHIER <- Cashier ID ->
0115,010 <- Transaction Qualifier ->
1003,0000 <- Gateway Response Code ->
1004 <- Host Response Text ->
1003,0000 <- Gateway Response Code ->
1004 <- Host Response Text ->
1008, ID:1178912355232190 <- Unique ID Field* -> 1010,COMPLETE <- Gateway Response Message -> 5026,TV <- Token Type Provided ->
5027,VN <- Token Type Requested ->
7007, 1114223661260034 <- Transaction Identifier ->
8002,LOC1 <- Location Name -> 8006,CHAIN1 <- Chain Code ->

note

On a tran type 38, the token is returned in field 1008 and can be in a different token format than what was originally provided.