DisableEventsResponse

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/square/main/json-schema/square-disable-events-response-schema.json",
  "title": "DisableEventsResponse",
  "description": "Defines the fields that are included in the response body of\na request to the [DisableEvents](api-endpoint:Events-DisableEvents) endpoint.\n\nNote: if there are errors processing the request, the events field will not be\npresent.",
  "x-generated": "2026-10-12",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/square-events-api-openapi.yml#/components/schemas/DisableEventsResponse",
  "type": "object",
  "x-release-status": "BETA",
  "properties": {
    "errors": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/Error"
      },
      "description": "Information on errors encountered during the request."
    }
  },
  "$defs": {
    "Error": {
      "type": "object",
      "description": "Represents an error encountered during a request to the Connect API.\n\nSee [Handling errors](https://developer.squareup.com/docs/build-basics/handling-errors) for more information.",
      "x-release-status": "PUBLIC",
      "required": [
        "category",
        "code"
      ],
      "properties": {
        "category": {
          "$ref": "#/$defs/ErrorCategory",
          "description": "The high-level category for the error.\nSee [ErrorCategory](#type-errorcategory) for possible values"
        },
        "code": {
          "$ref": "#/$defs/ErrorCode",
          "description": "The specific code of the error.\nSee [ErrorCode](#type-errorcode) for possible values"
        },
        "detail": {
          "type": "string",
          "description": "A human-readable description of the error for debugging purposes."
        },
        "field": {
          "type": "string",
          "description": "The name of the field provided in the original request (if any) that\nthe error pertains to."
        }
      }
    },
    "ErrorCategory": {
      "type": "string",
      "enum": [
        "API_ERROR",
        "AUTHENTICATION_ERROR",
        "INVALID_REQUEST_ERROR",
        "RATE_LIMIT_ERROR",
        "PAYMENT_METHOD_ERROR",
        "REFUND_ERROR",
        "MERCHANT_SUBSCRIPTION_ERROR",
        "EXTERNAL_VENDOR_ERROR"
      ],
      "x-enum-elements": [
        {
          "name": "API_ERROR",
          "description": "An error occurred with the Connect API itself."
        },
        {
          "name": "AUTHENTICATION_ERROR",
          "description": "An authentication error occurred. Most commonly, the request had\na missing, malformed, or otherwise invalid `Authorization` header."
        },
        {
          "name": "INVALID_REQUEST_ERROR",
          "description": "The request was invalid. Most commonly, a required parameter was\nmissing, or a provided parameter had an invalid value."
        },
        {
          "name": "RATE_LIMIT_ERROR",
          "description": "Your application reached the Square API rate limit. You might receive this error if your application sends a high number of requests\nto Square APIs in a short period of time.\n\nYour application should monitor responses for `429 RATE_LIMITED` errors and use a retry mechanism with an [exponential backoff](https://en.wikipedia.org/wiki/Exponential_backoff)\nschedule to resend the requests at an increasingly slower rate. It is also a good practice to use a randomized delay (jitter) in your retry schedule."
        },
        {
          "name": "PAYMENT_METHOD_ERROR",
          "description": "An error occurred while processing a payment method. Most commonly,\nthe details of the payment method were invalid (such as a card's CVV\nor expiration date)."
        },
        {
          "name": "REFUND_ERROR",
          "description": "An error occurred while attempting to process a refund."
        },
        {
          "name": "MERCHANT_SUBSCRIPTION_ERROR",
          "description": "An error occurred when checking a merchant subscription status"
        },
        {
          "name": "EXTERNAL_VENDOR_ERROR",
          "description": "An error that is returned from an external vendor's API"
        }
      ],
      "description": "Indicates which high-level category of error has occurred during a\nrequest to the Connect API.",
      "x-release-status": "PUBLIC"
    },
    "ErrorCode": {
      "type": "string",
      "enum": [
        "INTERNAL_SERVER_ERROR",
        "UNAUTHORIZED",
        "ACCESS_TOKEN_EXPIRED",
        "ACCESS_TOKEN_REVOKED",
        "CLIENT_DISABLED",
        "FORBIDDEN",
        "INSUFFICIENT_SCOPES",
        "APPLICATION_DISABLED",
        "V1_APPLICATION",
        "V1_ACCESS_TOKEN",
        "CARD_PROCESSING_NOT_ENABLED",
        "MERCHANT_SUBSCRIPTION_NOT_FOUND",
        "BAD_REQUEST",
        "MISSING_REQUIRED_PARAMETER",
        "INCORRECT_TYPE",
        "INVALID_TIME",
        "INVALID_TIME_RANGE",
        "INVALID_VALUE",
        "INVALID_CURSOR",
        "UNKNOWN_QUERY_PARAMETER",
        "CONFLICTING_PARAMETERS",
        "EXPECTED_JSON_BODY",
        "INVALID_SORT_ORDER",
        "VALUE_REGEX_MISMATCH",
        "VALUE_TOO_SHORT",
        "VALUE_TOO_LONG",
        "VALUE_TOO_LOW",
        "VALUE_TOO_HIGH",
        "VALUE_EMPTY",
        "ARRAY_LENGTH_TOO_LONG",
        "ARRAY_LENGTH_TOO_SHORT",
        "ARRAY_EMPTY",
        "EXPECTED_BOOLEAN",
        "EXPECTED_INTEGER",
        "EXPECTED_FLOAT",
        "EXPECTED_STRING",
        "EXPECTED_OBJECT",
        "EXPECTED_ARRAY",
        "EXPECTED_MAP",
        "EXPECTED_BASE64_ENCODED_BYTE_ARRAY",
        "INVALID_ARRAY_VALUE",
        "INVALID_ENUM_VALUE",
        "INVALID_CONTENT_TYPE",
        "INVALID_FORM_VALUE",
        "CUSTOMER_NOT_FOUND",
        "ONE_INSTRUMENT_EXPECTED",
        "NO_FIELDS_SET",
        "TOO_MANY_MAP_ENTRIES",
        "MAP_KEY_LENGTH_TOO_SHORT",
        "MAP_KEY_LENGTH_TOO_LONG",
        "CUSTOMER_MISSING_NAME",
        "CUSTOMER_MISSING_EMAIL",
        "INVALID_PAUSE_LENGTH",
        "INVALID_DATE",
        "UNSUPPORTED_COUNTRY",
        "UNSUPPORTED_CURRENCY",
        "APPLE_TTP_PIN_TOKEN",
        "CARD_EXPIRED",
        "INVALID_EXPIRATION",
        "INVALID_EXPIRATION_YEAR",
        "INVALID_EXPIRATION_DATE",
        "UNSUPPORTED_CARD_BRAND",
        "UNSUPPORTED_ENTRY_METHOD",
        "INVALID_ENCRYPTED_CARD",
        "INVALID_CARD",
        "PAYMENT_AMOUNT_MISMATCH",
        "GENERIC_DECLINE",
        "CVV_FAILURE",
        "ADDRESS_VERIFICATION_FAILURE",
        "INVALID_ACCOUNT",
        "CURRENCY_MISMATCH",
        "INSUFFICIENT_FUNDS",
        "INSUFFICIENT_PERMISSIONS",
        "CARDHOLDER_INSUFFICIENT_PERMISSIONS",
        "INVALID_LOCATION",
        "TRANSACTION_LIMIT",
        "VOICE_FAILURE",
        "PAN_FAILURE",
        "EXPIRATION_FAILURE",
        "CARD_NOT_SUPPORTED",
        "INVALID_PIN",
        "MISSING_PIN",
        "MISSING_ACCOUNT_TYPE",
        "INVALID_POSTAL_CODE",
        "INVALID_FEES",
        "MANUALLY_ENTERED_PAYMENT_NOT_SUPPORTED",
        "PAYMENT_LIMIT_EXCEEDED",
        "GIFT_CARD_AVAILABLE_AMOUNT",
        "ACCOUNT_UNUSABLE",
        "BUYER_REFUSED_PAYMENT",
        "DELAYED_TRANSACTION_EXPIRED",
        "DELAYED_TRANSACTION_CANCELED",
        "DELAYED_TRANSACTION_CAPTURED",
        "DELAYED_TRANSACTION_FAILED",
        "CARD_TOKEN_EXPIRED",
        "CARD_TOKEN_USED",
        "AMOUNT_TOO_HIGH",
        "UNSUPPORTED_INSTRUMENT_TYPE",
        "REFUND_AMOUNT_INVALID",
        "REFUND_ALREADY_PENDING",
        "PAYMENT_NOT_REFUNDABLE",
        "PAYMENT_NOT_REFUNDABLE_DUE_TO_DISPUTE",
        "REFUND_DECLINED",
        "INSUFFICIENT_PERMISSIONS_FOR_REFUND",
        "INVALID_CARD_DATA",
        "SOURCE_USED",
        "SOURCE_EXPIRED",
        "UNSUPPORTED_LOYALTY_REWARD_TIER",
        "LOCATION_MISMATCH",
        "IDEMPOTENCY_KEY_REUSED",
        "UNEXPECTED_VALUE",
        "SANDBOX_NOT_SUPPORTED",
        "INVALID_EMAIL_ADDRESS",
        "INVALID_PHONE_NUMBER",
        "CHECKOUT_EXPIRED",
        "BAD_CERTIFICATE",
        "INVALID_SQUARE_VERSION_FORMAT",
        "API_VERSION_INCOMPATIBLE",
        "CARD_PRESENCE_REQUIRED",
        "UNSUPPORTED_SOURCE_TYPE",
        "CARD_MISMATCH",
        "PLAID_ERROR",
        "PLAID_ERROR_ITEM_LOGIN_REQUIRED",
        "PLAID_ERROR_RATE_LIMIT",
        "CARD_DECLINED",
        "VERIFY_CVV_FAILURE",
        "VERIFY_AVS_FAILURE",
        "CARD_DECLINED_CALL_ISSUER",
        "CARD_DECLINED_VERIFICATION_REQUIRED",
        "BAD_EXPIRATION",
        "CHIP_INSERTION_REQUIRED",
        "ALLOWABLE_PIN_TRIES_EXCEEDED",
        "RESERVATION_DECLINED",
        "UNKNOWN_BODY_PARAMETER",
        "NOT_FOUND",
        "APPLE_PAYMENT_PROCESSING_CERTIFICATE_HASH_NOT_FOUND",
        "METHOD_NOT_ALLOWED",
        "NOT_ACCEPTABLE",
        "REQUEST_TIMEOUT",
        "CONFLICT",
        "GONE",
        "REQUEST_ENTITY_TOO_LARGE",
        "UNSUPPORTED_MEDIA_TYPE",
        "UNPROCESSABLE_ENTITY",
        "RATE_LIMITED",
        "NOT_IMPLEMENTED",
        "BAD_GATEWAY",
        "SERVICE_UNAVAILABLE",
        "TEMPORARY_ERROR",
        "GATEWAY_TIMEOUT"
      ],
      "x-enum-elements": [
        {
          "name": "INTERNAL_SERVER_ERROR",
          "description": "A general server error occurred.",
          "error-category": "API_ERROR"
        },
        {
          "name": "UNAUTHORIZED",
          "description": "A general authorization error occurred.",
          "error-category": "AUTHENTICATION_ERROR"
        },
        {
          "name": "ACCESS_TOKEN_EXPIRED",
          "description": "The provided access token has expired.",
          "error-category": "AUTHENTICATION_ERROR"
        },
        {
          "name": "ACCESS_TOKEN_REVOKED",
          "description": "The provided access token has been revoked.",
          "error-category": "AUTHENTICATION_ERROR"
        },
        {
          "name": "CLIENT_DISABLED",
          "description": "The provided client has been disabled.",
          "error-category": "AUTHENTICATION_ERROR"
        },
        {
          "name": "FORBIDDEN",
          "description": "A general access error occurred.",
          "error-category": "AUTHENTICATION_ERROR"
        },
        {
          "name": "INSUFFICIENT_SCOPES",
          "description": "The provided access token does not have permission\nto execute the requested action.",
          "error-category": "AUTHENTICATION_ERROR"
        },
        {
          "name": "APPLICATION_DISABLED",
          "description": "The calling application was disabled.",
          "error-category": "INVALID_REQUEST_ERROR"
        },
        {
          "name": "V1_APPLICATION",
          "description": "The calling application was created prior to\n2016-03-30 and is not compatible with v2 Square API calls.",
          "error-category": "INVALID_REQUEST_ERROR"
        },
        {
          "name": "V1_ACCESS_TOKEN",
          "description": "The calling application is using an access token\ncreated prior to 2016-03-30 and is not compatible with v2 Square API\ncalls.",
          "error-category": "INVALID_REQUEST_ERROR"
        },
        {
          "name": "CARD_PROCESSING_NOT_ENABLED",
          "description": "The location provided in the API call is not\nenabled for credit card processing.",
          "error-category": "INVALID_REQUEST_ERROR"
        },
        {
          "name": "MERCHANT_SUBSCRIPTION_NOT_FOUND",
          "description": "A required subscription was not found for the merchant",
          "error-category": "MERCHANT_SUBSCRIPTION_ERROR"
        },
        {
          "name": "BAD_REQUEST",
          "description": "A general error occurred with the request.",
          "error-category": "INVALID_REQUEST_ERROR"
        },
        {
          "name": "MISSING_REQUIRED_PARAMETER",
          "description": "The request is missing a required path, query, or\nbody parameter.",
          "error-category": "INVALID_REQUEST_ERROR"
        },
        {
          "name": "INCORRECT_TYPE",
          "description": "The value provided in the request is the wrong\ntype. For example, a string instead of an integer.",
          "error-category": "INVALID_REQUEST_ERROR"
        },
        {
          "name": "INVALID_TIME",
          "description": "Formatting for the provided time value is\nincorrect.",
          "error-category": "INVALID_REQUEST_ERROR"
        },
        {
          "name": "INVALID_TIME_RANGE",
          "description": "The time range provided in the request is invalid.\nFor example, the end time is before the start time.",
          "error-category": "INVALID_REQUEST_ERROR"
        },
        {
          "name": "INVALID_VALUE",
          "description": "The provided value is invalid. For example,\nincluding `%` in a phone number.",
          "error-category": "INVALID_REQUEST_ERROR"
        },
        {
          "name": "INVALID_CURSOR",
          "description": "The pagination cursor included in the request is\ninvalid.",
          "error-category": "INVALID_REQUEST_ERROR"
        },
        {
          "name": "UNKNOWN_QUERY_PARAMETER",
          "description": "The query parameters provided is invalid for the\nrequested endpoint.",
          "error-category": "INVALID_REQUEST_ERROR"
        },
        {
          "name": "CONFLICTING_PARAMETERS",
          "description": "One or more of the request parameters conflict with\neach other.",
          "error-category": "INVALID_REQUEST_ERROR"
        },
        {
          "name": "EXPECTED_JSON_BODY",
          "description": "The request body is not a JSON object.",
          "error-category": "INVALID_REQUEST_ERROR"
        },
        {
          "name": "INVALID_SORT_ORDER",
          "description": "The provided sort order is not a valid key.\nCurrently, sort order must be `ASC` or `DESC`.",
          "error-category": "INVALID_REQUEST_ERROR"
        },
        {
          "name": "VALUE_REGEX_MISMATCH",
          "description": "The provided value does not match an expected\nregular expression.",
          "error-category": "INVALID_REQUEST_ERROR"
        },
        {
          "name": "VALUE_TOO_SHORT",
          "description": "The provided string value is shorter than the\nminimum length allowed.",
          "error-category": "INVALID_REQUEST_ERROR"
        },
        {
          "name": "VALUE_TOO_LONG",
          "description": "The provided string value is longer than the\nmaximum length allowed.",
          "error-category": "INVALID_REQUEST_ERROR"
        },
        {
          "name": "VALUE_TOO_LOW",
          "description": "The provided value is less than the supported\nminimum.",
          "error-category": "INVALID_REQUEST_ERROR"
        },
        {
          "name": "VALUE_TOO_HIGH",
          "description": "The provided value is greater than the supported\nmaximum.",
          "error-category": "INVALID_REQUEST_ERROR"
        },
        {
          "name": "VALUE_EMPTY",
          "description": "The provided value has a default (empty) value\nsuch as a blank string.",
          "error-category": "INVALID_REQUEST_ERROR"
        },
        {
          "name": "ARRAY_LENGTH_TOO_LONG",
          "description": "The provided array has too many elements.",
          "error-category": "INVALID_REQUEST_ERROR"
        },
        {
          "name": "ARRAY_LENGTH_TOO_SHORT",
          "description": "The provided array has too few elements.",
          "error-category": "INVALID_REQUEST_ERROR"
        },
        {
          "name": "ARRAY_EMPTY",
          "description": "The provided array is empty.",
          "error-category": "INVALID_REQUEST_ERROR"
        },
        {
          "name": "EXPECTED_BOOLEAN",
          "description": "The endpoint expected the provided value to be a\nboolean.",
          "error-category": "INVALID_REQUEST_ERROR"
        },
        {
          "name": "EXPECTED_INTEGER",
          "description": "The endpoint expected the provided value to be an\ninteger.",
          "error-category": "INVALID_REQUEST_ERROR"
        },
        {
          "name": "EXPECTED_FLOAT",
          "description": "The endpoint expected the provided value to be a\nfloat.",
          "error-category": "INVALID_REQUEST_ERROR"
        },
        {
          "name": "EXPECTED_STRING",
          "description": "The endpoint expected the provided value to be a\nstring.",
          "error-category": "INVALID_REQUEST_ERROR"
        },
        {
          "name": "EXPECTED_OBJECT",
          "description": "The endpoint expected the provided value to be a\nJSON object.",
          "error-category": "INVALID_REQUEST_ERROR"
        },
        {
          "name": "EXPECTED_ARRAY",
          "description": "The endpoint expected the provided value to be an\narray or list.",
          "error-category": "INVALID_REQUEST_ERROR"
        },
        {
          "name": "EXPECTED_MAP",
          "description": "The endpoint expected the provided value to be a\nmap or associative array.",
          "error-category": "INVALID_REQUEST_ERROR"
        },
        {
          "name": "EXPECTED_BASE64_ENCODED_BYTE_ARRAY",
          "description": "The endpoint expected the provided value to be an\narray encoded in base64.",
          "error-category": "INVALID_REQUEST_ERROR"
        },
        {
          "name": "INVALID_ARRAY_VALUE",
          "description": "One or more objects in the array does not match the\narray type.",
          "error-category": "INVALID_REQUEST_ERROR"
        },
        {
          "name": "INVALID_ENUM_VALUE",
          "description": "The provided static string is not valid for the\nfield.",
          "error-category": "INVALID_REQUEST_ERROR"
        },
        {
          "name": "INVALID_CONTENT_TYPE",
          "description": "Invalid content type header.",
          "error-category": "INVALID_REQUEST_ERROR"
        },
        {
          "name": "INVALID_FORM_VALUE",
          "description": "Only relevant for applications created prior to\n2016-03-30. Indicates there was an error while parsing form values.",
          "error-category": "INVALID_REQUEST_ERROR"
        },
        {
          "name": "CUSTOMER_NOT_FOUND",
          "description": "The provided customer id can't be found in the merchant's customers list.",
          "error-category": "INVALID_REQUEST_ERROR"
        },
        {
          "name": "ONE_INSTRUMENT_EXPECTED",
          "description": "A general error occurred.",
          "error-category": "INVALID_REQUEST_ERROR"
        },
        {
          "name": "NO_FIELDS_SET",
          "description": "A general error occurred.",
          "error-category": "INVALID_REQUEST_ERROR"
        },
        {
          "name": "TOO_MANY_MAP_ENTRIES",
          "description": "Too many entries in the map field.",
          "error-category": "INVALID_REQUEST_ERROR"
        },
        {
          "name": "MAP_KEY_LENGTH_TOO_SHORT",
          "description": "The length of one of the provided keys in the map is too short.",
          "error-category": "INVALID_REQUEST_ERROR"
        },
        {
          "name": "MAP_KEY_LENGTH_TOO_LONG",
          "description": "The length of one of the provided keys in the map is too long.",
          "error-category": "INVALID_REQUEST_ERROR"
        },
        {
          "name": "CUSTOMER_MISSING_NAME",
          "description": "The provided customer does not have a recorded name.",
          "error-category": "INVALID_REQUEST_ERROR"
        },
        {
          "name": "CUSTOMER_MISSING_EMAIL",
          "description": "The provided customer does not have a recorded email.",
          "error-category": "INVALID_REQUEST_ERROR"
        },
        {
          "name": "INVALID_PAUSE_LENGTH",
          "description": "The subscription cannot be paused longer than the duration of the current phase.",
          "error-category": "INVALID_REQUEST_ERROR"
        },
        {
          "name": "INVALID_DATE",
          "description": "The subscription cannot be paused/resumed on the given date.",
          "error-category": "INVALID_REQUEST_ERROR"
        },
        {
          "name": "UNSUPPORTED_COUNTRY",
          "description": "The API request references an unsupported country.",
          "error-category": "INVALID_REQUEST_ERROR"
        },
        {
          "name": "UNSUPPORTED_CURRENCY",
          "description": "The API request references an unsupported currency.",
          "error-category": "INVALID_REQUEST_ERROR"
        },
        {
          "name": "APPLE_TTP_PIN_TOKEN",
          "description": "The payment was declined by the card issuer during an Apple Tap to Pay (TTP)\ntransaction with a request for the card's PIN. This code will be returned alongside\n`CARD_DECLINED_VERIFICATION_REQUIRED` as a supplemental error, and will include an\nissuer-provided token in the `details` field that is needed to initiate the PIN\ncollection flow on the iOS device.",
          "error-category": "PAYMENT_METHOD_ERROR"
        },
        {
          "name": "CARD_EXPIRED",
          "description": "The card issuer declined the request because the card is expired.",
          "error-category": "PAYMENT_METHOD_ERROR"
        },
        {
          "name": "INVALID_EXPIRATION",
          "description": "The expiration date for the payment card is invalid. For example,\nit indicates a date in the past.",
          "error-category": "PAYMENT_METHOD_ERROR"
        },
        {
          "name": "INVALID_EXPIRATION_YEAR",
          "description": "The expiration year for the payment card is invalid. For example,\nit indicates a year in the past or contains invalid characters.",
          "error-category": "INVALID_REQUEST_ERROR"
        },
        {
          "name": "INVALID_EXPIRATION_DATE",
          "description": "The expiration date for the payment card is invalid. For example,\nit contains invalid characters.",
          "error-category": "INVALID_REQUEST_ERROR"
        },
        {
          "name": "UNSUPPORTED_CARD_BRAND",
          "description": "The credit card provided is not from a supported issuer.",
          "error-category": "PAYMENT_METHOD_ERROR"
        },
        {
          "name": "UNSUPPORTED_ENTRY_METHOD",
          "description": "The entry method for the credit card (swipe, dip, tap) is not supported.",
          "error-category": "PAYMENT_METHOD_ERROR"
        },
        {
          "name": "INVALID_ENCRYPTED_CARD",
          "description": "The encrypted card information is invalid.",
          "error-category": "PAYMENT_METHOD_ERROR"
        },
        {
          "name": "INVALID_CARD",
          "description": "The credit card cannot be validated based on the provided details.",
          "error-category": "PAYMENT_METHOD_ERROR"
        },
        {
          "name": "PAYMENT_AMOUNT_MISMATCH",
          "description": "The payment was declined because there was a payment amount mismatch.\nThe money amount Square was expecting does not match the amount provided.",
          "error-category": "PAYMENT_METHOD_ERROR"
        },
        {
          "name": "GENERIC_DECLINE",
          "description": "Square received a decline without any additional information.\nIf the payment information seems correct, the buyer can contact their\nissuer to ask for more information.",
          "error-category": "PAYMENT_METHOD_ERROR"
        },
        {
          "name": "CVV_FAILURE",
          "description": "The card issuer declined the request because the CVV value is invalid.",
          "error-category": "PAYMENT_METHOD_ERROR"
        },
        {
          "name": "ADDRESS_VERIFICATION_FAILURE",
          "description": "The card issuer declined the request because the postal code is invalid.",
          "error-category": "PAYMENT_METHOD_ERROR"
        },
        {
          "name": "INVALID_ACCOUNT",
          "description": "The issuer was not able to locate the account on record.",
          "error-category": "PAYMENT_METHOD_ERROR"
        },
        {
          "name": "CURRENCY_MISMATCH",
          "description": "The currency associated with the payment is not valid for the provided\nfunding source. For example, a gift card funded in USD cannot be used to process\npayments in GBP.",
          "error-category": "PAYMENT_METHOD_ERROR"
        },
        {
          "name": "INSUFFICIENT_FUNDS",
          "description": "The funding source has insufficient funds to cover the payment.",
          "error-category": "PAYMENT_METHOD_ERROR"
        },
        {
          "name": "INSUFFICIENT_PERMISSIONS",
          "description": "The Square account does not have the permissions to accept\nthis payment. For example, Square may limit which merchants are\nallowed to receive gift card payments.",
          "error-category": "PAYMENT_METHOD_ERROR"
        },
        {
          "name": "CARDHOLDER_INSUFFICIENT_PERMISSIONS",
          "description": "The card issuer has declined the transaction due to restrictions on where the card can be used.\nFor example, a gift card is limited to a single merchant.",
          "error-category": "PAYMENT_METHOD_ERROR"
        },
        {
          "name": "INVALID_LOCATION",
          "description": "The Square account cannot take payments in the specified region.\nA Square account can take payments only from the region where the account was created.",
          "error-category": "PAYMENT_METHOD_ERROR"
        },
        {
          "name": "TRANSACTION_LIMIT",
          "description": "The card issuer has determined the payment amount is either too high or too low.\nThe API returns the error code mostly for credit cards (for example, the card reached\nthe credit limit). However, sometimes the issuer bank can indicate the error for debit\nor prepaid cards (for example, card has insufficient funds).",
          "error-category": "PAYMENT_METHOD_ERROR"
        },
        {
          "name": "VOICE_FAILURE",
          "description": "The card issuer declined the request because the issuer requires voice authorization from the cardholder. The seller should ask the customer to contact the card issuing bank to authorize the payment.",
          "error-category": "PAYMENT_METHOD_ERROR"
        },
        {
          "name": "PAN_FAILURE",
          "description": "The specified card number is invalid. For example, it is of\nincorrect length or is incorrectly formatted.",
          "error-category": "PAYMENT_METHOD_ERROR"
        },
        {
          "name": "EXPIRATION_FAILURE",
          "description": "The card expiration date is either invalid or indicates that the\ncard is expired.",
          "error-category": "PAYMENT_METHOD_ERROR"
        },
        {
          "name": "CARD_NOT_SUPPORTED",
          "description": "The card is not supported either in the geographic region or by\nthe [merchant category code](https://developer.squareup.com/docs/locations-api#initialize-a-merchant-category-code) (MCC).",
          "error-category": "PAYMENT_METHOD_ERROR"
        },
        {
          "name": "INVALID_PIN",
          "description": "The card issuer declined the request because the PIN is invalid.",
          "error-category": "PAYMENT_METHOD_ERROR"
        },
        {
          "name": "MISSING_PIN",
          "description": "The payment is missing a required PIN.",
          "error-category": "PAYMENT_METHOD_ERROR"
        },
        {
          "name": "MISSING_ACCOUNT_TYPE",
          "description": "The payment is missing a required ACCOUNT_TYPE parameter.",
          "error-category": "PAYMENT_METHOD_ERROR"
        },
        {
          "name": "INVALID_POSTAL_CODE",
          "description": "The postal code is incorrectly formatted.",
          "error-category": "PAYMENT_METHOD_ERROR"
        },
        {
          "name": "INVALID_FEES",
          "description": "The app_fee_money on a payment is too high.",
          "error-category": "PAYMENT_METHOD_ERROR"
        },
        {
          "name": "MANUALLY_ENTERED_PAYMENT_NOT_SUPPORTED",
          "description": "The card must be swiped, tapped, or dipped. Payments attempted by manually entering the card number are declined.",
          "error-category": "PAYMENT_METHOD_ERROR"
        },
        {
          "name": "PAYMENT_LIMIT_EXCEEDED",
          "description": "Square declined the request because the payment amount exceeded the processing limit for this merchant.",
          "error-category": "PAYMENT_METHOD_ERROR"
        },
        {
          "name": "GIFT_CARD_AVAILABLE_AMOUNT",
          "description": "When a Gift Card is a payment source, you can allow taking a partial payment\nby adding the `accept_partial_authorization` parameter in the request.\nHowever, taking such a partial payment does not work if your request also includes\n`tip_money`, `app_fee_money`, or both. Square declines such payments and returns\nthe `GIFT_CARD_AVAILABLE_AMOUNT` error.\nFor more information, see\n[CreatePayment errors (additional information)](https://developer.squareup.com/docs/payments-api/error-codes#createpayment-errors-additional-information).",
          "error-category": "PAYMENT_METHOD_ERROR"
        },
        {
          "name": "ACCOUNT_UNUSABLE",
          "description": "The account provided cannot carry out transactions.",
          "error-category": "PAYMENT_METHOD_ERROR"
        },
        {
          "name": "BUYER_REFUSED_PAYMENT",
          "description": "Bank account rejected or was not authorized for the payment.",
          "error-category": "PAYMENT_METHOD_ERROR"
        },
        {
          "name": "DELAYED_TRANSACTION_EXPIRED",
          "description": "The application tried to update a delayed-capture payment that has expired.",
          "error-category": "INVALID_REQUEST_ERROR"
        },
        {
          "name": "DELAYED_TRANSACTION_CANCELED",
          "description": "The application tried to cancel a delayed-capture payment that was already cancelled.",
          "error-category": "INVALID_REQUEST_ERROR"
        },
        {
          "name": "DELAYED_TRANSACTION_CAPTURED",
          "description": "The application tried to capture a delayed-capture payment that was already captured.",
          "error-category": "INVALID_REQUEST_ERROR"
        },
        {
          "name": "DELAYED_TRANSACTION_FAILED",
          "description": "The application tried to update a delayed-capture payment that failed.",
          "error-category": "INVALID_REQUEST_ERROR"
        },
        {
          "name": "CARD_TOKEN_EXPIRED",
          "description": "The provided card token (nonce) has expired.",
          "error-category": "INVALID_REQUEST_ERROR"
        },
        {
          "name": "CARD_TOKEN_USED",
          "description": "The provided card token (nonce) was already used to process the payment or refund.",
          "error-category": "INVALID_REQUEST_ERROR"
        },
        {
          "name": "AMOUNT_TOO_HIGH",
          "description": "The requested payment amount is too high for the provided payment source.",
          "error-category": "INVALID_REQUEST_ERROR"
        },
        {
          "name": "UNSUPPORTED_INSTRUMENT_TYPE",
          "description": "The API request references an unsupported instrument type.",
          "error-category": "INVALID_REQUEST_ERROR"
        },
        {
          "name": "REFUND_AMOUNT_INVALID",
          "description": "The requested refund amount exceeds the amount available to refund.",
          "error-category": "REFUND_ERROR"
        },
        {
          "name": "REFUND_ALREADY_PENDING",
          "description": "The payment already has a pending refund.",
          "error-category": "REFUND_ERROR"
        },
        {
          "name": "PAYMENT_NOT_REFUNDABLE",
          "description": "The payment is not refundable. For example, the payment is too old to be refunded.",
          "error-category": "REFUND_ERROR"
        },
        {
          "name": "PAYMENT_NOT_REFUNDABLE_DUE_TO_DISPUTE",
          "description": "The payment is not refundable because it has been disputed.",
          "error-category": "REFUND_ERROR"
        },
        {
          "name": "REFUND_DECLINED",
          "description": "Request failed - The card issuer declined the refund.",
          "error-category": "REFUND_ERROR"
        },
        {
          "name": "INSUFFICIENT_PERMISSIONS_FOR_REFUND",
          "description": "The Square account does not have the permissions to process this refund.",
          "error-category": "REFUND_ERROR"
        },
        {
          "name": "INVALID_CARD_DATA",
          "description": "Generic error - the provided card data is invalid.",
          "error-category": "INVALID_REQUEST_ERROR"
        },
        {
          "name": "SOURCE_USED",
          "description": "The provided source id was already used to create a ca

# --- truncated at 32 KB (40 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/square/refs/heads/main/json-schema/square-disable-events-response-schema.json