...
Hamacq is a development-focused Acquirer endpoint. It is currently hosted on fbe-host.ca on port 15000. It was created to allow in-house testing and validation, mostly for L3 (Arkos).
| Note |
|---|
As of today, Hamacq supports: |
Supported Messages
Nexo Acquirer
...
AcceptorAuthorisationRequestV05
AcceptorCompletionAdviceV05
AcceptorReconciliationRequestV05
...
V06
AcceptorAuthorisationRequestV06
AcceptorCompletionAdviceV06
AcceptorReconciliationRequestV06
AcceptorDiagnosticRequestV06
AcceptorCancellationRequestV06
AcceptorCancellationAdviceV06
AcceptorCurrencyConversionRequestV04
Nexo Acquirer
...
V09
AcceptorDiagnosticRequestV08
...
AcceptorAuthorisationRequestV09
...
AcceptorCompletionAdviceV09
...
AcceptorReconciliationRequestV08
...
AcceptorCancellationRequestV09
...
AcceptorCancellationAdviceV09
Special Behavior
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
...
6.17, 106.17
...
Approved + Set Balance (CAN, 0.00)
...
Auth
...
6.18, 106.18
...
Approved + Set Balance (CAN, +0.00)
...
Auth
...
6.19, 106.19
...
Approved + Set Balance (CAN, -0.00)
...
Auth
...
6.21, 106.21
...
Partial Approved (4.20) + Set Balance (CAN, +2.00)
...
Auth
...
6.22, 106.22
...
Partial Approved (4.20) + Set Balance (CAN, -1.50)
...
Auth
...
6.23, 106.23
...
Partial Approved (4.20) + Set Balance (CAN, 0.00)
...
Auth
...
18.95
...
Approved + ICC Related data Tags (8A, 91, 71, 72)
...
Auth
...
19.95
...
Declined + ICC Related data Tags (71)
...
Auth
...
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
...
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
...
123.08 - 123.16
...
Approved + ICC Related data Tags (91), Zero-filled, length = pennies
...
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
...
666.66
...
Approved with Action (Display, CardholderReceipt) displaying available funds
...
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
...
135.xx
...
Approved with ARC = xx, no IAD, no scripts
...
Auth
...
136.xx
...
Approved with ARC = xx, IAD = 226622337733448844559955, no scripts
...
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
...
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