REST API | American Express

Reason Codes and Reply Flags

A transaction response contains either a reason code or SCMP reply flag, depending on the integration method used. The Reason Codes and Reply Flags table shown below lists reason codes, corresponding reply flags, descriptions of the values, and possible follow-up actions that you can take.
Reason Codes
A
reason code
is the response from the servers for production transactions that are submitted using these methods:
  • Simple Order API
  • Virtual Terminal
  • Secure Acceptance
    Hosted Checkout Integration
  • Secure Acceptance
    Checkout API
  • SOAP Toolkit API
  • Offline Transaction File Submission
The reason for a code might be determined by systems upstream such as your payment processor. Further investigation may be required in order to learn the root cause.
Reply Flags
A
reply flag
is the transaction response value for the SCMP integration method that corresponds to a reason code.
Reason Codes and Reply Flags
Reason Code
Reply Flag (SCMP)
Description
Possible Action
100
SOK
Successful transaction.
No action required.
101
DMISSINGFIELD
Declined. The request is missing one or more fields.
See the response fields
missingField_0...N
for which fields are invalid. Resend the request with the correct information.
102
DINVALIDDATA
Declined. One or more fields in the request contains invalid data.
See the response fields
invalidField_0...N
for which fields are invalid. Resend the request with the correct information.
104
DDUPLICATE
Declined. The merchant reference code sent with this authorization request matches the merchant reference code of another authorization request that you sent in the past 15 minutes.
Resend the request with a unique merchant reference code.
110
SPARTIALAPPROVAL
Partial amount was approved.
See "Partial Authorizations" in Credit Card Services Using the Simple Order API
150
ESYSTEM
Error. General system failure. A system error occurred.
You must design your transaction management system to correctly handle system errors. Depending on which payment processor is handling the transaction, the error might indicate a valid system error or it might indicate a processor rejection because of some type of invalid data. In either case, it is best not to design your system to endlessly resend a transaction when a system error occurs.
For information about how to handle system errors and retries, see the documentation for the client (SDK) that you are using.
151
ETIMEOUT
Error. The request was received, but a server timeout occurred. This error does not include timeouts between the client and the server.
To avoid duplicating the transaction, do not resend the request until you review the transaction status in the Business Center.
For information about how to handle system errors and retries, see the documentation for the client (SDK) that you are using.
152
ETIMEOUT
Error. The request was received but a service did not finish running in time.
To avoid duplicating the transaction, do not resend the request until you review the transaction status in the Business Center.
For information about how to handle system errors and retries, see the documentation for the client (SDK) that you are using.
200
DAVSNO
Soft decline. The authorization request was approved by the issuing bank but was flagged because it did not pass the Address Verification Service (AVS) check.
You can capture the authorization, but consider reviewing the order for the possibility of fraud.
201
DCALL
Decline. The issuing bank has questions about the request. You do not receive an authorization code programmatically, but you might receive one verbally by calling the processor.
Call your processor to possibly receive a verbal authorization. For contact phone numbers, refer to your merchant bank information.
202
DCARDEXPIRED
Decline. Expired card. You might also receive this code or flag if the expiration date you provided does not match the date on file with the issuing bank.
Note: The
ccCreditService
field does not check the expiration date. Instead, it passes the request to the payment processor. If the payment processor allows credits to be issued to expired cards, this functionality is not limited.
Request a different payment card or other form of payment.
203
DCARDREFUSED
Decline. General decline of the card. No other information provided by the issuing bank.
Request a different payment card or other form of payment.
204
DCARDREFUSED
Decline. Insufficient funds in the account.
Request a different payment card or other form of payment.
205
DCARDREFUSED
Decline. Stolen or lost card.
Refer the transaction to your customer support center for manual review.
207
DCARDREFUSED
Decline. Issuing bank unavailable.
Wait a few minutes and then resend the request.
208
DCARDREFUSED
Decline. Inactive card or card not authorized for card-not-present transactions.
Request a different payment card or other form of payment.
209
DCARDREFUSED
Decline. Card verification number (CVN) did not match.
Request a different payment card or other form of payment.
210
DCARDREFUSED
Decline. The card has reached the credit limit.
Request a different card or other form of payment.
211
DCARDREFUSED
Decline. Invalid Card Verification Number (CVN).
Request a different payment card or other form of payment.
220
DCHECKREFUSED
Decline. Generic decline.
Request a different form of payment.
221
DCHECKREFUSED
Decline. The customer matched an entry in the processor's negative file.
Review the order and contact the payment processor.
222
DCHECKREFUSED
Decline. The customer's account is frozen.
Review the order or request a different form of payment.
230
DCV
Soft decline. The authorization request was approved by the issuing bank but was flagged because it did not pass the Card Verification Number (CVN) check.
You can capture the authorization, but consider reviewing the order for the possibility of fraud.
231
DINVALIDCARD
Decline. Invalid account number.
Request a different payment card or other form of payment.
232
DINVALIDDATA
Decline. The card type is not accepted by the payment processor.
Contact your merchant bank to confirm that your account is set up to accept the card type.
233
DINVALIDDATA
Decline. General decline by the processor.
Request a different payment card or other form of payment.
234
DINVALIDDATA
Decline. There is a problem with your merchant configuration.
Do not resend the request.
Contact your customer support to correct the configuration problem.
235
DINVALIDDATA
Decline. The requested amount exceeds the originally authorized amount. For example, this occurs when you try to capture an amount larger than the original authorization amount.
Issue a new authorization and capture request for the new amount.
236
DINVALIDDATA
Decline. Processor failure.
Wait a few minutes and then resend the request.
237
DINVALIDDATA
Decline. The authorization was already reversed.
No action required.
238
DINVALIDDATA
Decline. The transaction was already settled.
No action required.
239
DINVALIDDATA
Decline. The requested transaction amount must match the previous transaction amount.
Correct the amount and resend the request.
240
DINVALIDDATA
Decline. The card type sent is invalid or does not correlate with the credit card number.
Confirm that the card type correlates with the credit card number specified in the request, and then resend the request.
241
DINVALIDDATA
Decline. The referenced request ID is invalid for all follow-on transactions.
No action required.
242
DNOAUTH
Decline. The request ID is invalid.
You requested a capture, but there is no corresponding, unused authorization record. This issue occurs if there was not a previously successful authorization request or if the previously successful authorization was already used in another capture request.
Request a new authorization, and if successful, proceed with the capture.
243
DINVALIDDATA
Decline. The transaction was already settled or reversed.
Correct and resend the request.
246
DNOTVOIDABLE
Decline. The capture or credit cannot be voided because it was already submitted to your processor. Or, you requested a void for a type of transaction that cannot be voided.
No action required.
247
DINVALIDDATA
Decline. You requested a credit for a capture that was voided.
Correct and resend the request.
248
DBOLETODECLINED
Decline. The Boleto request was declined by your processor.
Correct and resend the request.
250
ETIMEOUT
Error. The request was received, but a timeout occurred at the payment processor.
To avoid duplicating the transaction, do not resend the request until you review the transaction status in the Business Center.
251
DCARDREFUSED
Decline. The PINless debit card's use frequency or maximum amount per use was exceeded.
Request a different payment card or other form of payment.
254
DINVALIDDATA
Decline. Account is prohibited from processing stand-alone refunds.
Submit a follow-on credit by including a request ID in the credit request. A follow-on credit must be requested within 60 days of the authorization.
To process stand-alone credits, contact your account representative to find out if your processor supports stand-alone credits.
400
DSCORE
Soft decline. Fraud score exceeds threshold.
You can capture the authorization, but consider reviewing the order for the possibility of fraud.
450
DINVALIDADDRESS
Apartment number missing or not found.
Ask the customer to verify the address information and resend the request.
451
DINVALIDADDRESS
Insufficient address information.
Ask the customer to verify the address information and resend the request.
452
DINVALIDADDRESS
House/box number not found on street.
Ask the customer to verify the address information and resend the request.
453
DINVALIDADDRESS
Multiple address matches were found.
Ask the customer to verify the address information and resend the request.
454
DINVALIDADDRESS
P.O. Box identifier not found or out of range.
Ask the customer to verify the address information and resend the request.
455
DINVALIDADDRESS
Route service identifier not found or out of range.
Ask the customer to verify the address information and resend the request.
456
DINVALIDADDRESS
Street name not found in postal code.
Ask the customer to verify the address information and resend the request.
457
DINVALIDADDRESS
Postal code not found in database.
Ask the customer to verify the address information and resend the request.
458
DINVALIDADDRESS
Unable to verify or correct address.
Ask the customer to verify the address information and resend the request.
459
DINVALIDADDRESS
Multiple address matches were found (international).
Ask the customer to verify the address information and resend the request.
460
DINVALIDADDRESS
Address match not found. No reason given.
Ask the customer to verify the address information and resend the request.
461
DINVALIDADDRESS
Unsupported character set.
Verify the character set that you are using to process transactions.
475
DAUTHENTICATE
The cardholder is enrolled in Payer Authentication.
Authenticate the cardholder before continuing with the transaction.
476
DAUTHENTICATIONFAILED
Encountered a Payer Authentication problem. Payer could not be authenticated.
Authenticate the cardholder before continuing with the transaction.
480
DREVIEW
The order is marked for review by
Decision Manager
.
Depending on your permissions, you can:
  • Accept, reject, or settle the order.
  • Void or reverse the authorization.
  • Take no action. If no action is taken, the order will be rejected after 30 days.
