Errors and Exceptions

Exception scenarios

#	Scenario	What happens	What to do
1	Airline Acquiring not enabled on the outlet	Order is created (`201`), but `airlineDetails` is dropped and missing from the response. No error is returned	Check the response for `airlineDetails`. Ask Network International to enable Airline Acquiring
2	`airlineDetails` sent on a recurring / subscription order	`400`, `errorCode: airlineRecurringNotSupported`	Use a single (one-time) order
3	A field breaks its rule (length, format, regex)	`400`, `errorCode: invalidFieldValue` with the field name	Fix the field (see Field reference)
4	Invalid enum value or wrong case (e.g. `passenger_ticket`)	`400`	Use the exact upper-case value (Field reference)
5	Invalid date, e.g. `2026-02-30`, or time without a zone, e.g. `09:30`	`400`, `invalidFieldValue`	Dates `yyyy-MM-dd`, times `HH:mm[:ss]` plus `Z` or `±hh:mm`
6	Misspelled field name, e.g. `electronicTicket` instead of `eTicket`	No error. The field is ignored	Check field names against Field reference
7	Capture `airline` block missing `multiClrSeqNum`, `multiClrCntNum` or `multiClrInd`	`400`, `errorCode: mandatoryField`	Send all three
8	Capture optional field sent as `""`	`400`, `invalidFieldValue`	Leave the field out instead
9	`airline` block sent on a full capture	Capture succeeds. The `airline` block is ignored	Only use it on partial captures
10	`airline` block sent on a capture when Airline Acquiring is not enabled	Capture succeeds. The `airline` block is ignored	Enable Airline Acquiring
11	Capture on a `PURCHASE` order	Rejected. The payment is already captured	Use `AUTH` for multi-clearing
12	Capture amount above the amount still authorised	`400`	Capture at most the remaining authorised amount
13	Customer pays with an alternative payment method	Not possible. Only cards are offered when `airlineDetails` is present	n/a
14	Access token expired	`401 Unauthorized`	Request a new token (Get an access token)
15	More than 13 `passengers`, more than 9 `legs`, or an empty `taxOrFees` array	`400`, `invalidFieldValue`	See the array limits in Field reference
16	Network timeout on capture or refund	Result unknown	Call Get order to check the payment state before retrying, to avoid a duplicate capture or refund

Error responses

Errors use this shape:

{
  "message": "Bad Request",
  "code": 400,
  "errors": [
    {
      "message": "bookingReferenceNumber must be between 6 and 15 characters",
      "localizedMessage": "bookingReferenceNumber must be between 6 and 15 characters",
      "errorCode": "invalidFieldValue",
      "domain": "processing",
      "location": "airlineDetails.bookingReferenceNumber"
    }
  ]
}

errorCode	Meaning
`invalidFieldValue`	A field doesn't meet its length, format or allowed values
`mandatoryField`	A mandatory capture field (`multiClrSeqNum`, `multiClrCntNum`, `multiClrInd`) is missing or blank
`airlineRecurringNotSupported`	`airlineDetails` sent on a recurring or subscription order