Secure Payments Error Reference
The table below outlines the error codes returned by our Secure Payments API. These codes are designed to help identify specific issues with payment transactions, ranging from invalid data to unauthorized access, or disabled features for merchants. Each error is paired with a corresponding HTTP status code to clarify the type of error encountered.
| Error Code | Description | Status Code |
|---|---|---|
| Key_InvalidRequest | The request is invalid because it is empty and contains no data. Ensure that your request includes the necessary information. | 400 |
| Key_InvalidMerchant | The merchant ID provided is invalid. Verify the merchant credentials and try again. | 400 |
| Key_MerchantInActive | The merchant account is inactive. | 400 |
| Key_InvalidAccountToken | The account token provided is invalid. Check the 'AccountToken' value and submit the request again. | 400 |
| UnAuthorized | Access is denied due to PCI compliance being disabled. | 401 |
| Key_NotAllowedTypeAnytimePayment | The anytime payment type is not allowed. Review your payment type settings. | 400 |
| Key_InvalidBatch | The batch ID provided is invalid. Verify the 'batchID' value and try again. | 400 |
| Key_BatchIsNotActiveState | The batch is not in an active state and cannot be processed. Ensure the batch is active and retry. | 400 |
| Key_BatchIsReady | The batch is prepared and ready for processing. | 400 |
| Key_AccountHolderNameCannotBeNullOrEmpty | The account holder's name is required and cannot be null or empty. Please verify the 'AccountHolderName' value. | 400 |
| Key_CardHolderNameCannotBeNullOrEmpty | The cardholder's name is required and cannot be null or empty. Please verify the 'CardHolderName' value | 400 |
| Key_ChannelTypeACHCannotHaveCardHolderName | The ACH channel type does not require a cardholder’s name. Remove the 'CardHolderName’ value for ACH transactions. | 400 |
| Key_ChannelTypeCardCannotHaveAccountHolderName | The card payment method cannot include an account holder’s name. Remove the 'AccountHolderName' value and try again. | 400 |
| Key_InvalidAmount | The payment amount is invalid. Provide a valid 'PaymentAmount' value and retry. | 400 |
| Key_CaptchaValidationError | CAPTCHA validation failed. Verify the CAPTCHA response and resubmit the request. | 400 |
| Key_ReCaptchaTokenInvalid | The CAPTCHA token provided is invalid. Please refresh the CAPTCHA and provide a new token. | 400 |
| Key_InvalidToken | The payment intent token is invalid. Ensure the token is correct and try again. | 400 |
| Key_AnytimePayments | The Anytime Payments feature is disabled for this merchant. | 400 |
| Key_InvalidPaymentLink | The payment link provided is invalid. Verify the payment link and try again. | 400 |
| Key_SaveForFutureCanNotBeFalseForCreateToken | The 'Save for Future' option cannot be false when creating a token. | 400 |
| Key_AndDoneJs | The AndDoneJs feature is disabled for this merchant. Enable this feature in your settings to proceed. | 400 |
| Key_PaymentLink | The Payment Link feature is disabled for this merchant. Enable this feature in your settings to proceed. | 400 |
| Key_BillingContactCannotBeNullOrEmpty | The billing contact information is required and cannot be null or empty. | 400 |
| Key_EmailIdCannotBeNullOrEmpty | The email ID is required and cannot be null or empty. Please complete the 'EmailId' value and try again. | 400 |
| Key_PhoneNoCannotBeNullOrEmpty | The phone number is required and cannot be null or empty. Provide a valid 'phone' number and retry | 400 |
| Key_FirstNameCannotBeNullOrEmpty | The first name is required and cannot be null or empty. Provide a valid 'firstName' and retry. | 400 |
| Key_LastNameCannotBeNullOrEmpty | The last name is required and cannot be null or empty. Provide a valid 'lastName' and retry. | 400 |
| Key_InvalidTokenLink | The token link provided is invalid. Verify the token link and try again. | 400 |
| Key_InvalidPaymentIntent | The payment intent provided is invalid. Verify the payment intent and resubmit the request. | 400 |
| Key_TokenLinkExpired | The token link has expired and cannot be used. Request a new token link. | 400 |
| Key_TokenLinkIsFailed | The token link has failed. Please try again later. | 400 |
| Key_TokenLinkAlreadyProcessed | The token link has already been processed and cannot be reused. | 400 |
| Key_PaymentIntentExpired | The payment intent has expired. Create a new payment intent to proceed. | 400 |
| Key_PaymentIntentAlreadyProcessed | The payment intent has already been processed. Ensure you are using a valid and active payment intent. | 400 |
| Key_PaymentLinkExpired | The payment link has expired and cannot be used. Request a new payment link. | 400 |
| Key_PaymentLinkAlreadyProcessed | The payment link has already been processed and cannot be reused. | 400 |
| Key_CreateAccountTokenCanNotFalseforZeroAuth | The 'Create account token' option cannot be set to false for zero amount authorization. | 400 |
| Key_InvalidMerchantId | The merchant ID provided is invalid. Verify the 'merchantID' and try again. | 400 |
| Key_SplitPayments | The Split Payments feature is disabled for this merchant. Contact support to enable this feature. | 401 |
| Key_ChargeIndicatorNotSetToAnddoenDefaultAccount | The charge indicator is not set to the AndDone default account. Adjust your charge indicator settings and try again. | 400 |
| Key_AndDonePayments | The AndDone Payments feature is disabled for this merchant. Contact support to enable this feature. | 401 |
| Key_OriginAccess | The Origin Access feature is disabled for this merchant. Contact support to enable this feature. | 401 |
| Key_SuppressTransaction | The Suppress Transaction feature is enabled. Transactions cannot be processed while this setting is active. | 401 |
| Key_ACHTokenizedPayment | The ACH Tokenized Payment feature is disabled for this merchant. Contact support to enable this feature. | 401 |
| Key_CardTokenizedPayment | The Card Tokenized Payment feature is disabled for this merchant. Contact support to enable this feature. | 401 |
| Key_InvalidCardDetails | The card details provided are invalid. Verify the card information and try again. | 400 |
| Key_ChannelTypeNotMatchedWithCardNumber | The payment channel type does not match the provided card number. Ensure the channel type and card number align. | 400 |
| Key_TokenizedPayment | The Tokenized Payment feature is disabled for this merchant. Contact support to enable this feature. | 401 |
| Key_EnterNonNegativeAmount | Payment search error: The amount provided cannot be negative. | 400 |
| Key_FromAmountCantBeGreaterToAmount | Payment search error: The 'From amount' cannot be greater than the 'To amount'. | 400 |