Errors

AccessFailure

Account cannot be accessed.

You can display the following message to your customers:

Your account cannot be accessed.

Retriable: Yes

AccountClosed

Account is not active.

You can display the following message to your customers: Your account is closed.

Retriable: Yes

AccountLimitsExceeded

The spending or receiving limit on the account is exceeded. This error can also occur when the specified bank account has not yet been verified.

You can display the following message to your customers: You have exceeded your spending or receiving limits. You can view your current limits at http://payments.amazon.com/sdui/sdui/viewlimits. You can upgrade these limits by adding and verifying a bank account as a payment method. Please visit Adding and Verifying Bank Accounts to learn how to add and instantly verify a bank account.

Retriable: Yes

AmountOutOfRange

The transaction amount is more than the allowed range.

Ensure that you pass an amount within the allowed range. The transaction amount in a Pay operation using credit card or bank account must be greater than $0.01.

Retriable: No

AWS was not able to validate the provided access credentials.

Please make sure that your AWS developer account is signed up for FPS.

Retriable: Yes

ConcurrentModification

A retriable error can happen when two processes try to modify the same data at the same time.

The developer should retry the request if this error is encountered.

Retriable: Yes

DuplicateRequest

A different request associated with this caller reference already exists.

You have used the same caller reference in an earlier request. Ensure that you use unique caller references for every new request.

Even if your earlier request resulted in an error, you should still use a unique caller reference with every request and avoid this error.

Retriable: No

InactiveInstrument

Payment instrument is inactive.

The payment instrument is inactive, for example, a credit card has expired.

Retriable: No

The transaction could not be completed because the tokens have incompatible payment instructions.

If any assertion in one of the payment instructions fails, this error is displayed. As such, it may be caused by a number of reasons, for example:

The external calling application is not the recipient for this postpaid or prepaid instrument. The caller should be the liability holder.

You are trying to access an instrument that you do not own.

The prepaid or the postpaid instrument has expired.

You must ask your customers to set up a new prepaid or postpaid agreement

InsufficientBalance

The sender, caller, or recipient’s account balance has insufficient funds to complete the transaction.

You must ask your customers to fund their accounts. You can then retry this request.

Funding an account can take up to three to four business days using a bank account transfer. This error is also displayed if the party paying the Amazon FPS fees does not have a sufficient account balance.

Retriable: Yes

InternalError

A retriable error that happens due to some transient problem in the system.

The caller should retry the API call if this error is encountered.

Retriable: Yes

InvalidAccountState

The account is either suspended or closed. Payment instructions cannot be installed on this account.

You must ask your customer to set up a new account if the account is closed.

Retriable: Yes

InvalidAccountState_Caller

The developer account cannot participate in the transaction.

Your account is not active. Contact your AWS Representative for more information.

Retriable: Yes

InvalidAccountState_Recipient

Recipient account cannot participate in the transaction.

You can display the following message to your customer (sender): Your Amazon Payments account is not active. Please visit http:// payments.amazon.com for more details.

Retriable: Yes

InvalidAccountState_Sender

Sender account cannot participate in the transaction.

You can display the following message to your customer (sender): Your Amazon Payments account is not active. Please visit http://payments.amazon.com for more details.

Retriable: Yes

The Caller Reference does not have a token associated with it.

Use the caller reference value that was passed to the InstallPaymentInstruction operation or the Amazon FPS Co-Branded UI pipeline.

The AWS Access Key Id you provided does not exist in our records.

Please check that the AWS Access Key Id used to make the request is valid.

Retriable: No

The end date specified is before the start date or the start date is in the future.

Specify the correct end date.

InvalidParams

One or more parameters in the request is invalid.

For more information, see the parameter descriptions for the action in the API Reference. Parameters are case sensitive.

Retriable: No

The payment method used in the transaction is invalid.

Specify a valid payment method

The cause for this error is dependent on the calling action:

This account cannot receive credit card payments.

You can display the following message to your customers: You cannot receive credit card payment. Please visit http://payments.amazon.com to update your account to receive credit card payments."

InvalidSenderRoleFor

  AccountType

This token cannot be used for this operation.

Ensure that the account used in this transaction is the same account used in the original transaction. In a refund transaction, the recipient making the refund payment must the be same recipient as in the original transaction.

Retriable: No

InvalidTokenId

You did not install the token that you are trying to cancel.

You do not have permission to cancel this token. You can cancel only the tokens that you own.

Retriable: No

InvalidTokenId_Recipient

The recipient token specified is either invalid or canceled.

You must install a new token if you are the recipient. If you are not the recipient, get a new payment authorization from the recipient.

Retriable: No

InvalidTokenId_Sender

The send token specified is either invalid or canceled or the token is not active.

