Handling Errors
In general, there are two classes of errors you can encounter. A Client Error occurs when your Client Application settings are missing, incorrect, or do not match what we have stored.
An Authorization Error occurs when we the Client Application settings are correct, but are unable to proceed with a transaction.
Client Errors:
| Error | Error Description | Code |
|---|---|---|
| invalid_request | The request is missing a required parameter, includes an unsupported parameter value, or is otherwise malformed. | 400 |
| unauthorized_client | The client is not authorized to request an access token using this method. | 401 |
| unsupported_response_type | The authorization server does not support this response type. | 400 |
| invalid_scope | The requested scope is invalid, unknown, or malformed. | 400 |
| server_error | The authorization server encountered an unexpected condition that prevented it from fulfilling the request. | |
| temporarily_unavailable | The authorization server is currently unable to handle the request due to a temporary overloading or maintenance of the server. | |
| missing_state | Client is not passing state param. This is required for your own protection. | 400 |
| invalid_client | Client authentication failed | 401 |
| invalid_grant | The provided authorization grant is invalid, expired, revoked, does not match the redirection URI used in the authorization request, or was issued to another client. | 400 |
| unsupported_grant_type | The authorization grant type is not supported by the authorization server. | 400 |
| invalid_token | The access token was revoked, has expired, or is invalid | 400 |
Authorization Errors:
The following list represents the current responses that could be potentially returned when Requesting Access Permission. As these errors are potentially displayed to users, the error_description maybe have a generic replacement.
| Error | Error Description | Code |
|---|---|---|
| access_denied | The user or authorization server denied the request. | 403 |
| account_not_verified | Sorry, but you will need to verify your bank account with us before being able to use Sign2Pay again. Keep an eye on your transaction records for a transfer from us. It will have a verification pin in the remarks. | 406 |
| consumer_flagged_account | Sorry, but an account of yours is currently being reviewed for fraudulent activity. | 422 |
| consumer_banned | We're sorry, but this account cannot be used with Sign2Pay. | 422 |
| consumer_has_revoked_payment | We're sorry, but this account cannot be used with Sign2Pay. | 406 |
| unable_to_create_authorization | We are currently unable to process this transaction. Please select an alternative payment method. | 406 |
| amount_above_consumer_transaction_limit | Sorry, this transaction amount is greater than your current spending limit. | 406 |
| amount_above_global_daily_limit | Sorry, but the amount of your purchase is higher than Sign2Pay is processing at the moment. | 406 |
| amount_above_consumer_daily_limit | Sorry, but you've reached your daily limit for Sign2Pay transactions. | 406 |
| consumer_velocity_limit | Sorry, but computer says too soon! You'll need to wait a while before trying again. | 406 |
| global_velocity_limit | Sorry, but computer says too soon! You'll need to wait a while before trying again. | 406 |
| email_validation_failed | Sorry, but this email appears to be incorrect. | 406 |
| unable_to_authorize_transaction | We are currently unable to process this transaction. Please select an alternative payment method. | 406 |
| no_global_payments | We are currently unable to process this transaction. Please select an alternative payment method. | 406 |
| global_retreat | We are currently unable to process this transaction. Please select an alternative payment method. | 406 |
| hancock_offline | We are currently unable to process this transaction. Please select an alternative payment method. | 406 |
| invalid_amount | The amount cannot be negative. | 406 |
| missing_access_token | The access token is missing. | 406 |
| duplicate_ref_id | This ref_id is associated with a purchase that has already been submitted for processing or completed. | 406 |
| amount_above_authorized | Sorry, the amount is higher than what was previously authorized. | 406 |
| unauthorized_status | Sorry, this authorization is not approved for payment. | 406 |
One of the errors above to note is
access_denied. This error represents your user cancelling out of the process.