481
DREJECT
The order was rejected by
Decision Manager
.
Depending on your permissions, you can:
  • Convert the order to an Accepted status.
  • If the authorization has not been sent to the payment processor for settlement, it can be voided.
  • If the authorization has been sent to the payment processor for settlement but is not yet settled, it can be reversed.
  • If the transaction has an authorization code, it can be settled.
490
DAGGREJECTED
Your aggregator or acquirer is not accepting transactions from you at this time.
Contact your acquirer or payment technology partner.
491
DAGGDENIED
Your aggregator or acquirer is not accepting this transaction.
Contact your acquirer or payment technology partner.
520
DSETTINGS
Soft decline. The authorization request was approved by the issuing bank but was declined based on your Smart Authorization settings.
Do not capture the authorization without further review. Review the
ccAuthReply_avsCode
,
ccAuthReply_cvCode
, and
ccAuthReply_authFactorCode
fields to determine why the request was rejected.
700
DRESTRICTED
The customer matched the Denied Parties List.
Reject the customer's order.
701
DRESTRICTED
Export
bill_country/ship_country
match.
Reject the customer's order.
702
DRESTRICTED
Export
email_country
match.
Reject the customer's order.
703
DRESTRICTED
Export
hostname_country/ip_country
match.
Reject the customer's order.