--- title: OrderTransactionErrorCode - GraphQL Admin description: 'A standardized error code, independent of the payment provider.' api_version: 2026-10 source_url: html: >- https://shopify.dev/docs/api/admin-graphql/latest/enums/OrderTransactionErrorCode md: >- https://shopify.dev/docs/api/admin-graphql/latest/enums/OrderTransactionErrorCode.md api_name: admin api_type: graphql type: enum --- # Order​Transaction​Error​Code enum A standardized error code, independent of the payment provider. ## Valid values * AMAZON\_​PAYMENTS\_​INVALID\_​PAYMENT\_​METHOD The payment method was invalid. * AMAZON\_​PAYMENTS\_​MAX\_​AMOUNT\_​CHARGED The maximum amount has been captured. * AMAZON\_​PAYMENTS\_​MAX\_​AMOUNT\_​REFUNDED The maximum amount has been refunded. * AMAZON\_​PAYMENTS\_​MAX\_​AUTHORIZATIONS\_​CAPTURED The maximum of 10 authorizations has been captured for an order. * AMAZON\_​PAYMENTS\_​MAX\_​REFUNDS\_​PROCESSED The maximum of 10 refunds has been processed for an order. * AMAZON\_​PAYMENTS\_​ORDER\_​REFERENCE\_​CANCELED The order was canceled, which canceled all open authorizations. * AMAZON\_​PAYMENTS\_​STALE The order was not confirmed within three hours. * AMOUNT\_​TOO\_​LARGE The transaction amount exceeds the maximum amount allowed. * AMOUNT\_​TOO\_​SMALL The transaction amount is below the minimum amount allowed. * AUTHENTICATION\_​FAILED The 3D Secure authentication failed. * AUTHENTICATION\_​REQUIRED The transaction requires 3D Secure authentication but was attempted without authentication. * AUTHORIZATION\_​EXPIRED The authorization has expired. * CALL\_​ISSUER The issuer declined the transaction, the customer should contact their issuer for more details. * CANCELLED\_​PAYMENT The transaction was cancelled. * CARD\_​DECLINED The card was declined. * CARD\_​TESTING The transaction was declined due to suspected card testing activity. * CONFIG\_​ERROR There is an error in the gateway or merchant configuration. * DO\_​NOT\_​HONOR The issuer declined the transaction without providing a specific reason. * EXPIRED\_​CARD The card is expired. * FRAUD\_​SUSPECTED The transaction was declined due to suspected fraudulent activity. * GENERIC\_​ERROR There was an unknown error with processing the payment. * INCORRECT\_​ADDRESS The address is incorrect. * INCORRECT\_​CVC The card security code (CVC/CVV) is incorrect. * INCORRECT\_​NUMBER The card number is incorrect. * INCORRECT\_​PIN The PIN entered is incorrect. * INCORRECT\_​ZIP The ZIP or postal code doesn't match the one on file. * INSTRUMENT\_​DECLINED The payment instrument was declined. * INSUFFICIENT\_​FUNDS There are insufficient funds available to complete the transaction. * INVALID\_​AMOUNT The amount is invalid. * INVALID\_​COUNTRY The payment method is not available in the customer's country. * INVALID\_​CURRENCY The currency isn't supported. * INVALID\_​CVC The format of the CVC is incorrect. * INVALID\_​EXPIRY\_​DATE The format of the expiry date is incorrect. * INVALID\_​NUMBER The format of the card number is incorrect. * INVALID\_​PAYMENT\_​METHOD The payment method is invalid or not found. * INVALID\_​PURCHASE\_​TYPE This payment method doesn't support the requested transaction type. * MERCHANT\_​ACCOUNT\_​ERROR The transaction couldn't be processed due to an issue with the merchant account. * MERCHANT\_​RULE The transaction was blocked due to the merchant's custom payment risk rule. * PAYMENT\_​METHOD\_​UNAVAILABLE The payment method is momentarily unavailable. * PAYMENT\_​METHOD\_​UNSUPPORTED The payment method isn't supported. * PAYMENT\_​PROVIDER\_​ERROR The transaction couldn't be processed due to an unexpected error with the payment provider. * PICK\_​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. * PROCESSING\_​ERROR There was an error while processing the payment. * RETRY\_​DECLINED The transaction retry attempt was declined. * TEST\_​MODE\_​LIVE\_​CARD A real card was used but the gateway was in test mode. * TRANSACTION\_​LIMIT\_​EXCEEDED The payment instrument has exceeded the processing frequency limit. * UNSUPPORTED\_​FEATURE The gateway or merchant configuration doesn't support a feature, such as network tokenization. *** ## Fields * [Order​Transaction.errorCode](https://shopify.dev/docs/api/admin-graphql/latest/objects/OrderTransaction#field-OrderTransaction.fields.errorCode) OBJECT The `OrderTransaction` 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 `OrderTransaction` 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 `OrderTransaction` 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 `OrderTransaction` object has a [`kind`](https://shopify.dev/docs/api/admin-graphql/latest/enums/OrderTransactionKind) that defines the type of transaction and a [`status`](https://shopify.dev/docs/api/admin-graphql/latest/enums/OrderTransactionStatus) 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](https://help.shopify.com/manual/payments) and [payment gateway integrations](https://www.shopify.com/ca/payment-gateways). *** ## Map ### Fields with this enum * [Order​Transaction.errorCode](https://shopify.dev/docs/api/admin-graphql/latest/objects/OrderTransaction#field-OrderTransaction.fields.errorCode)