Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Hamacq is a development-focused Acquirer endpoint. It is currently hosted on fbe-host.ca. It was created to allow in-house testing and validation, mostly for L3 (Arkos).

Note

As of today, Hamacq supports:
Nexo Acquirer V6 on port , hosted at fbe-host.ca:15000
Nexo Acquirer V9 on port , hosted at fbe-host.ca:15001 (partial)

Supported Messages

...

Some specific transaction amounts trigger predefined behaviors on requests.

Here is an exhaustive list:

...

Request

...

Amount

...

Behavior

...

Note

...

Auth

...

10.10, 110.10

...

Declined

...

Auth

...

10.20, 110.20

...

Declined with Reason

...

Auth

...

10.30, 110.30

...

Declined with Reason and AdditionalInformation

...

Auth

...

40.10

...

Approved, Force CompletionRequired to true

...

Auth

...

40.20

...

Approved, Force CompletionRequired to false

...

Auth

...

50.10

...

Approved, Set TMSTrigger (ANY, ASAP, no DateTime)

...

Auth

...

6.11, 106.11

...

Approved, Balance (CAN, +8.02)

...

Auth

...

6.12, 106.12

...

Approved, Balance (CAN, -8.02)

...

Auth

...

6.13, 106.13

...

Approved, Balance (CAN, 8.02, implicit sign)

...

Auth

...

6.14, 106.14

...

Declined, Balance (CAN, +8.02)

...

Auth

...

6.15, 106.15

...

Declined + Set Balance (CAN, -8.02)

...

Auth

...

6.16, 106.16

...

Declined + Set Balance (CAN, 0.08)

...

Auth

...

18.95

...

Approved + ICC Related data Tags (8A, 91, 71, 72)

...

Auth

...

19.95

...

Declined + ICC Related data Tags (71)

...

Auth

...

3.45, 13.56, 20.95

...

Declined + ICC Related data Tags (8A = 3035)

...

Auth

...

20.94

...

Declined + ICC Related data Tags (8A = 3635)

...

Auth

...

21.95, 121.95

...

Approved + No ICC related data

...

Auth

...

22.95, 122.95

...

Approved + ICC Related data Tags (91)

...

Auth

...

33.00

...

Approved + Script71 + IAD (for AXP EMV 004)

...

Auth

...

34.00

...

Approved + Script72 + IAD (for AXP EMV 005)

...

Auth

...

42.17

...

Declined + Action (FallForward)

...

Auth

...

42.18

...

Declined + Action (PINRetry)

...

Auth

...

42.19

...

Declined + Action (PINLastTry)

...

Auth

...

42.20

...

Declined + Action (IdentificationRequired)

...

Auth

...

42.21

...

Declined + Action (ForbidOverride)

...

Auth

...

42.22

...

Declined + Actions [ForbidOverride, Display(CardholderDisplay), FallForward]

...

Auth

...

42.23

...

Approved + Actions [MerchantPrint, MerchantDisplay, CardholderPrint, CardholderDisplay]

...

Auth

...

42.24

...

Declined + Action (PINRequest)

...

Auth

...

42.25

...

Declined + Action (ConsumerDeviceCVM)

...

Auth

...

42.26

...

Declined + Action (CarhdolderAuthentication)

...

Auth

...

122.96

...

Approved with ARC=3030, with IAD, no issuer script

...

Auth

...

122.97

...

Approved with ARC=3031, with IAD, no issuer script

...

Auth

...

122.98

...

Approved with ARC=3030, no IAD, no issuer script

...

Auth

...

122.99

...

Approved with ARC=3031, no IAD, no issuer script

...

Auth

...

90.00

...

Forced System Error

...

No response

...

Auth

...

90.91

...

Approved after 120 sec delay

...

For timeout

...

Auth

...

99.01

...

Forced Unable to Process

...

Error response

...

Auth

...

99.02

...

Forced Invalid Message

...

Error response

...

Auth

...

99.03

...

Forced Parsing Error

...

Error response

...

Auth

...

99.04

...

Forced Security Error

...

Error response

...

Auth

...

99.05

...

Forced Initiating Party Error

...

Error response

...

Auth

...

99.06

...

Forced Recipient Party Error

...

Error response

...

Auth

...

99.07

...

Forced Duplicate Message Error

...

Error response

...

Auth

...

99.08

...

Forced Protocol Version Error

...

Error response

...

Auth

...

117.71

...

Approved with multiple Optional fields

...

Auth

...

132.01

...

If Contactless: Decline + Action [FallForward]

...

Conditional

...

Auth

...

132.02

...

If No Offline PIN performed: Decline + Action [PINRequest]

...

Conditional

...

Auth

...

132.03

...

If No CVM performed: Decline + Action [CardholderAuthentication]

...

Conditional

...

Auth

...

132.04

...

If No Password performed: Decline + Action [ConsumerDeviceCVM]

...

Conditional

...

Auth

...

132.05

...

If No Password performed: Decline + Action [CardholderAuthentication]

...

Conditional

...

Auth

...

175.01

...

Partial Approval, amount = 25.01

...

Request

...

Amount

...

Behavior

...

Note

...

Compl

...

228.93

...

Forced Failure (no response) unless ReTransmissionCounter = 10

...

Conditional

...

Compl

...

228.94

...

Forced failure

...

No response

...

Compl

...

229.xx

...

Forced failure

...

No response
Range to allow easier validation of ReTransmissionCounter

...

Request

...

Amount

...

Behavior

...

Note

...

Cancel (req)

...

99.12

...

Forced Failure (no response)

...

No response

...

Cancel (req)

...

99.13

...

Fails if RecipientTransactionIdentification is not present in the OriginalTransaction field

...

Conditional Decline

...

Cancel (req)

...

99.14

...

Fails if SaleReferenceIdentification is not present in the Transaction field

...

Conditional Decline

Special Cases

...

Request

...

Selector

...

Behavior

...

Note

...

Auth

...

Request’s RecipientParty.Identification == “ACQ-REC-AMOUNT-TEST-01"

...

The list of active behaviors can be queried directly from the running server by requesting http://fbe-host.ca:12300/behaviors