31. API Failure codes

  • Description from documentation

31.1. various

  • 1. A bad username has been provided in the ‘user_id’ element.
  • 2. User authorisation has failed. Either your password or crypto_block are invalid for the given user_id.
  • 3. A connection could not be established to the backend ticketing system.
  • 4. Your IP address is on a network forbidden from using the core.
  • 5. A connection could not be established to the main database.
  • 6. Membership authentication has failed. This should never happen as membership schemes are not being used with the XML core.
  • 7. Bad data has been supplied to the script.

31.2. extra_info

  • 101 - no ‘event_token’ has been supplied
  • 102 - the supplied ‘event_token’ is corrupt
  • 103 - the event specified could not be found in the database

31.3. date_time_options

  • 201 - no ‘event_token’ has been supplied
  • 202 - the supplied ‘event_token’ is corrupt
  • 203 - the event specified could not be found in the database
  • 204 - the ‘earliest_date’ element was badly formatted
  • 205 - the ‘latest_date’ element was badly formatted
  • 206 - Bad date_range element

31.4. availability_options

  • 301 - no ‘departure_date’ has been supplied when required
  • 302 - a ‘departure_date’ has been supplied when not required
  • 303 - no ‘usage_date’ has been supplied when required
  • 304 - a ‘usage_date’ has been supplied when not required
  • 305 - no ‘perf_token’ has been supplied when required
  • 306 - a ‘perf_token’ has been supplied when not required
  • 307 - the ‘departure_date’ element was badly formatted
  • 308 - the ‘usage_date’ element was badly formatted
  • 309 - the specified departure date is in the past
  • 310 - the specified usage date is in the past
  • 311 - the specified usage date is before the departure date
  • 312 - the specified usage date is not allowed
  • 313 - the supplied ‘perf_token’ is corrupt
  • 314 - the specified departure date is after the performance
  • 315 - the supplied ‘trolley_token’ is corrupt

31.5. discount_options

  • 401 - no ‘band_token’ has been supplied
  • 402 - the supplied ‘band_token’ is corrupt
  • 403 - no ‘despatch_token’ has been supplied
  • 404 - the supplied ‘despatch_token’ is corrupt
  • 405 - no ‘no_of_tickets’ element has been supplied
  • 406 - the ‘no_of_tickets’ element is not an integer
  • 407 - the requested number of tickets is not an allowed value
  • 408 - the supplied ‘trolley_token’ is corrupt

31.6. create_order

  • 501 - a corrupt ‘discount_token’ has been supplied
  • 502 - discounts tokens supplied when the product order does not support discounts
  • 503 - no discount tokens were supplied
  • 504 - multiple discount tokens were supplied for an order which requires a blanket discount
  • 505 - the wrong number of discount tokens were supplied for the order in question
  • 506 - the number of different discount types provided exceeds the allowed limit
  • 507 - more than one discount token has been supplied from the same ‘discounts’ element
  • 508 - Discounts supplied for wrong price band when add_possible = no

31.7. trolley_add_order

  • 601 - no ‘order_token’ has been supplied trolley_bad_bundle
  • 602 - the supplied ‘order_token’ is corrupt trolley_bad_combo
  • 603 - the supplied ‘trolley_token’ is corrupt trolley_bad_card_types
  • 604 - the trolley has already been purchased trolley_bad_countries
  • 605 - the trolley has already been reserved trolley_bad_currency_mix

31.8. trolley_describe

  • 701 - no ‘trolley_token’ has been supplied trolley_bad_depart
  • 702 - the supplied ‘trolley_token’ is corrupt trolley_bad_send

31.9. trolley_remove

  • 801 - no ‘trolley_token’ has been supplied
  • 802 - the supplied ‘trolley_token’ is corrupt
  • 803 - the trolley has already been purchased
  • 804 - the trolley has already been reserved

31.10. make_reservation

  • 901 - no ‘trolley_token’ has been supplied
  • 902 - the supplied ‘trolley_token’ is corrupt
  • 903 - the trolley has already been purchased
  • 904 - the trolley has already been reserved

