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, with V8 planned. There are no planned development to implement other protocols.
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 | Declined | |
Auth | 10.20 | Declined with Reason | |
Auth | 10.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 | Approved, Balance (CAN, +8.02) | |
Auth | 6.12 | Approved, Balance (CAN, -8.02) | |
Auth | 6.13 | Approved, Balance (CAN, 8.02, implicit sign) | |
Auth | 6.14 | Declined, Balance (CAN, +8.02) | |
Auth | 6.15 | Declined + Set Balance (CAN, -8.02) | |
Auth | 6.16 | Declined + Set Balance (CAN, 0.08) | |
Auth | 6.17 | Approved + Set Balance (CAN, 0.00) | |
Auth | 6.18 | Approved + Set Balance (CAN, +0.00) | |
Auth | 6.19 | Approved + Set Balance (CAN, -0.00) | |
Auth | 6.21 | Partial Approved (4.20) + Set Balance (CAN, +2.00) | |
Auth | 6.22 | Partial Approved (4.20) + Set Balance (CAN, -1.50) | |
Auth | 6.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 | Approved + No ICC related data | |
Auth | 22.95 | Approved + ICC Related data Tags (91) | |
Auth | 123.08 - 123.16 | Approved + ICC Related data Tags (91), Zero-filled, length = pennies | |
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 |
Compl | 28.93 | Forced Failure (no response) unless ReTransmissionCounter = 10 | Conditional |
Compl | 28.94 | Forced failure | No response |
Cancel (req) | 99.12 | Forced Failure (no response) | No response |