Developer Portal

6 Appendix D: File Validation and Processing

6.1 Validation

There are three major types of validation errors

  • Field invalid – A field does not meet formatting requirements.
  • Missing Field – A required field is missing.
  • Wrong Source (Cashbox) – Incorrect Source ID.

Field Invalid

Missing Field

Incorrect Source ID (Cashbox)

Email Result

File 022-CC-token-single-wrong source has encountered errors: line 2: 
"CCSaleToken;22;010000344;1;120000;0;123;456;789" Cashbox Not Found 

 

6.2 Processing

After submission, the file is validated so that it can be cleared for processing.  The submission request is returned after file validation is complete.

After <N> or more validation errors are encountered, file validation is halted and the errors are returned.   <N> is a Payway system configuration currently set at 10.

For each error encountered the following information is returned:

  1. line number of the file (actual line number).
  2. error class as described in previous section.
  3. details of error (which field, etc.)
  4. erroneous line contents if applicable.

If the file passes validation, a success message is returned and the file is accepted for processing. These requests are handled as individual atomic operations.  In other words, a file is completely validated and all the information required to process the file is stored. If any errors occur at any point during this process, then all of the information is deleted and the error information is returned.  This will allow easy re-processing of files.

Subscribe

Every post in your inbox