Appendix

Table of Contents

In the following Appendix section, you will find additional documentation, such as Timezone Names, to be used in the API calls or for your reference.

Timezone Names

In the following section, you will find a list of the Timezone long names to reference when the API calls.

Timezone Names:

Africa/Accra
Africa/Algiers
Africa/Cairo
Africa/Casablanca
Africa/Johannesburg
Africa/Lagos
Africa/Libreville
Africa/Lome
Africa/Nairobi
America/Anchorage
America/Argentina/Buenos_Aires
America/Barbados
America/Bogota
America/Caracas
America/Chicago
America/Chihuahua
America/Denver
America/Godthab
America/Halifax
America/Indiana/Indianapolis
America/Jamaica
America/Los_Angeles
America/Managua
America/Mexico_City
America/Miquelon
America/Nassau
America/New_York
America/Noronha
America/Phoenix
America/Puerto_Rico
America/Regina
America/Santiago
America/Santo_Domingo
America/Sao_Paulo
America/St_Johns
Antarctica/DumontDUrville
Asia/Aden
Asia/Amman
Asia/Baghdad
Asia/Bangkok
Asia/Colombo
Asia/Dhaka
Asia/Hong_Kong
Asia/Irkutsk
Asia/Jerusalem
Asia/Kabul
Asia/Karachi
Asia/Kathmandu
Asia/Kolkata
Asia/Krasnoyarsk
Asia/Magadan
Asia/Manila
Asia/Muscat
Asia/Novosibirsk
Asia/Phnom_Penh
Asia/Qatar
Asia/Rangoon
Asia/Riyadh
Asia/Seoul
Asia/Singapore
Asia/Taipei
Asia/Tbilisi
Asia/Tehran
Asia/Tokyo
Asia/Vladivostok
Asia/Yakutsk
Asia/Yekaterinburg
Atlantic/Azores
Atlantic/Bermuda
Atlantic/Cape_Verde
Australia/Adelaide
Australia/Brisbane
Australia/Darwin
Australia/Hobart
Australia/Perth
Australia/Sydney
Etc/GMT-3
Europe/Andorra
Europe/Belgrade
Europe/Berlin
Europe/Bucharest
Europe/Helsinki
Europe/Istanbul
Europe/London
Europe/Moscow
Europe/Oslo
Europe/Paris
Europe/Sarajevo
Europe/Tirane
Indian/Kerguelen
Pacific/Apia
Pacific/Auckland
Pacific/Fiji
Pacific/Guam
Pacific/Honolulu
Pacific/Midway
Pacific/Tongatapu
Pacific/Wake

Timestamp Values

In the following section, you will find a list of the Timestamp values to reference when the API calls.

1-2-2019 4.50pm
1st Dec 2018 9:00pm
2019-01-15T10:46:46+00:00
jan 26 2020 5:00 am

General Error Codes

The following tables provide information on the generic error codes and texts that you may receive if the API call fails.

CodeDescription
E100Invalid request. Make a valid request via JSON POST with all the required variables.
E104Account Authentication Failed.
E105This account does not have API access.
E107This account is not allowed to use this action.
E108Corrupt JSON in the request. $error.
E109This account does not have API activated.
E112API call rejected. IP is not white listed.
E113API call rejected. Set throughput exceeded for this API action.
E114API call rejected. Phone number is blacklisted.
E120This account has reached the API request limit.
E503Internal error.

Issuance Link Error Codes

The following tables provide information on the error codes and texts that you may receive if the API calls for CreatePassIssuanceLink or UpdatePassIssuanceLink fails.

