Description
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).
As of today, Hamacq supports:
Nexo Acquirer V6 on port 15000
Nexo Acquirer V9 on port 15001 (partial)
Supported Messages
Nexo Acquirer 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 | |
Auth | 40.20 | Approved, Force CompletionRequired to | |
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 |
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 == “ | Total Amounts returned on variable precision instead of fixed 2 digits |