Order Transaction Error Code
A standardized error code, independent of the payment provider.
Anchor to Valid valuesValid values
- 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 CALL_ISSUERCALL_
ISSUER Call the card issuer.
- Anchor to CARD_DECLINEDCARD_
DECLINED The card was declined.
- Anchor to CONFIG_ERRORCONFIG_
ERROR There is an error in the gateway or merchant configuration.
- Anchor to EXPIRED_CARDEXPIRED_
CARD The card is expired.
- Anchor to GENERIC_ERRORGENERIC_
ERROR There was an unknown error with processing the payment.
- Anchor to INCORRECT_ADDRESSINCORRECT_
ADDRESS The address does not match the card number.
- Anchor to INCORRECT_CVCINCORRECT_
CVC The CVC does not match the card number.
- Anchor to INCORRECT_NUMBERINCORRECT_
NUMBER The card number is incorrect.
- Anchor to INCORRECT_PININCORRECT_
PIN The entered PIN is incorrect.
- Anchor to INCORRECT_ZIPINCORRECT_
ZIP The ZIP or postal code does not match the card number.
- Anchor to INVALID_AMOUNTINVALID_
AMOUNT The amount is either too high or too low for the provider.
- Anchor to INVALID_COUNTRYINVALID_
COUNTRY The payment method is not available in the customer's country.
- 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 PAYMENT_METHOD_UNAVAILABLEPAYMENT_
METHOD_ UNAVAILABLE The payment method is momentarily unavailable.
- 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 TEST_MODE_LIVE_CARDTEST_
MODE_ LIVE_ CARD A real card was used but the gateway was in test mode.
- 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 the
object 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 a
kind
that defines the type of transaction and astatus
that 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.