31.11. purchase_reservation

  • 1101 - the reservation has expired
  • 1102 - no ‘customer_data’ element has been supplied
  • 1103 - no ‘card_data’ element has been supplied when required
  • 1104 - a ‘card_data’ element has been supplied when not required
  • 1105 - no ‘country_code’ element was present in the customer data
  • 1106 - the chosen despatch method does not allow the given country code in the customer data
  • 1107 - the supplied email address fails RFC822 syntax checking
  • 1108 - the customer details supplied are incomplete
  • 1109 - no ‘card_number’ element was present in the payment card data
  • 1110 - the payment card type is not known from the supplied card number
  • 1111 - the payment card type is not one of those accepted for this transaction
  • 1112 - the card number given is not valid for cards of that type
  • 1113 - no ‘expiry_date’ element was present in the payment card data
  • 1114 - the expiry date given is not valid
  • 1115 - no ‘cv_two’ element was present in the payment card data
  • 1116 - the CV2 value given is not valid
  • 1117 - no ‘issue_number’ element has been supplied when required
  • 1118 - an ‘issue_number’ element has been supplied when not required
  • 1119 - the issue number given is not valid
  • 1120 - alternate card billing address supplied when not supported
  • 1121 - the alternate card billing address details supplied are incomplete
  • 1122 - no ‘start_date’ element has been supplied when required
  • 1123 - the start date given is not valid
  • 1124 - the users prefill data is not editable and does not match the customer data supplied”
  • 1125 - a ‘card_data’ element has been supplied over a non-encrypted connection

31.12. transaction_info (?)

  • 1201 - Missing transaction_id
  • 1202 - Invalid transaction_id supplied

31.13. purchase_reservation_part_one

  • 1301 - the reservation has expired
  • 1302 - no ‘customer_data’ element has been supplied
  • 1303 - no ‘card_data’ element has been supplied when required
  • 1304 - a ‘card_data’ element has been supplied when not required
  • 1305 - no ‘country_code’ element was present in the customer data
  • 1306 - the chosen despatch method does not allow the given country code in the customer data
  • 1307 - the supplied email address fails RFC822 syntax checking
  • 1308 - the customer details supplied are incomplete
  • 1309 - no ‘card_number’ element was present in the payment card data
  • 1310 - the payment card type is not known from the supplied card number
  • 1311 - the payment card type is not one of those accepted for this transaction
  • 1312 - the card number given is not valid for cards of that type
  • 1313 - no ‘expiry_date’ element was present in the payment card data
  • 1314 - the expiry date given is not valid
  • 1315 - no ‘cv_two’ element was present in the payment card data
  • 1316 - the CV2 value given is not valid
  • 1317 - no ‘issue_number’ element has been supplied when required
  • 1319 - the issue number given is not valid
  • 1320 - alternate card billing address supplied when not supported
  • 1321 - the alternate card billing address details supplied are incomplete
  • 1322 - no ‘start_date’ element has been supplied when required
  • 1323 - the start date given is not valid
  • 1324 - the users prefill data is not editable and does not match the customer data supplied”
  • 1325 - a ‘card_data’ element has been supplied over a non-encrypted connection
  • 1326 - a bad ‘return_token’ element has been supplied
  • 1327 - a bad ‘return_domain’ element has been supplied
  • 1328 - a bad ‘return_path’ element has been supplied
  • 1329 - a bad ‘return_with_https’ element has been supplied
  • 1330 - a bad ‘encryption_key’ element has been supplied
  • 1331 - the supplied ‘return_token’ element has already been used

31.14. purchase_reservation_part_two

  • 1401 - a bad ‘returning_token’ element has been supplied
  • 1402 - the ‘returning_token’ is unknown
  • 1403 - the trolley was already purchased but we cannot reproduce the results page (very unlikely)”
  • 1404 - the reservation has expired
  • 1405 - a bad ‘new_return_token’ element has been supplied
  • 1406 - a bad ‘new_return_path’ element has been supplied
  • 1407 - a bad ‘encryption_key’ element has been supplied
  • 1408 - the ‘sub_id’ has changed since part one purchase
  • 1409 - one of the http header elements is missing
  • 1410 - the ‘callback_data’ element is missing
  • 1411 - the supplied ‘new_return_token’ element has already been used

31.15. despatch_options

  • 1501 Missing departure_date
  • 1502 Superfluous departure_date
  • 1503 Missing usage_date
  • 1504 Superfluous usage_date
  • 1505 Missing perf_token
  • 1506 Superfluous perf_token
  • 1507 Bad departure_date element
  • 1508 Bad usage_date element
  • 1509 Departure date in past
  • 1510 Usage date in past
  • 1511 Usage date before departure date
  • 1512 Disallowed usage date
  • 1513 Corrupt perf_token
  • 1514 Performance before departure date
  • 1515 Corrupt trolley token

31.16. suggest_user

  • 1601 Missing client_ip_address
  • 1602 Address passed is not a valid IP address

31.17. The call to save an external confirmation page

  • 1701 Missing or whitespace transaction_id
  • 1702 Missing or whitespace sale_page_type
  • 1703 Missing or whitespace sale_page_subtype
  • 1704 Missing sale_page
  • 1705 Invalid transaction_id supplied
  • 1706 Transaction is not failed or purchased