CodeDescription
E832The {CUSTOM-VALUE-1} is required.
E1532The {CUSTOM-VALUE-1} has duplicate mapping.
E1533The encryption-settings are empty or invalid but {CUSTOM-VALUE-1} is set to be encrypted.
E15334The {CUSTOM-VALUE-1} length is invalid. Valid length {CUSTOM-VALUE-2}
E1535Relevance address should always contain relevance latitude and longitude both for {CUSTOM-VALUE-1}
E1536Both relevance latitude and relevance longitude is required for {CUSTOM-VALUE-1}.
E1537IBeacon UUID is missing for {CUSTOM-VALUE-1}.
E1538The link-generation-limit is invalid.
E1539The link-generation-limit cannot be less than already generated link count.
E1540The link-expiration-timezone is required.
E1541Pass Issuance Link Template creation failed. Please try again later.
E1542Please add the required parameter {CUSTOM-VALUE-1} in pass-variable.
E1543Either the pass variables provided are invalid or empty.
E1544The {CUSTOM-VALUE-1} is a required parameter. “is-required” option must be true.
E1545The encryption-settings are missing/invalid.

Other Error Codes

CodeDescription
E801The pass-template-id value is required.
E802The pass-template-id value is invalid.
E803The barcode value is required.
E806Internal Error. The pass data ID was not created.
E807There was some problem while creating/updating the Google Wallet pass.
E808The pass-template-id value is invalid.
E809Internal Error. The pass was not updated.
E810The pass-id value is required.
E811Authentication failed. The pass was not generated.
E812The pass-id value is already taken.
E815Nothing to update. pass-data field is empty.
E816{CUSTOM-VALUE-1} is invalid. Please remove if any special characters and try again.
E821Internal Error. The pass was not deleted.
E827{CUSTOM-VALUE-1} is invalid. Only numeric values are allowed.
E830Internal Error. The pass was not generated.
E831The download limit has reached. The pass was not generated.
E834The card-number value is required to generate the Gift Card with Google Wallet.
E835The passenger-name value is required to generate the Boarding Pass with Google Wallet.
E836The confirmation-number value is required to generate the Boarding Pass with Google Wallet.
E837The URI provided for {CUSTOM-VALUE-1} is invalid.
E838The {CUSTOM-VALUE-1} label is not accepted. The Dynamic Labels, under Advanced tab needs to be set in the pass template.
E839The {CUSTOM-VALUE-1} value is not accepted. It has to be set as Dynamic in the pass template.
E920The {CUSTOM-VALUE-1} value is not accepted. It has to be set with corresponding latitude and longitude values.
E921The {CUSTOM-VALUE-1} value is empty.
E922The {CUSTOM-VALUE-1} value is invalid.
E923The {CUSTOM-VALUE-1} value is missing or invalid.
E925The {CUSTOM-VALUE-1} is not accepted. It has to be set as Dynamic in the pass template.
E926The {CUSTOM-VALUE-1} is not accepted for this pass type.
E1526The key name for relevant-locations is not correct. It should be from relevant-1 to relevant-10
E1527The key name for ibeacons is not correct. It should be from ibeacon-1 to ibeacon-10

Encryption Algorithms

  1. AES-CBC: Advanced Encryption Standard (AES) is a symmetric encryption algorithm. AES is the industry standard as of now as it allows 128 bit, 192 bit and 256-bit encryption. There are also 2 modes of encryption. Currently, we support 256 bit CBC mode encryption.

Checksum Algorithms

  1. CRC32: CRC (Cyclic Redundancy Check) is an error-detecting code which is used to verify the raw data passed from accidental change or data corruption. A short check value is generated for a block of data and on retrieval, the short check code is again generated and matched with the previous code. CRC 32 is a 32 bit variant of CRC algorithm
  2. SHA256: A SHA-256 (Secure Hash Algorithm) is a 256 bit variant of SHA-2 cryptographic hashing algorithm family which is used for cryptographic security. This algorithm produces irreversible and unique hashes of the data passed.
  3. SHA384: A SHA-384 (Secure Hash Algorithm) is a 384 bit variant of SHA-2 cryptographic hashing algorithms which is used for cryptographic security. It is not a unique hash algorithm but is instead a truncated version of SHA-512.
  4. SHA512: A SHA-512 (Secure Hash Algorithm) is a 512 bit variant of SHA-2 cryptographic hashing algorithms that is used for cryptographic security. This algorithm produces irreversible and unique hashes.