Payment Service provider API ISO8583_2 ( IFSF) H2H description

Version 3.1 by Kristian Lingsom on 2017/10/13 14:23

Data element name

INDOOR TRANSACTIONS

​​​​​​​FINANCIAL TRANSACTION REQUEST 1200

Fields not described on the below table are not supported by PayEx

Element number

Data element name

Presence

Format

Type

Size

Usage notes

2

PAN

C

LL

ans

..19

Present if manual PAN key entry.

3

Processing Code

M

 

n

6

 

4

Amount, transaction

M

 

n

12

 

7

Date and time, transmission

M

MMDDh

hmmss

n

10

 

11

Systems trace audit number

M

 

n

6

Assigned by third party host

12

Date and time, local transaction

M

YYMMD

Dhhmms s

n

12

 

14

Date expiry

C

YYMM

n

4

Only present for manual PAN keyentry.

22

Point of service data code

M

 

an

12

 

24

Function code

M

 

n

3

 

25

Message reason code

M

 

n

4

 

26

Card acceptor business code

M

 

n

4

5541 for indoor and 5542 for outdoor.

32

Acquiring institution identification

code

M

LL

n

..11

Contains ISO country code.

33

Forwarding Institution identification code

O

LL

n

..11

Required in concentrator model

35

Track 2 data

C

LL

ns

..37

Mandatory unless it’s a pan key entry transaction

41

Card acceptor terminal identification

M

 

ans

8

 

42

Card acceptor identification code

M

 

ans

15

8 digit number assigned by PayEx

43

Card acceptor name / location

M

 

ans

..999

 

48

Message control data elements

M

LLL

ans

..999

 

48-0

Bit map

M

 

b

8

 

48-4

Batch/sequence number

M

 

n

10

Assigned by 3rd party

48-8

Customer data

C

LLL

ans

..250

Only present if customer data entered.  As specified in [1]

48-9

Track II of vehicle card

O

LL

ns

..37

 

48-14

PIN Encryption Methodology

C

 

ans

2

Mandatory if online PIN, and must have value 33.

48-32

VAT Percentages

M

LL

ans

..91

 

48-37

Vehicle identification entry mode

O

 

ans

1

 

48-38

Pump linked indicator

O

 

n

1

 

48-39

Delivery note number

O

 

n

10

POS ticket number

49

Currency code, transaction

M

 

an

3

 

52

PIN Data

C

 

b

8

Only for Online PIN

53

Security Related Control Information

M

LL

b

..48

 

59

Transport Data

M

LLL

ans

..999

63

Product data

M

LLL

ans

..999

 

64

MAC

M

 

b

8

 

​​​​​​​FINANCIAL TRANSACTION RESPONSE 1210

The following fieds listed below are supported in the response message. Fields not listed are not supported.

Element number

Data element name

Presence

Format

Type

Size

Usage notes

3

Processing Code

ME

 

n

6

 

4

Amount, transaction

M

 

n

12

 

7

Date and time, transmission

M

MMDDh

hmmss

n

10

 

11

Systems trace audit number

ME

 

n

6

 

12

Date and time, local transaction

ME

YYMMD

Dhhmm ss

n

12

 

32

Acquiring institution identification code

ME

LL

n

..11

 

38

Approval code

C

 

anp

6

Present if transaction

approved

39

Action code

M

 

n

3

 

41

Card acceptor terminal identification

ME

 

ans

8

 

42

Card acceptor identification code

ME

 

ans

15

 

48

Message control data elements

M

LLL

ans

..999

 

48-0

Bit map

M

 

b

8

 

48-4

Batch/sequence number

ME

 

n

10

 

49

Currency code, transaction

ME

 

an

3

 

53

Security Releated Control Info

M

LL

b

..48

 

59

Transport Data

ME

LLL

ans

..999

62

Product sets

C

LLL

ans

..999

 

62-1

Allowed product sets

C

LL

ans

