OrderTransactionErrorCode gains granular payment decline codes
Admin API 2026-04 adds granular OrderTransactionErrorCode values such as INSUFFICIENT_FUNDS, AUTHENTICATION_FAILED, FRAUD_SUSPECTED and CARD_TESTING that identify why a payment failed.
Read the official Shopify source01 · Source fact
What changed
Admin API 2026-04 adds granular OrderTransactionErrorCode values such as INSUFFICIENT_FUNDS, AUTHENTICATION_FAILED, FRAUD_SUSPECTED and CARD_TESTING that identify why a payment failed.
- Published
- Mar 16, 2026
- Effective
- API version 2026-04
- Deadline
- No explicit deadline stated
02 · Business impact
Who and what may be affected
- Operators
- Seller, Agency
- Surfaces
- Admin Api, Transaction Events
- Impact
- Operations, Technical
- Settlement categories
- No direct payout category identified
03 · Next action
What to check
Extend failed-payment handling to recognize the new decline codes instead of collapsing unknown values, and use them to drive retry and customer-recovery flows.
confirmed source relationshipLast reviewed Jul 26, 2026