generated: '2026-08-08'
method: derived
source: graphql/bulletproof-storefront.graphql (CompletionErrorCode, plus the PAYMENTS_* members of CartErrorCode
  and SubmissionErrorCode)
note: Bulletproof is a direct-to-consumer merchant, not a payment processor, so it publishes no decline-code
  reference of its own. These are the payment-failure codes its own live Storefront GraphQL schema returns
  when a cart submission or checkout completion fails. Complements errors/bulletproof-problem-types.yml,
  which covers API-level errors.
envelope_field: CartSubmitForCompletionResult / CompletionError.code and SubmissionError.code
masked_to_buyers: not published
decline_codes:
- code: ERROR
- code: INVENTORY_RESERVATION_ERROR
- code: PAYMENT_ERROR
- code: PAYMENT_TRANSIENT_ERROR
- code: PAYMENT_AMOUNT_TOO_SMALL
- code: PAYMENT_GATEWAY_NOT_ENABLED_ERROR
- code: PAYMENT_INSUFFICIENT_FUNDS
- code: PAYMENT_INVALID_PAYMENT_METHOD
- code: PAYMENT_INVALID_CURRENCY
- code: PAYMENT_INVALID_CREDIT_CARD
- code: PAYMENT_INVALID_BILLING_ADDRESS
- code: PAYMENT_CARD_DECLINED
- code: PAYMENT_CALL_ISSUER
related_payment_codes:
  CartErrorCode:
  - PAYMENT_METHOD_NOT_SUPPORTED
  - PAYMENT_METHOD_NOT_APPLICABLE
  - PAYMENTS_CREDIT_CARD_BASE_EXPIRED
  - PAYMENTS_CREDIT_CARD_BASE_GATEWAY_NOT_SUPPORTED
  - PAYMENTS_CREDIT_CARD_GENERIC
  - PAYMENTS_CREDIT_CARD_MONTH_INCLUSION
  - PAYMENTS_CREDIT_CARD_NUMBER_INVALID
  - PAYMENTS_CREDIT_CARD_NUMBER_INVALID_FORMAT
  - PAYMENTS_CREDIT_CARD_VERIFICATION_VALUE_BLANK
  - PAYMENTS_CREDIT_CARD_VERIFICATION_VALUE_INVALID_FOR_CARD_TYPE
  - PAYMENTS_CREDIT_CARD_YEAR_EXPIRED
  - PAYMENTS_CREDIT_CARD_YEAR_INVALID_EXPIRY_YEAR
  SubmissionErrorCode:
  - PAYMENTS_ADDRESS1_INVALID
  - PAYMENTS_ADDRESS1_REQUIRED
  - PAYMENTS_ADDRESS1_TOO_LONG
  - PAYMENTS_ADDRESS2_INVALID
  - PAYMENTS_ADDRESS2_REQUIRED
  - PAYMENTS_ADDRESS2_TOO_LONG
  - PAYMENTS_CITY_INVALID
  - PAYMENTS_CITY_REQUIRED
  - PAYMENTS_CITY_TOO_LONG
  - PAYMENTS_COMPANY_INVALID
  - PAYMENTS_COMPANY_REQUIRED
  - PAYMENTS_COMPANY_TOO_LONG
  - PAYMENTS_COUNTRY_REQUIRED
  - PAYMENTS_CREDIT_CARD_BASE_EXPIRED
  - PAYMENTS_CREDIT_CARD_BASE_GATEWAY_NOT_SUPPORTED
  - PAYMENTS_CREDIT_CARD_BASE_INVALID_START_DATE_OR_ISSUE_NUMBER_FOR_DEBIT
  - PAYMENTS_CREDIT_CARD_BRAND_NOT_SUPPORTED
  - PAYMENTS_CREDIT_CARD_FIRST_NAME_BLANK
  - PAYMENTS_CREDIT_CARD_GENERIC
  - PAYMENTS_CREDIT_CARD_LAST_NAME_BLANK
  - PAYMENTS_CREDIT_CARD_MONTH_INCLUSION
  - PAYMENTS_CREDIT_CARD_NAME_INVALID
  - PAYMENTS_CREDIT_CARD_NUMBER_INVALID
  - PAYMENTS_CREDIT_CARD_NUMBER_INVALID_FORMAT
  - PAYMENTS_CREDIT_CARD_SESSION_ID
  - PAYMENTS_CREDIT_CARD_VERIFICATION_VALUE_BLANK
  - PAYMENTS_CREDIT_CARD_VERIFICATION_VALUE_INVALID_FOR_CARD_TYPE
  - PAYMENTS_CREDIT_CARD_YEAR_EXPIRED
  - PAYMENTS_CREDIT_CARD_YEAR_INVALID_EXPIRY_YEAR
  - PAYMENTS_FIRST_NAME_INVALID
  - PAYMENTS_FIRST_NAME_REQUIRED
  - PAYMENTS_FIRST_NAME_TOO_LONG
  - PAYMENTS_INVALID_POSTAL_CODE_FOR_COUNTRY
  - PAYMENTS_INVALID_POSTAL_CODE_FOR_ZONE
  - PAYMENTS_LAST_NAME_INVALID
  - PAYMENTS_LAST_NAME_REQUIRED
  - PAYMENTS_LAST_NAME_TOO_LONG
  - PAYMENTS_METHOD_UNAVAILABLE
  - PAYMENTS_METHOD_REQUIRED
  - PAYMENTS_UNACCEPTABLE_PAYMENT_AMOUNT
  - PAYMENTS_PHONE_NUMBER_INVALID
  - PAYMENTS_PHONE_NUMBER_REQUIRED
  - PAYMENTS_POSTAL_CODE_INVALID
  - PAYMENTS_POSTAL_CODE_REQUIRED
  - PAYMENTS_SHOPIFY_PAYMENTS_REQUIRED
  - PAYMENTS_WALLET_CONTENT_MISSING
  - PAYMENTS_BILLING_ADDRESS_ZONE_NOT_FOUND
  - PAYMENTS_BILLING_ADDRESS_ZONE_REQUIRED_FOR_COUNTRY
payment_handlers:
- com.google.pay
- dev.shopify.card
- dev.shopify.shop_pay
accepted_card_brands:
- VISA
- MASTERCARD
- AMERICAN_EXPRESS
- DISCOVER
- DINERS_CLUB
accepted_card_brands_source: https://shop.bulletproof.com/.well-known/ucp and a live paymentSettings query