..99

 

62-2

Device type

O

 

n

1

 

62-3

Message text

O

LLL

ans

..894

 

64

MAC

M

 

b

8

 

 

​​​​​​​FINANCIAL TRANSACTION ADVICE 1220/1221

Fields not described on the below table are not supported by OASE.

Element number

Data element name

Presence

Format

Type

Size

Usage notes

2

PAN

C

LL

ans

..19

Present if manual PAN key entry

3

Processing Code

M

 

n

6

 

4

Amount, transaction

M

 

n

12

 

7

Date and time, transmission

M

MMDDh

hmmss

n

10

 

11

Systems trace audit number

M

 

n

6

Assigned by third party host

12

Date and time, local transaction

M

YYMMD

Dhhmms s

n

12

 

14

Date expiry

C

YYMM

n

4

Present if manual PAN key entry

22

Point of service data code

M

 

an

12

 

24

Function code

M

 

n

3

Fixed 200: Original Financial Transaction Advice

25

Message reason code

M

 

n

4

1003: Card Issuer

Unavailable

6

Card acceptor business code

M

 

n

4

5541 for indoor and 5542 for outdoor.

32

Acquiring institution identification code

M

LL

n

..11

Contains ISO country code

33

Forwarding Institution identification code

O

LL

n

..11

Required in concentrator model

35

Track 2 data

C

LL

ns

..37

 

38

Approval Code

M

 

anp

6

Fixed 000000

39

Action Code

M

 

n

3

Fixed 000

41

Card acceptor terminal identification

M

 

ans

8

 

42

Card acceptor identification code

M

 

ans

15

 

43

Card acceptor name / location

M

 

ans

..999

 

48

Message control data elements

M

LLL

ans

..999

 

48-0

Bit map

M

 

b

8

 

48-4

Batch/sequence number

M

 

n

10

Assigned by third party host

48-8

Customer data

C

LLL

ans

..250

 

48-9

Track II of vehicle card

O

 

ns

..37

 

48-32

VAT Percentages

M

LL

ans

..91

 

48-37

Vehicle identification entry mode

O

 

ans

1

 

48-38

Pump linked indicator

O

 

n

1

 

48-39

Delivery note number

O

 

n

10

POS ticket number

49

Currency code, transaction

M

 

an

3

 

53

Security Related Control Information

M

LL

b

..48

 

59

Transport data

M

LLL

ans

..999

63

Product data

M

LLL

ans

..999

 

64

MAC

M

 

b

8

 

 

 

​​​​​FINANCIAL TRANSACTION ADVICE RESPONSE 1230

The following fields listed below are supported in the response message. Fields not listed are not supported.

Element number

Data element name

Presence

Format

Type

Size

Usage notes

3

Processing Code

ME

 

n

6

 

4

Amount, transaction

ME

 

n

12

 

7

Date and time, transmission

M

MMDDh

hmmss

n

10

 

11

Systems trace audit number

ME

 

n

6

 

12

Date and time, local transaction

ME

YYMMD

Dhhmm ss

n

12

 

32

Acquiring institution identification code

ME

LL

n

..11

 

38

Approval code

ME

 

anp

6

 

39

Action code

M

 

n

3

Fixed 000: Approved

41

Card acceptor terminal identification

ME

 

ans

8

 

42

Card acceptor identification code

ME

 

ans

15

 

48

Message control data elements

M

LLL

ans

..999

 

48-0

Bit map

M

 

b

8

 

48-4

Batch/sequence number

ME

 

n

10

 

49

Currency code, transaction

ME

 

an

3

 

53

Security Related Control Information

M

LL

b

..48

 

59

Transport Data

ME

LLL

ans

..999

64

MAC

M

 

b

8

 

Note: For technical reasons an advice can be declined. In this case the third party host need to retry the advice until manual intervention or the advice has been accepted.

 

Tags:
Created by Kristian Lingsom on 2017/10/13 14:13