Changes for page Payment Service Provider API ISO 8583:1993 (IFSF) H2H description
Last modified by Bjørnar Ruud on 2021/03/18 10:47
From version 30.18
edited by Pål-Eirik Askerød
on 2017/11/02 14:46
on 2017/11/02 14:46
To version 30.19
edited by Pål-Eirik Askerød
on 2017/11/03 13:46
on 2017/11/03 13:46
Change comment: There is no comment for this version
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -2,7 +2,7 @@ 2 2 ((( 3 3 = Overview = 4 4 5 -The purpose of the H2H PayEx link is to enable authorization and settlementof card transactions, where PayEx is end host for that card, or just an PSP. The third party host acts as a gateway in between payment terminals and PayEx.5 +The purpose of the H2H PayEx link is to enable authorization and capture of card transactions, where PayEx is end host for that card, or just an PSP. The third party host acts as a gateway in between payment terminals and PayEx. 6 6 7 7 8 8 [[image:pos server.png]] ... ... @@ -121,9 +121,9 @@ 121 121 30323135 122 122 )))|15 123 123 124 -The PayEx response timeout is set to 3 0seconds. If after 30+1 seconds, no response has been received, the third party host needs to take the appropriate action based on the message type. (E.g. send a reversal)124 +The PayEx response timeout is set to 35 seconds. If after 35+1 seconds, no response has been received, the third party host needs to take the appropriate action based on the message type. (E.g. send a reversal) 125 125 126 -The third party host has the possibility to perform offline stand-in, thought this needs to be agreed with the indi didual card issuers. Otherwise the station might not be reimbursed.126 +The third party host has the possibility to perform offline stand-in, thought this needs to be agreed with the individual card issuers. Otherwise the station might not be reimbursed. 127 127 128 128 == == 129 129 ... ... @@ -178,37 +178,6 @@ 178 178 179 179 A series of codes intended to identify terminal capability, terminal environment and presentation security data. 180 180 181 -|=Point of service date code|=Description 182 -|POS 1: Card data input capabilities|2: magnetic stripe read A: RFID 183 -B: Magnetic stripe reader and key entry 184 -C: Magnetic stripe reader, ICC and key entry 185 -D: Magnetic stripe reader and ICC 186 -|Pos 2: Cardholder authentication capability|1: PIN 187 -Y: Signature,plaintext/enciphered PIN offline and ‘no cvm’ capable, enciphered pin online 188 -|Pos 3: Card capture capability|0:None 189 -T: None and SDA/DDA/CDA capable 190 -|Pos 4: Operating environment|((( 191 -1: On premises of card acceptor, attended 192 -2: On premises of card acceptor, unattended 193 -))) 194 -|Pos 5: Cardholder present|0: Cardholder present 195 -|Pos 6: Card present|1: Card present 196 -|Pos 7: Card data input mode|2: Magnetic stripe read 197 -3: Bar code 198 -5: ICC 199 -6: Key entered A: RFID 200 -D: Magnetic stripe read following failed chip card read 201 -|Pos 8: Cardholder authentication method|0: Not authenticated 202 -1: PIN 203 -5: Manual signature verification 204 -|Pos 9: Cardholder authentication entity|0: Not authenticated 205 -1: ICC 206 -2: Card acceptor device 3: Authorizing Agent 207 -|Pos 10: Card data output capability|1: None 208 -3: ICC 209 -|Pos 11: Terminal output capability|2: Printing 210 -4: Printing and display 211 -|Pos 12: PIN capture capability|C: Twelve characters 212 212 213 213 **P-24 FUNCTION CODE** 214 214 ... ... @@ -223,7 +223,7 @@ 223 223 **P-25 MESSAGE REASON CODE** 224 224 225 225 |=reason code |=Description 226 -|1003|Card issuer una bailable195 +|1003|Card issuer unavailable 227 227 |1004|Terminal processed 228 228 |1508|On-line forced by terminal 229 229 |4000|Customer cancellation ... ... @@ -288,41 +288,27 @@ 288 288 289 289 **P-48-8-2 TYPE OF CUSTOMER DATA** 290 290 291 -1 - Vehicle Number260 +1 - Vehicle ID 292 292 3 - Driver ID 293 293 4 - Mileage 294 -5 - Driver license number 295 -B - Unit number/fleet ID 296 -D - Customer verification code 297 -G - Alphanumeric entered data 263 + 298 298 299 -The information encoded on track 2 of the magnetic stripe as defined in ISO7813, excluding beginning and ending sentinels and longitudinal redundancy check characters. 300 - 301 - 302 302 **P-48-9 TRACK II OF VEHICLE CARD** 303 303 267 +Used to specify the second card in a transaction if a special card is needed in addition to the payment card to link a transaction to a loyalty account. 304 304 269 + 305 305 **P-48-14 PIN ENCRYPTION METHODOLOGY** 306 306 307 307 See [[security documentation>>doc:.PayEx IFSF H2H Security specification.WebHome]] section for details. 308 308 309 309 310 -**P-48-32 VAT PERCENTAGES** 311 - 312 -List of VAT codes accompanied with their corresponding VAT percentage. 313 - 314 -The purpose of this field is to link the VAT codes as used in field P-63 Product data, P-63-8 tax code, to actual VAT percentages. As the incoming link can be multi-country, and PayEx does not have product codes per VAT rate, the VAT rates need to be provided in every transaction. 315 - 316 -Individual items are separated with a backslash character. 317 -Only VAT codes used in the product data (P-63) need to be described in this array. Others will be ignored. 318 - 319 - 320 320 **P-48-37 VEHICLE IDENTIFICATION ENTRY MODE** 321 321 Only present when a vehicle number is available (P48-8). Defines how the vehicle number was entered: 322 322 323 323 0 - Manual entry 324 324 1- On the Card 325 -2 - Automatic Licen ce Plate Recognition280 +2 - Automatic License Plate Recognition 326 326 327 327 328 328 **P-48-38 PUMP LINKED INDICATOR** ... ... @@ -342,7 +342,6 @@ 342 342 343 343 344 344 **P-52 PIN DATA** 345 -ISO 9564-1 format 0 PIN block encrypted with PIN encryption key. 346 346 347 347 See[[ security documentation>>doc:.PayEx IFSF H2H Security specification.WebHome]] section for details. 348 348 ... ... @@ -355,8 +355,8 @@ 355 355 **P-56 ORIGINAL DATA ELEMENTS** 356 356 357 357 Data elements of original transaction which contains the original “message identifier”, original “STAN” and original “date and time – local transaction”. This must be present if the message is preceded by an 1100 Authorisation Request, it can be omitted if the message is as a result of a store and forward transaction. 358 -In Payment advice : Link to previous Authori sation dialog359 -In reversal advice sation request or previous Payment request being reversed.312 +In Payment advice : Link to previous Authorization dialog 313 +In reversal advice : Link to previous Authorization request or previous Payment request being reversed. 360 360 361 361 362 362 **P-62 PRODUCT SETS AND MESSAGE DATA** ... ... @@ -376,7 +376,7 @@ 376 376 377 377 This data element provides the detailed information on the products purchased or selected by the customer. The first two fields (63-1, 63-2) appear once per transaction. The next seven fields can be repeated up to 18 times. 378 378 379 -Each product is represented by seven fields: Product Code, Unit of Measure, Quantity, Unit Price, Amount, Taxcode and Additional product code. The variable length fields and the succeeding entry are separated by a back-slash (\). 333 +Each product is represented by seven fields: Product Code, Unit of Measure, Quantity, Unit Price, Amount, Tax code and Additional product code. The variable length fields and the succeeding entry are separated by a back-slash (\). 380 380 Unit price and amount may be negative or positive, but the sum of the amounts in the product data must equal the transaction amount. 381 381 The values of Quantity and Unit price may have a value that includes both integer and fractional values. The format of these fields consists of a single digit, which specifies the number of fractional digits following the integer, followed by the numeric value. 382 382 The value must be numeric. The number of fractional digits has a maximum of 4. The Amount field may have fractional digits. The number of fractional digits is specified by the currency code. ... ... @@ -412,8 +412,6 @@ 412 412 413 413 **P-64 MAC** 414 414 415 -MAC is calculated/verified according to the “ANS X9.9 Option 1 (binary data) procedure using ISO 16609 CBC-mode Triple-DES”. 416 - 417 417 See [[security documentation>>doc:.PayEx IFSF H2H Security specification.WebHome]] for details. 418 418 419 419 ... ... @@ -424,8 +424,6 @@ 424 424 425 425 **P-128 MAC** 426 426 427 - MACiscalculated/verifiedaccordingto the“ANSX9.9 Option1(binary data) procedureusingISO16609CBC-modeTriple-DES”.379 +**This field is used for MAC if P-127 is present**. See [[security documentation>>doc:.PayEx IFSF H2H Security specification.WebHome]] for details. 428 428 429 -This field is used for MAC if P-127 is present. See [[security documentation>>doc:.PayEx IFSF H2H Security specification.WebHome]] for details. 430 - 431 431