---
title: >-
  New Error codes and updated error code mapping for payment and billing -
  Shopify developer changelog
description: >-
  Shopify’s developer changelog documents all changes to Shopify’s platform.
  Find the latest news and learn about new platform opportunities.
source_url:
  html: >-
    https://shopify.dev/changelog/new-error-codes-and-updated-error-code-mapping-for-payment-and-billing
  md: >-
    https://shopify.dev/changelog/new-error-codes-and-updated-error-code-mapping-for-payment-and-billing.md
metadata:
  effectiveApiVersion: 2024-04
  affectedApi:
    - displayName: Admin GraphQL API
      handle: admin-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: Update
    handle: update
  indicatesActionRequired: true
  createdAt: '2024-03-06T15:49:21-05:00'
  postedAt: '2024-04-01T00:00:00-04:00'
  updatedAt: '2024-03-08T14:13:11-05:00'
  effectiveAt: '2024-04-01T00:00:00-04:00'
---

[Back to Developer changelog](https://shopify.dev/changelog)

April 1, 2024

Tags:

* Action Required
* Admin GraphQL API
* 2024-04

# New Error codes and updated error code mapping for payment and billing

As of 2024-04, Added the following fields to the `SubscriptionBillingAttemptErrorCode` enum

* `InsufficientFunds`
* `PurchaseTypeNotSupported`
* `Paypal Error`
* `CardNumberIncorrect`
* `FraudSuspected`

Additionally, the following payment error code mappings have changed:

* “Insufficient Funds” has been removed from “Invalid Payment Method” and now receives its own billing attempt error
* “Pick up card” has been removed from “Payment Method Declined” and is now classified as “Fraud Suspected”
* “Invalid Item Total” has been added to “Payment Method Declined”

And the following codes from payment processors have changed:

* [Braintree](https://developer.paypal.com/braintree/articles/control-panel/transactions/declines)

  * 2007 now maps to “Card Number Incorrect”
  * 2014 now maps to “Fraud Suspected”
  * 2105 now maps to “Transient Error”
  * 2106 now maps to “Transient Error”
  * 2107 now maps to “Invalid Payment Method”
  * 2108 now maps to “Invalid Payment Method”

* [Paypal](https://developer.paypal.com/api/nvp-soap/errors/)

  * 10417 now maps to “Paypal Error General”

* [Stripe](https://docs.stripe.com/declines/codes)

  * card\_not\_supported now maps to “Invalid Purchase Type”
  * invalid\_account now maps to “Card Number Incorrect”
  * invalid\_amount now maps to “Payment Method Declined”