What are Exceptions or Faults?
Exceptions or faults may occur before greenID is successfully able to create a registration or retrieve it. For example, when an invalid field is submitted as an input and therefore a registration cannot be created.
Exception data is returned in the following structure:
Field name | Description |
|---|---|
{{faultCode}} | Normally the value {{env:Server}} to indicate a server-side exception. |
Examples of Exceptions or Faults
SOAP
JSON
Exceptions List and Details
Exception Type | Details |
|---|---|
| The |
| If certificates are used to connect, then this exception may be thrown if an invalid certificate is used. |
| The |
| One of the required fields was missing, or the format of a field was not valid. For example, this may be thrown if an email address is not valid. |
| If web service IP restriction is enabled, then this exception will be thrown if the caller's IP address is not white-listed. |
| The Hosted account is not appropriately configured. For example, account is not enabled for Hosted or account is not enabled for SMS. |
| An unexpected error occurred. |
| The UserID/verificationId input is already in use. |
| User Id is reserved by a SMS invitation. |
| The UserID/verificationId input could not be found. |
What are Errors?
Errors may occur after the registration has been created or retrieved. For example, if our provider fails to send the SMS message submitted.
Samples of Error
SOAP
JSON
Note: ErrorReasonCode is currently note returned as a field in the JSON response. This field will be added soon and will return the values listed below.
Error Reason Code Mapping
The API response will include an 'errorReasonCode' and 'errorMessage'. If there is an error with the submitting the SMS - an error reason code and error message will be provided. The table below provides the the error reason code and the description (error message) that greenID will send back in the API response in relation to SMS.
Reason Code (errorReasonCode) | Description (errorMessage) |
InvalidMobileNumberForSMS | SMS could not be sent since the mobile number is invalid. |
InvalidMobileNumberForSMS | SMS could not be sent since the mobile number is invalid. |
InvalidMobileNumberForSMS | SMS could not be sent since the mobile number is invalid. |
InvalidSenderForSMS | SMS was sent from an invalid 'sender'. Please contact support to correctly configure the 'sender' for your account. |
InvalidSenderForSMS | SMS was sent from an invalid 'sender'. Please contact support to correctly configure the 'sender' for your account. |
NonMobileNumberForSMS | SMS could not be sent since the number provided is not a mobile phone number |
UnsupportedCountryForSMS | SMS could not be sent since you are trying to send to a country that is not supported |
ReceiverOptOutForSMS | SMS could not be delivered since the destination number has opted out of receiving messages from the 'sender' defined for your account. |
SMSNotSent | SMS could not be sent at this time. Please try again later. |
SMSNotSent | SMS could not be sent at this time. Please try again later. |
DestinationUnreachableForSMS | SMS could not be delivered since the destination handset could not be reached. Please try again later. |
LandlineUsedForSMS | SMS could not be delivered since the destination number is a landline. |
SMSNetworkCongestion | SMS could not be delivered due to carrier network congestion. Please try again later. |
SMSDeliveryError | The SMS could not be delivered due to an error. |
SMSUnexpectedError | An unexpected error occurred when sending the SMS. |
HostedInviteError | An unexpected error occurred when attempting to generate the Hosted Invite URL. |
UnexpectedError | An unexpected error occurred. |
Home | greenID API | greenID Web | greenID Mobile | greenID Business | greenID Additional Services | Notification of Verification | Admin Panel Guide
If you can't find what you need here, email us at customer.support@gbgplc.com or log a ticket via our portal