Wallet Order Errors and Exceptions (Failure Reasons)

Orders can fail for many different reasons. We provide messaging to help you and your user understand why the transaction did not complete.

Wallet Order Creation Exceptions

Order Creation Exceptions are thrown at the time of order creation because of an issue with the request.Wallet Order Creation Exceptions.

Exceptions follow the API error format: link:

{
"language": "en",
"exceptionId": "TLFN89",
"errorCode": "validation.unsupportedCardType.credit",
"message": "Credit cards are not supported",
"type": "ValidationException",
"transient": false
}

Validation Exceptions

Type	Error Code	Message	Notes
ValidationException	validation.unsupportedCardType.credit	Credit cards are not supported
ValidationException	validation.unsupportedCardType.prepaid	PrePaid cards are not supported
ValidationException	validation.avs	We are not able to use this card.	General card validation failure, further details on why the card doesn’t work are unavailable.
ValidationException	validation.avs.invalidBillingAddress	Invalid billing address
ValidationException	validation.avs.incorrectBillingAddress	Invalid billing address. Your address is incorrect
ValidationException	validation.avs.zipcode	Invalid billing address. Zip code is incorrect
ValidationException	validation.avs.unavailable	Invalid billing address. We were not able to validate your address. Try again later.	If our address validation service is unavailable the user will have to try the transaction later
ValidationException	validation.invalidReferrerId	Invalid referrerAccountId
ValidationException	validation.phoneNumRequiresCountryCode	Please include your country code preceded by a "+" with your phone number
ValidationException	validation.unsupportedCountry	Country not supported: “XX”	XX is country code submitted by user
ValidationException	validation.invalidUsState	Invalid US state submitted
ValidationException	validation.missingAddressState	Address state must not be empty
ValidationException	validation.missingGivenName	givenName must not be empty
ValidationException	validation.missingFamilyName	familyName must not be empty
ValidationException	limits.dailyLimitReached	You reached your daily limit.
ValidationException	limits.weeklyLimitReached	You reached your weekly limit.
ValidationException	limits.yearlyLimitReached	You reached your yearly limit
ApiException	n/a	n/a	If there is an unhandled error by the API it will appear as an ApiException without an error code or message

Wallet Order Errors

Error messages are failures that happen after the order has been created. These errors will show up over 3 fields on the wallet order:

errorCategory errorCode errorMessage

A full list of errors can be found below:

errorCategory	errorCode	errorMessage	Notes
GENERAL	UNSUPPORTED_COUNTRY	We do not support this country.
GENERAL	UNSUPPORTED_STATE	We do not support this state at this time but hope to soon.
GENERAL	UNABLE_TO_PROCESS	Sorry, but we are unable to process your order at this time.
GENERAL	SMS_CONFIRMATION_FAILED	SMS confirmation failed	For debit card tx only
GENERAL	PHONE_NUMBER_MUST_BE_MOBILE	Only mobile cellphone numbers are supported.
GENERAL	TRANSACTION_TIMEOUT	Transaction timed out, please try again.
GENERAL	UNKNOWN_ERROR	We are unable to process your order at this time.
PAYMENT	ISO_8583_XX	See ISO 8583 error message list ->	XX replaced by ISO 8583 code. See full list here: https://developers.google.com/standard-payments/v1/fops/card/response-codes
PAYMENT	BILLING_ADDRESS_MISMATCH	Billing address error, please check your info and try again.
PAYMENT	THREE_D_SECURE_AUTHENTICATION_FAILED	3DS authentication failed.
PAYMENT	UNKNOWN_ERROR	Issue with payment, please check your info and try again
RATE_LIMIT	EXCEEDED_DAILY_LIMIT	Transaction limit exceeded, please try again later.
RATE_LIMIT	EXCEEDED_WEEKLY_LIMIT	Transaction limit exceeded, please try again later.
RATE_LIMIT	EXCEEDED_YEARLY_LIMIT	Transaction limit exceeded, please try again later.
RATE_LIMIT	ORDER_AMOUNT_TOO_HIGH	Transaction amount too high, please try a smaller amount.