You must ask your customer to set up a new payment authorization.

Retriable: No

InvalidTokenType

An invalid operation was performed on the token, for example, getting the token usage information on a single use token.

Retriable: No

InvalidTransactionId

The specified transaction could not be found or the caller did not execute the transaction or this is not a Pay or Reserve call.

Specify the correct the transaction ID.

Retriable: No

InvalidTransactionState

The transaction is not complete, or it has temporarily failed.

Specify a duration of more than one hour.

Retriable: No

This is not an marketplace application or the caller does not match either the sender or the recipient.

Please check that you are specifying the correct tokens.

Retriable: Yes

OriginalTransactionFailed

The original transaction has failed.

You cannot refund a transaction that has originally failed.

Retriable: No

The original transaction is still in progress.

Retry after the original transaction has completed.

Retriable: Yes

The payment method specified in the transaction is not a credit card. You can only use a credit card for this transaction.

Use only a credit card for this transaction.

Payment method is not defined in the transaction.

Specify the payment method in the sender token.

An attempt has been made to fund the prepaid instrument at a level greater than its recharge limit.

Retriable: Yes, after adjusting the amount of funds to a valid level.

RefundAmountExceeded

The refund amount is more than the refundable amount.

You are not allowed to refund more than the original transaction amount.

Retriable: No

The sender and receiver are identical, which is not allowed.

Retriable: No

This token is already used in earlier transactions.

The tokens used in a transaction should be unique.

SenderNotOriginalRecipient

The sender in the refund transaction is not the recipient of the original transaction.

The token you passed as the refund sender token does not belong to the recipient of the original transaction. Pass the correct refund sender token.

Retriable: No

SettleAmountGreaterThanDebt

The amount being settled or written off is greater than the current debt.

You cannot settle an amount greater than what is owed.

Retriable: No

SettleAmountGreaterThan

ReserveAmount

The amount being settled is greater than the reserved amount.

You cannot settle an amount greater than what is reserved.

Retriable: No

The request signature calculated by Amazon does not match the signature you provided.

Check your AWS Secret Access Key and signing method.

For more information, see "Working with Signatures" in the Amazon Flexible Payments Service Getting Started Guide.

Retriable: No

TokenAccessDenied

Permission is denied to cancel the token.

You are not allowed to cancel this token.

Retriable: No

TokenNotActive

The token is canceled.

A new token needs to be created.

Retriable: No

TokenNotActive_Recipient

The recipient token is canceled.

If you are the recipient, set up a new recipient token using the InstallPaymentInstruction operation or direct your customers to the Recipient Token Installation Pipeline to set up recipient token.

Retriable: No

TokenNotActive_Sender

The sender token is canceled.

You must ask your customer to set up a new payment authorization because the current authorization is not active.

Retriable: No

The token usage limit is exceeded.

If the usage has exceeded for this period, then wait for the next period before making another transaction. If the usage has exceeded for the entire authorization period, then ask your customer to set up a new payment authorization.

TransactionDenied

This transaction is not allowed.

You are not allowed to do this transaction. Check your credentials.

Retriable: No

TransactionFullyRefunded

  Already

This transaction has already been completely refunded.

You are not allowed to refund more than the original transaction amount.

Retriable: No

TransactionTypeNotRefundable

You cannot refund this transaction.

Refund is allowed only on the Pay operation.

Retriable: No

UnverifiedAccount_Recipient

The recipient's account must have a verified bank account or a credit card before this transaction can be initiated.

You can display the following message to your customer (recipient): Your Amazon Payments account is not active. Please visit http://payments.amazon.com for more details.

Retriable: No

UnverifiedAccount_Sender

The sender's account must have a verified U.S. credit card or a verified U.S bank account before this transaction can be initiated.

You can display the following message to your customers: Please add a U.S. credit card or U.S. bank account and verify your bank account before making this payment.

Retriable: No

UnverifiedBankAccount

A verified bank account should be used for this transaction.

Visit the http://payments.amazon.com web site to verify your bank account.

Retriable: No

UnverifiedEmailAddress_Caller

The caller account must have a verified email address.

You cannot make a web service API call without verifying your email address. Go to http://payments.amazon.com web site and make payments.

Retriable: No

UnverifiedEmailAddress_

  Recipient

The recipient account must have a verified email address for receiving payments.

You can display the following message to your customers: You cannot receive payments. Please verify your email address. Go to http://payments.amazon.com to verify your account and receive payments.

Retriable: No

UnverifiedEmailAddress_Sender

The sender account must have a verified email address for this payment

You can display the following message to your customers: You cannot receive payments. Please verify your email address. Go to http://payments.amazon.com to verify your account and receive payments.

Retriable: No