| HTTP Status | APTRA Code | Description | Developer Action | |-------------|------------|-------------|------------------| | 400 | NDC-1001 | Missing mandatory element (e.g., PTC ) | Validate request against JSON schema (provided in /schemas folder) | | 409 | NDC-2015 | Offer expired | Re-run AirShopping | | 402 | NDC-3010 | Payment authorization failed | tokenize card again or use different FOP | | 500 | NDC-8005 | Airline NDC gateway timeout | Implement retry with exponential backoff (max 3 retries) |
Define the new state letter or code in the NDC configuration initialization file.
Reports hardware health, sensor statuses, and card reader conditions.
The system's behavior is almost entirely defined by configuration parameters, which are stored in configuration files. This design allows you to modify functionality without recompiling core software, enabling rapid deployment of new features.
NCR’s platform software logs specific XFS errors that can pinpoint a failing hardware component. 6. Security Best Practices When developing for APTRA, security is not optional:
Dictates approval (e.g., 00 ) or specific rejection reasons (e.g., 51 for insufficient funds).
Ensure the XFS manager configuration ( xfs_conf.vbs or registry keys) defines the exact device names expected by your custom extension code.
: Specifically intended for technical personnel, software developers, and system integrators responsible for deploying or maintaining NCR's self-service solutions.
Anatomy of an NDC State (Example: State Type 'A' - Card Read)
Use a tool like Wireshark to inspect the NDC messages passing between the ATM and the Host.
