Error Codes – Credit Card

The table below describes the error codes returned for credit card payments.

IDError CodeMessageReturnDescription
1INVALID_CVVInvalid CVC. Must contain 3 digits.200When cardSecurityCode has a length different from 3 digits and/or is not numeric.
2INVALID_MONTH_NUMBERInvalid expiration date. Invalid month number.200When the expiration month is invalid.
3INCORRECT_EXPIRATION_DATEInvalid expiration date. Correct format is mmYYYY.200When cardExpirationDate doesn't follow the correct format (mmYYYY).
4EXPIRATION_DATE_NON_NUMERICExpiration date contains non-numeric characters.200When cardExpirationDate contains non-numeric characters.
5MSG_GENERAL_ERRORUnknown card brand.200When cardNumber has more than 19 digits or is empty.
6AMOUNT_MISMATCHGeneral error.500Transaction refund without sending the "type" field.
7AMOUNT_GREATER_THAN_PRE_AUTHORIZEDCannot authorize an amount greater than the pre-authorized amount.200Transaction capture where the amount exceeds the original transaction amount.
8PRE_AUTH_ALREADY_CANCELEDCannot cancel a pre-authorization that has already been completed.200Attempt to refund after the original pre-authorization was already canceled.
9CAPTURE_ALREADY_CANCELEDThe pre-authorization was canceled.200Attempt to capture a transaction that was already canceled.
10DEBIT_NOT_SUPPORTEDDebit pre-authorization is not supported.200Attempt to pre-authorize a debit transaction.
11DEBIT_NOT_SUPPORTEDDebit capture is not supported.200Attempt to capture a debit transaction.
12TRANSACTION_ALREADY_COMPLETEDThe transaction has already been completed.200Attempt to capture a transaction that has already been captured.
13MSG_GENERAL_ERRORThe original transaction has not been fully processed or does not exist.200When the original pre-authorization has not yet been processed by Dock.
14AMOUNT_REQUIREDAmount is required.400Transaction without the amount field.
15MSG_VALIDATION_ERRORThe following fields are required: expirationDate.200Transaction without the cardExpirationDate field.
16CURRENCY_MISMATCHCurrency is required.400Transaction without the "currency" field.
17INVALID_DEBIT_INSTALLMENTDebit transactions must have exactly 1 installment.200When installments is greater than 1 for a debit transaction.
18MUID_ABSENTMUID is required.200Transaction without the muid field.
19TRACKING_NUMBER_REQUIREDTracking number is required.400Transaction without the trackingNumber field.
20AMOUNT_MISMATCHThe provided amount differs from the original transaction amount.200Refund with an amount different from the original transaction.
21ALREADY_CANCELEDThe original transaction has already been canceled.200Attempt to refund a sale that has already been canceled.
22ORIGINAL_TRANSACTION_MISMATCHThe original transaction has not been fully processed or does not exist.200When the original transaction was not fully processed by Dock.
23TRANSACTION_TYPE_MISMATCHThe original transaction type does not match the expected type or doesn't exist.200When the refund or reversal type does not match the original transaction type.
24ORIGINAL_TRANSACTION_STATUS_MISMATCHThe original transaction cannot be reversed.200Attempt to reverse a transaction that is not in "Pending" status.
25ORIGINAL_CYCLE_MISSINGTrackingNumber or MUID not found!200When the gateway cannot find the original financial cycle.
26INVALID_VISA_MVVInvalid Visa MVV code.200When the visaMvv field is invalid. Must be a 10 character alphanumeric string.
27MSG_AUTHORIZATION_TOKEN_NOT_VALIDInvalid authorization token.401Unauthorized initialization token.
28MAX_INSTALLMENTSMaximum number of installments exceeded.400The number of installments cannot exceed 12.
29MIN_INSTALLMENTSMinimum number of installments not reached.400The number of installments cannot be less than 1.
30AMOUNT_NOT_SUPPORTEDAmount cannot exceed 100 million.400Amounts above 100 million are not supported.
31AMOUNT_OUT_OF_BOUNDSAmount out of bounds (more than 2 decimal places).400When the value has more than two digits after the decimal point.
32AUTHORIZER_REJECTEDRejected by card issuer.422Amounts above 100 million are not supported.