Tillo APIAppearance
Error codes
These error codes are consistent across version 1 and 2 of our API (v2 introduced some additional error cases)
| Tillo Error Code | HTTP response code | Description | Example Error Message |
|---|---|---|---|
| 000 | 200 | Success | Success |
| 060 | 400 | API v1 only - invalid or expired API Token | Token mismatch error |
| 070 | 400 | Missing parameters | Missing parameter [personalisation] |
| 070 | 400 | Missing parameter [amount] | There were errors validating the request |
| 071 | 400 | API v1 only - Missing additionalParams | Missing parameter [additionalParams] |
| 072 | 400 | Brand not found | The requested brand [great-british-pub] does not exist |
| 072 | 400 | Invalid brand | Brand [tesco] is not available for this partner |
| 072 | 401 | Invalid brand for this partner | Brand [Gb Pub] is not available for this partner |
| 100 | 422 | The gift code has already been cancelled | The gift code has already been cancelled |
| 100 | 422 | Attempting to cancel a gift code that was not issued successfully | Attempting to cancel a gift code that was not issued successfully |
| 100 | 422 | Error | Error |
| 210 | 401 | Invalid IP address | Invalid IP address |
| 433 | 422 | Validation Errors | There were errors validating the request |
| 434 | 404 | Authentication failed | Authentication failed |
| 600 | 500 | Internal error | Internal error |
| 602 | 500 | System unavailable due to maintenance | Internal error |
| 603 | 500 | External – Issue communicating with the Processor | Service unavailable for brand [amazon] |
| 604 | 503 | Health Check | Error |
| 610 | 403 | Insufficient Monies on account balance on account for Partner, Brand Company or Brand | Insufficient balance on account |
| 610 | 422 | Insufficient Monies on account balance on account for Partner, Brand Company or Brand | Insufficient balance on account |
| 615 | 403 | Insufficient credit with Brand company | Insufficient credit with [Mitchells & Butlers] |
| 615 | 422 | Insufficient credit with Brand company or Brand | Insufficient credit with [Mitchells & Butlers] |
| 616 | 422 | Credit account with Tillo is paused | The credit account with Tillo is PAUSED, contact the Finance Team |
| 704 | 422 | The [amount] must be a number | There were errors validating the request |
| 704 | 400 | Invalid value | There were errors validating the request |
| 704 | 500 | Invalid value | Denomination [5.00] not available for Brand [Gap] |
| 704 | 400 | Invalid value | Denomination [5.00] not available for Brand [Gap] |
| 704 | 400 | Invalid value | The sector [sales] is invalid. Please provide an acceptable one |
| 704 | 400 | Invalid value | There were errors validating the request: The requested face value [5.123] is invalid. The face value must have a maximum of 2 Decimal Places |
| 706 | 401 | Sale is disabled | Brand [Amazon Fr] is not available through the API |
| 708 | 400 | The original request failed. Please re-submit with a new clientRequestID | The original request failed. Please re-submit with a new clientRequestID |
| 708 | 400 | The clientRequestID already exists however the brand and value supplied do not match. If you ARE trying to replay a request please ensure that the brand and value match too, or please re-submit the request with a new clientRequestID to generate a new giftcard | The clientRequestID already exists however the brand and value supplied do not match. If you ARE trying to replay a request please ensure that the brand and value match too, or please re-submit the request with a new clientRequestID to generate a new giftcard |
| 709 | 404 | A relationship between the Partner and the Brand does not exist | We couldn't find a record for a relationship between yourself and brand [Debenhams UK] |
| 711 | 400 | Cancel not active | Card no longer active |
| 712 | 404 | Delivery method not found | The requested delivery method was not found |
| 713 | 400 | The delivery method is not allowed | You cannot deliver codes via [wrapped] for [Adidas] |
| 714 | 400 | You did not supply a delivery method and we were unable to fallback to the default | There were errors validating the request |
| 715 | 503 | The URL hosting service is currently unavailable | The URL hosting service is currently unavailable |
| 716 | 400 | The requested template was not found | The requested template was not found |
| 717 | 401 | The partner does not have access to the template for the requested brand | Template for brand [Amazon FR] is not available for this partner |
| 719 | 422 | The transaction type is not supported by the partner | The transaction type is not supported by the partner |
| 720 | 422 | The transaction type is not supported for the requested brand | The transaction type is not available for the requested brand |
| 721 | 422 | The currency iso code was not found | The requested currency was not found |
| 722 | 400 | The currency iso code was not supplied | You did not supply a currency |
| 723 | 422 | The requested currency iso code is not supported by this brand | The requested currency is not supported by this brand |
| 724 | 422 | The sale reference provided cannot be found on our system | The sale could not be found |
| 725 | 500 | The requested denominations is not in stock | Denomination [10.00] is currently not in stock for Brand [Gap] |
| 726 | 503 | A required feature has not been enabled | The requested feature [tagging] is not enabled for you |
| 728 | 403 | Insufficient balance on card | Insufficient balance on card |
| 729 | 400 | Duplicate request incomplete | The original request is still being processed. Please try again later |
| 730 | 400 | Invalid sale reference | Invalid sale uuid for gift code look up |
| 731 | 400 | Sale reference not supplied | You did not supply a sale reference |
| 732 | 425 | Sale redemption in progress | A redemption for sale [a11d3a00-0c75-11eb-923f-318c54fae775] is already in progress |
| 733 | 422 | Invalid order status | Cannot fulfil order, invalid status |
| 734 | 422 | Invalid redemption status for fulfilment | Cannot fulfil order, invalid redemption status |
| 735 | 410 | The sale has expired, preventing any further action | Sale expired |
| 736 | 400 | Invalid financial relationship | Cannot fulfil order, invalid financial relationship |
| 738 | 422 | The currency requested can only be used with the International Payments feature | The requested currency [GBP] is only available with International Payments |
| 739 | 422 | The brand requested is not supported by International Payments (e.g. a Choice Link brand) | The requested brand [amazon] is not supported by International Payments |
| 740 | 400 | The requested feature is only available through API v2 | The requested feature is only available through API v2 |
| 999 | 404 | The requested endpoint was not found | Not Found |
| 999 | 405 | The requested method is not allowed | Method not allowed |
| 999 | 500 | Internal error | Internal error |