Order
A standardized error code, independent of the payment provider.
Anchor to Valid valuesValid values
- AMAZON_PAYMENTS_INVALID_PAYMENT_METHOD
- AMAZON_PAYMENTS_MAX_AMOUNT_CHARGED
- AMAZON_PAYMENTS_MAX_AMOUNT_REFUNDED
- AMAZON_PAYMENTS_MAX_AUTHORIZATIONS_CAPTURED
- AMAZON_PAYMENTS_MAX_REFUNDS_PROCESSED
- AMAZON_PAYMENTS_ORDER_REFERENCE_CANCELED
- AMAZON_PAYMENTS_STALE
- AMOUNT_TOO_LARGE
- AMOUNT_TOO_SMALL
- AUTHENTICATION_FAILED
- AUTHENTICATION_REQUIRED
- AUTHORIZATION_EXPIRED
- CALL_ISSUER
- CANCELLED_PAYMENT
- CARD_DECLINED
- CARD_TESTING
- CONFIG_ERROR
- DO_NOT_HONOR
- EXPIRED_CARD
- FRAUD_SUSPECTED
- GENERIC_ERROR
- INCORRECT_ADDRESS
- INCORRECT_CVC
- INCORRECT_NUMBER
- INCORRECT_PIN
- INCORRECT_ZIP
- INSTRUMENT_DECLINED
- INSUFFICIENT_FUNDS
- INVALID_AMOUNT
- INVALID_COUNTRY
- INVALID_CURRENCY
- INVALID_CVC
- INVALID_EXPIRY_DATE
- INVALID_NUMBER
- INVALID_PAYMENT_METHOD
- INVALID_PURCHASE_TYPE
- MERCHANT_ACCOUNT_ERROR
- MERCHANT_RULE
- PAYMENT_METHOD_UNAVAILABLE
- PAYMENT_METHOD_UNSUPPORTED
- PAYMENT_PROVIDER_ERROR
- PICK_UP_CARD
- PROCESSING_ERROR
- RETRY_DECLINED
- TEST_MODE_LIVE_CARD
- TRANSACTION_LIMIT_EXCEEDED
- UNSUPPORTED_FEATURE
- Anchor to AMAZON_PAYMENTS_INVALID_PAYMENT_METHODAMAZON_
PAYMENTS_ INVALID_ PAYMENT_ METHOD The payment method was invalid.
- Anchor to AMAZON_PAYMENTS_MAX_AMOUNT_CHARGEDAMAZON_
PAYMENTS_ MAX_ AMOUNT_ CHARGED The maximum amount has been captured.
- Anchor to AMAZON_PAYMENTS_MAX_AMOUNT_REFUNDEDAMAZON_
PAYMENTS_ MAX_ AMOUNT_ REFUNDED The maximum amount has been refunded.
- Anchor to AMAZON_PAYMENTS_MAX_AUTHORIZATIONS_CAPTUREDAMAZON_
PAYMENTS_ MAX_ AUTHORIZATIONS_ CAPTURED The maximum of 10 authorizations has been captured for an order.
- Anchor to AMAZON_PAYMENTS_MAX_REFUNDS_PROCESSEDAMAZON_
PAYMENTS_ MAX_ REFUNDS_ PROCESSED The maximum of 10 refunds has been processed for an order.
- Anchor to AMAZON_PAYMENTS_ORDER_REFERENCE_CANCELEDAMAZON_
PAYMENTS_ ORDER_ REFERENCE_ CANCELED The order was canceled, which canceled all open authorizations.
- Anchor to AMAZON_PAYMENTS_STALEAMAZON_
PAYMENTS_ STALE The order was not confirmed within three hours.
- Anchor to AMOUNT_TOO_LARGEAMOUNT_
TOO_ LARGE The transaction amount exceeds the maximum amount allowed.
- Anchor to AMOUNT_TOO_SMALLAMOUNT_
TOO_ SMALL The transaction amount is below the minimum amount allowed.
- Anchor to AUTHENTICATION_FAILEDAUTHENTICATION_
FAILED The 3D Secure authentication failed.
- Anchor to AUTHENTICATION_REQUIREDAUTHENTICATION_
REQUIRED The transaction requires 3D Secure authentication but was attempted without authentication.
- Anchor to AUTHORIZATION_EXPIREDAUTHORIZATION_
EXPIRED The authorization has expired.
- Anchor to CALL_ISSUERCALL_
ISSUER The issuer declined the transaction, the customer should contact their issuer for more details.
- Anchor to CANCELLED_PAYMENTCANCELLED_
PAYMENT The transaction was cancelled.
- Anchor to CARD_DECLINEDCARD_
DECLINED The card was declined.
- Anchor to CARD_TESTINGCARD_
TESTING The transaction was declined due to suspected card testing activity.
- Anchor to CONFIG_ERRORCONFIG_
ERROR There is an error in the gateway or merchant configuration.
- Anchor to DO_NOT_HONORDO_
NOT_ HONOR The issuer declined the transaction without providing a specific reason.
- Anchor to EXPIRED_CARDEXPIRED_
CARD The card is expired.
- Anchor to FRAUD_SUSPECTEDFRAUD_
SUSPECTED The transaction was declined due to suspected fraudulent activity.
- Anchor to GENERIC_ERRORGENERIC_
ERROR There was an unknown error with processing the payment.
- Anchor to INCORRECT_ADDRESSINCORRECT_
ADDRESS The address is incorrect.
- Anchor to INCORRECT_CVCINCORRECT_
CVC The card security code (CVC/CVV) is incorrect.
- Anchor to INCORRECT_NUMBERINCORRECT_
NUMBER The card number is incorrect.
- Anchor to INCORRECT_PININCORRECT_
PIN The PIN entered is incorrect.
- Anchor to INCORRECT_ZIPINCORRECT_
ZIP The ZIP or postal code doesn't match the one on file.
- Anchor to INSTRUMENT_DECLINEDINSTRUMENT_
DECLINED The payment instrument was declined.
- Anchor to INSUFFICIENT_FUNDSINSUFFICIENT_
FUNDS There are insufficient funds available to complete the transaction.
- Anchor to INVALID_AMOUNTINVALID_
AMOUNT The amount is invalid.
- Anchor to INVALID_COUNTRYINVALID_
COUNTRY The payment method is not available in the customer's country.
- Anchor to INVALID_CURRENCYINVALID_
CURRENCY The currency isn't supported.
- Anchor to INVALID_CVCINVALID_
CVC The format of the CVC is incorrect.
- Anchor to INVALID_EXPIRY_DATEINVALID_
EXPIRY_ DATE The format of the expiry date is incorrect.
- Anchor to INVALID_NUMBERINVALID_
NUMBER The format of the card number is incorrect.
- Anchor to INVALID_PAYMENT_METHODINVALID_
PAYMENT_ METHOD The payment method is invalid or not found.
- Anchor to INVALID_PURCHASE_TYPEINVALID_
PURCHASE_ TYPE This payment method doesn't support the requested transaction type.
- Anchor to MERCHANT_ACCOUNT_ERRORMERCHANT_
ACCOUNT_ ERROR The transaction couldn't be processed due to an issue with the merchant account.
- Anchor to MERCHANT_RULEMERCHANT_
RULE The transaction was blocked due to the merchant's custom payment risk rule.
- Anchor to PAYMENT_METHOD_UNAVAILABLEPAYMENT_
METHOD_ UNAVAILABLE The payment method is momentarily unavailable.
- Anchor to PAYMENT_METHOD_UNSUPPORTEDPAYMENT_
METHOD_ UNSUPPORTED The payment method isn't supported.
- Anchor to PAYMENT_PROVIDER_ERRORPAYMENT_
PROVIDER_ ERROR The transaction couldn't be processed due to an unexpected error with the payment provider.
- Anchor to PICK_UP_CARDPICK_
UP_ CARD The card has been reported as lost or stolen, and the card issuer has requested that the merchant keep the card and call the number on the back.
- Anchor to PROCESSING_ERRORPROCESSING_
ERROR There was an error while processing the payment.
- Anchor to RETRY_DECLINEDRETRY_
DECLINED The transaction retry attempt was declined.
- Anchor to TEST_MODE_LIVE_CARDTEST_
MODE_ LIVE_ CARD A real card was used but the gateway was in test mode.
- Anchor to TRANSACTION_LIMIT_EXCEEDEDTRANSACTION_
LIMIT_ EXCEEDED The payment instrument has exceeded the processing frequency limit.
- Anchor to UNSUPPORTED_FEATUREUNSUPPORTED_
FEATURE The gateway or merchant configuration doesn't support a feature, such as network tokenization.
Anchor to FieldsFields
- •OBJECT
The
object represents a payment transaction that's associated with an order. An order transaction is a specific action or event that happens within the context of an order, such as a customer paying for a purchase or receiving a refund, or other payment-related activity.Use the
object to capture the complete lifecycle of a payment, from initial authorization to final settlement, including refunds and currency exchanges. Common use cases for using theobject include:- Processing new payments for orders
- Managing payment authorizations and captures
- Processing refunds for returned items
- Tracking payment status and errors
- Managing multi-currency transactions
- Handling payment gateway integrations
Each
object has akindthat defines the type of transaction and astatusthat indicates the current state of the transaction. The object stores detailed information about payment methods, gateway processing, and settlement details.Learn more about payment processing and payment gateway integrations.