Description
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).
As of today, Hamacq supports Nexo Acquirer V5 and V6.
V9 might be added in the future.
Supported Messages
Nexo Acquirer V05
AcceptorAuthorisationRequestV05
AcceptorCompletionAdviceV05
AcceptorReconciliationRequestV05
AcceptorDiagnosticRequestV05
Nexo Acquirer V06
AcceptorAuthorisationRequestV06
AcceptorCompletionAdviceV06
AcceptorReconciliationRequestV06
AcceptorDiagnosticRequestV06
AcceptorCancellationAdviceV06
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 | 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 | 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 | 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 | 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 | 135.xx | Approved with ARC = xx, no IAD, no scripts | |
Auth | 136.xx | Approved with ARC = xx, IAD = | |
Auth | 666.99 | DO NOT USE, made to validate and solidify against possible external harmful behaviors. Subject to change at any moment, and will cause undefined behavior. | |
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 |
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 |