The table below describes the error codes returned for credit card payments.
ID | Error Code | Message | Return | Description |
---|---|---|---|---|
1 | INVALID_CVV | Invalid CVC. Must contain 3 digits. | 200 | When cardSecurityCode has a length different from 3 digits and/or is not numeric. |
2 | INVALID_MONTH_NUMBER | Invalid expiration date. Invalid month number. | 200 | When the expiration month is invalid. |
3 | INCORRECT_EXPIRATION_DATE | Invalid expiration date. Correct format is mmYYYY. | 200 | When cardExpirationDate doesn't follow the correct format (mmYYYY). |
4 | EXPIRATION_DATE_NON_NUMERIC | Expiration date contains non-numeric characters. | 200 | When cardExpirationDate contains non-numeric characters. |
5 | MSG_GENERAL_ERROR | Unknown card brand. | 200 | When cardNumber has more than 19 digits or is empty. |
6 | AMOUNT_MISMATCH | General error. | 500 | Transaction refund without sending the "type" field. |
7 | AMOUNT_GREATER_THAN_PRE_AUTHORIZED | Cannot authorize an amount greater than the pre-authorized amount. | 200 | Transaction capture where the amount exceeds the original transaction amount. |
8 | PRE_AUTH_ALREADY_CANCELED | Cannot cancel a pre-authorization that has already been completed. | 200 | Attempt to refund after the original pre-authorization was already canceled. |
9 | CAPTURE_ALREADY_CANCELED | The pre-authorization was canceled. | 200 | Attempt to capture a transaction that was already canceled. |
10 | DEBIT_NOT_SUPPORTED | Debit pre-authorization is not supported. | 200 | Attempt to pre-authorize a debit transaction. |
11 | DEBIT_NOT_SUPPORTED | Debit capture is not supported. | 200 | Attempt to capture a debit transaction. |
12 | TRANSACTION_ALREADY_COMPLETED | The transaction has already been completed. | 200 | Attempt to capture a transaction that has already been captured. |
13 | MSG_GENERAL_ERROR | The original transaction has not been fully processed or does not exist. | 200 | When the original pre-authorization has not yet been processed by Dock. |
14 | AMOUNT_REQUIRED | Amount is required. | 400 | Transaction without the amount field. |
15 | MSG_VALIDATION_ERROR | The following fields are required: expirationDate. | 200 | Transaction without the cardExpirationDate field. |
16 | CURRENCY_MISMATCH | Currency is required. | 400 | Transaction without the "currency" field. |
17 | INVALID_DEBIT_INSTALLMENT | Debit transactions must have exactly 1 installment. | 200 | When installments is greater than 1 for a debit transaction. |
18 | MUID_ABSENT | MUID is required. | 200 | Transaction without the muid field. |
19 | TRACKING_NUMBER_REQUIRED | Tracking number is required. | 400 | Transaction without the trackingNumber field. |
20 | AMOUNT_MISMATCH | The provided amount differs from the original transaction amount. | 200 | Refund with an amount different from the original transaction. |
21 | ALREADY_CANCELED | The original transaction has already been canceled. | 200 | Attempt to refund a sale that has already been canceled. |
22 | ORIGINAL_TRANSACTION_MISMATCH | The original transaction has not been fully processed or does not exist. | 200 | When the original transaction was not fully processed by Dock. |
23 | TRANSACTION_TYPE_MISMATCH | The original transaction type does not match the expected type or doesn't exist. | 200 | When the refund or reversal type does not match the original transaction type. |
24 | ORIGINAL_TRANSACTION_STATUS_MISMATCH | The original transaction cannot be reversed. | 200 | Attempt to reverse a transaction that is not in "Pending" status. |
25 | ORIGINAL_CYCLE_MISSING | TrackingNumber or MUID not found! | 200 | When the gateway cannot find the original financial cycle. |
26 | INVALID_VISA_MVV | Invalid Visa MVV code. | 200 | When the visaMvv field is invalid. Must be a 10 character alphanumeric string. |
27 | MSG_AUTHORIZATION_TOKEN_NOT_VALID | Invalid authorization token. | 401 | Unauthorized initialization token. |
28 | MAX_INSTALLMENTS | Maximum number of installments exceeded. | 400 | The number of installments cannot exceed 12. |
29 | MIN_INSTALLMENTS | Minimum number of installments not reached. | 400 | The number of installments cannot be less than 1. |
30 | AMOUNT_NOT_SUPPORTED | Amount cannot exceed 100 million. | 400 | Amounts above 100 million are not supported. |
31 | AMOUNT_OUT_OF_BOUNDS | Amount out of bounds (more than 2 decimal places). | 400 | When the value has more than two digits after the decimal point. |
32 | AUTHORIZER_REJECTED | Rejected by card issuer. | 422 | Amounts above 100 million are not supported. |