Netvalve API Error Codes

Owned by Yogesh Dahe
Last updated: Aug 09, 2024
7 min read

ContentBody{} FormattedBody{value='

HTTP Response Codes

200 Sucess

401 Unauthorised

404 Bad request

500 Service Unavailable

 

Netvalve Error Codes

TRANSACTION_SUCCESSFULLY_COMPLETED("GTW_1000", "Transaction Approved/ Request Successful."), REQUEST_SUCCESS("GTW_1001", "Request Successful."), INVALID_MERCHANT("GTW_2000", "Invalid Merchant ID. Kindly contact Netvalve support."), REQUIRED_CVV("GTW_2001", "Missing CVV Value, Required For e-Commerce Transaction."), INVALID_AMOUNT("GTW_2002", "Amount Value Missing."), INVALID_DECIMALS_AMOUNT("GTW_2003", "Amount Value Should Be With Two Decimals."), AMOUNT_MUST_BE_A_POSITIVE_INTEGER("GTW_2004", "Amount Value Must Be A Positive Integer."), INVALID_CARD_NUMBER("GTW_2005", "Invalid Card Number Format."), INVALID_CVV("GTW_2006", "Card Verification Code (CVC) or Card Verification Value (CVV) Must Be 3 or 4 Digits."), INVALID_CUSTOMER_IP("GTW_2007", "Invalid Customer IP. Customer IP Address Must Match The Regular IP Address Format."), AMOUNT_SMALLER_THAN_DEFINED_LOWER_LIMIT("GTW_2008", "Amount Value Incorrect. The Amount Is Smaller Than The Defined Lower Limit."), AMOUNT_GREATER_THAN_DEFINED_LOWER_LIMIT("GTW_2009", "Amount Value Incorrect. The Amount Is Greater Than The Defined Upper Limit."), REQUIRED_ADDRESS("GTW_2010", "Address Missing. This Value Must Be Provided."), REQUIRED_ZIP("GTW_2011", "ZIP Code Missing. This Value Must Be Provided."), REQUIRED_COUNTRY_CODE("GTW_2012", "Country Code Missing. This Value Must Be Provided."), INVALID_TRANSACTION_OPERATION("GTW_2013", "Invalid Gateway Transaction Operation/ Invalid GTO."), CITY_LENGTH("GTW_2014", "City Name Can Have 128 Characters Max."), STATE_LENGTH("GTW_2015", "State Name Can Have 30 Characters Max."), PHONE_LENGTH("GTW_2016", "Phone Number Can Have 20 Characters Max."), ZIP_LENGTH("GTW_2017", "Customer ZIP Code Can Have 10 Characters Max."), CURRENCY_VALUE_IS_REQUIRED("GTW_2018", "Currency Value Missing. This Value Must Be Provided."), INVALID_CURRENCY_CODE("GTW_2019", "Invalid Currency Code."), CLIENT_ORDER_CHARACTERS("GTW_2020", "Client Order Can Have 100 Characters Max."), REQUIRED_CARD_HOLDER_NAME("GTW_2021", "Card Holder Name Is Missing. This Value Must Be Provided."), CARD_HOLDER_NAME_LENGTH("GTW_2022", "Card Holder Name Can Have 128 Characters Max."), REQUIRED_CARD_EXPIRE_MONTH("GTW_2023", "Card Expiry Month Is Missing. This Value Must Be Provided."), CARD_EXPIRE_MONTH_VALUE("GTW_2024", "Card Expiry Month Should Be Between 01 And 12."), REQUIRED_CUSTOMER_NAME("GTW_2025", "Customer First Name Is Missing. This Value Must Be Required."), CUSTOMER_NAME_LENGTH("GTW_2026", "Customer First Name Can Have 128 Characters Max."), CUSTOMER_ADDRESS_LENGTH("GTW_2027", "Customer Address Can Have 128 Characters Max."), EMAIL_LENGTH("GTW_2028", "Email Address Must Have Less Than 128 Characters."), INVALID_EMAIL("GTW_2029", "Email Address Invalid."), INVALID_CUSTOMER_COUNTRY_CODE("GTW_2030", "Country Code Invalid."), CUSTOMER_COUNTRY_CODE_LENGTH("GTW_2031", "Country Code Must Have 2 Characters."), REQUIRED_CARD_NUMBER("GTW_2032", "Card Number Is Missing. This Value Must Be Provided."), CARD_NUMBER_LENGTH("GTW_2033", "Card Number Can Have 40 Characters Max."), VALID_CARD_NUMBER("GTW_2034", "Card Number Invalid."), REQUIRED_CARD_EXPIRE_YEAR("GTW_2035", "Card Expiry Year Is Missing. This Value Must Be Provided."), REQUIRED_CUSTOMER_LAST_NAME("GTW_2036", "Customer Last Name Is Missing. This Value Must Be Provided."), CUSTOMER_LAST_NAME_LENGTH("GTW_2037", "Customer Last Name Can Have 128 Characters Max."), INVALID_CAPTURE_AMOUNT("GTW_2038", "Invalid Value/ Amount Does Not Match/ Captured Amount Must Be Equal To Reference Transaction Amount."), EMPTY_ACCOUNT_NAME("GTW_2039", "Account Name Is Missing. This Value Must Be Provided."), ACCOUNT_NAME_LENGTH("GTW_2040", "Account Name Can Have 20 Characters Max."), EMPTY_DESCRIPTOR("GTW_2041", "Descriptor Is Missing. This Value Must Be Provided."), DESCRIPTOR_LENGTH("GTW_2042", "Descriptor Name Can Have 20 Characters Max."), INPUT_FIELD_VALUE("GTW_2043", "This Field Is Required! It May Contain Alphanumeric Characters, Lowercase Or Uppercase. Special Characters Are Not Allowed!"), INVALID_SETTLEMENT_AMOUNT("GTW_2044", "Invalid Value/ Amount Does Not Match/ Settlement Amount Must Be less than Reference Transaction Amount."), TRANSACTION_ALREADY_REFUNDED("GTW_2045", "Transaction Already Refunded."), TRANSACTION_ALREADY_CAPTURED("GTW_2046", "Transaction Already Captured."), TRANSACTION_ALREADY_CANCELED("GTW_2047", "Transaction Already Cancelled."), MANDATORY_TRANSACTION_ID("GTW_2048", "Transaction ID Is Missing. This Value Must Be Provided."), TRANSACTION_ALREADY_IN_PENDING("GTW_2049", "Transaction Status Pending."), BANK_CREDENTIALS_ERROR("GTW_2050", "Band Credentials Invalid/ Bank Credentials Are Empty."), EMP_TRANSACTION_ERROR("GTW_2051", "Transaction Failed On EMERCHANTPAY (EMP) Server."), TSYS_TRANSACTION_ERROR("GTW_2052", "Transaction Failed On TSYS Server."), EPX_TRANSACTION_ERROR("GTW_2053", "Transaction Failed On EPX Server."), TRANSACTION_TIMEOUT("GTW_2054", "Transaction Response Timeout."), NON_EXISTING_CODE("GTW_2055", "Undefined."), TRANSACTION_REFUND_ALREADY_CAPTURED("GTW_2056", "Refund Transaction Is Already Captured."), INVALID_RECURRING_SCHEDULING_TYPE_ENUM("GTW_2057", "Recurring schedule type must be any of this values {enumValues}"), INVALID_INDUSTRY_CODE_ENUM("GTW_2058", "Industry code must be any of this values {enumValues}"), INVALID_AMOUNT_PRECISION("GTW_2059", "Amount should be less than maximum allowed."), INVALID_PARTIAL_AUTHORIZATION_INDICATOR("GTW_2060", "Partial authorization indicator must be any of this values {enumValues}"), INVALID_DM_TXN_MODE_INDICATOR("GTW_2061", "Direct Marketing Txn Mode indicator must be any of this values {enumValues}"), INVALID_TRANSACTION_TYPE_ENUM("GTW_2062", "Transaction Type/mode must be any of this values {enumValues}"), NOT_NULL("GTW_2063", "Invalid Value / Null Value"), TRANSACTION_RETRY_ERROR("GTW_2064", "Transaction max retry exceeded."), DUPLICATE_CLIENT_ORDER("GTW_2065", "Client Order Id Duplicate."), CARD_EXPIRE_YEAR_VALUE("GTW_2066", "Card Expiry Year Should Be Between 2000 And 2999."), STATUS_ENUM("GTW_2067", "Status must be any of this values {enumValues}"), INVALID_PHONE_NUMBER("GTW_2068", "Invalid Phone number"), SECURITY_TYPE_ENUM("GTW_2069", "SecurityType must be any of this values {enumValues}"), ORDER_ALREADY_PAID("GTW_2070", "Order already paid."), KEY_USAGE_ENUM("GTW_2071", "KeyUsage must be any of this values {enumValues}"), DUPLICATE_CARD_DETAILS("GTW_2072", "Card details already used for this transaction , try with different card details "), PASSWORD_INPUT_FIELD_VALUE("GTW_2073", "This Field Is Required! It May Contain Alphanumeric Characters (Lowercase Or Uppercase) and Special Characters!"), PAGE_LAYOUT_FILE_TYPE_ENUM("GTW_2074", "File type must be any of this values {enumValues}"), URL_FIELD_VALUE("GTW_2075", "This Field is not valid URL!"), CARD_NOT_ALLOWED("GTW_2076", "{card} card not allowed for this operation!"), INPUT_FIELD_VALIDATION("GTW_2079", "This Field Is Required! It May Contain Alphanumeric Characters, Lowercase Or Uppercase. Some Special Characters Are Not Allowed!"), RYVYL_TRANSACTION_ERROR("GTW_2080", "Transaction Failed On RYVYL Server."), RECURRING_NOT_ALLOWED("GTW_2081", "Recurring not allowed as parent transaction not marked for Recurring"), INVALID_CLIENT("GTW_2082", "Invalid Client ID. Kindly contact Netvalve support."), RANK_REQUIRED("GTW_2083", "Rank field is required."), PERCENTAGE_DISTRIBUTIONS_REQUIRED("GTW_2084", "Percentage distributions field is required."), MID_ID_REQUIRED("GTW_2085", "MID id field is required."), MAX_TICKET_AMOUNT_REQUIRED("GTW_2086", "Max ticket amount field is required."), OVERALL_LIMIT_REQUIRED("GTW_2087", "Overall limit field is required."), PCT_REQUIRED("GTW_2088", "PCT field is required."), BLOCKED_CARD("GTW_4000", "Card Is Blocked."), BLOCKED_EMAIL("GTW_4001", "Email Address Is Blocked."), CUSTOMER_IP_IS_BLOCKED("GTW_4002", "Customer IP Is Blocked."), INVALID_CONFIGURATION_NAME("GTW_4003", "Invalid configuration name."), AUTHENTICATION_FAILURE("GTW_9001", "Authentication failure! Kindly contact Netvalve support."), AUTHENTICATION_FAILURE_HPP_RESTRICTED("GTW_9002", "Authorization failure! You are not allowed to access the API. Kindly contact Netvalve support."), TRANSACTION_ERROR("GTW_9999", "Transaction Processing Error"), DECLINED_BY_ISSUER("BNK_2000", "Refer To Card Issuer."), AMOUNT_NO_LONGER_AVAILABLE("BNK_2001", "Amount No Longer Available."), INVALID_CARD("BNK_2002", "Invalid Account/Card Number (no such number exists)."), AUTHORIZATION_DECLINED("BNK_2003", "Authorization Declined."), CARD_EXPIRED("BNK_2004", "Expired Card."), HIGHER_REFERENCING_TRANSACTION("BNK_2010", "Invalid Value/ Amount Does Not Match."), CARD_ISSUER_UNKNOWN("BNK_3000", "No Such Card Issuer."), CARD_ISSUER_NOT_APPROVED("BNK_3001", "Card Issuer Not Approved."), LOST_CARD("BNK_3002", "Lost Card - Pick Up."), STOLEN_CARD("BNK_3003", "Stolen Card - Pick Up."), EXPIRED_CARD("BNK_3004", "Expired Card - Pick Up."), CARD_NOT_AUTHORIZED("BNK_3005", "Card Number Not Found In Authorizer Database."), // Rule Engine 1000 is only for Approval, RULE_REQUEST_SUCCESS("SMR_1000", "Request Successful."), RULE_REQUEST_SUCCESS_NETVALVE_MID("SMR_1001", "Request Successful:- Fetched Netvalve Default Mid"), RULE_REQUEST_SUCCESS_SITE_DEFAULT_MID("SMR_1002", "Request Successful:- Fetched Site Default Mid"), // Rule Engine 2000 series for error RULE_REQUEST_ERROR("SMR_2000", "Rule Processing Error. "), RULE_MISSING_MANDATORY_PARAM_ERROR("SMR_2001", "Rule Processing Error:- ClientId or Site Id Is Missing. This Value Must Be Provided. "), RULE_NO_SITE_ERROR("SMR_2002", "Rule Processing Error:- Site or default site not present for given client.");

 

Netvalve Common 3DS Error Codes

// 1000 series for Approval, THREE_DS_SUCCESS("3DS_1000", "Three DS Transaction Successful."), THREE_DS_REQUEST_SUCCESS("3DS_1001", "Request Successful."), // 2000 series for error THREE_DS_ERROR("3DS_2000", "Three DS Transaction Processing Error. "), THREE_DS_REQUIRED_CALL_BACK_URL("3DS_2001", "Event Callback Url Is Missing. This Value Must Be Provided."), THREE_DS_NOT_CONFIGURED("3DS_2002", "Mid Not configured for 3DS. Kindly contact Netvalve support."), THREE_DS_INVALID_MERCHANT("3DS_2003", "Invalid Merchant ID. Kindly contact Netvalve support."), THREE_DS_TRANSACTION_ID_REQUIRED("3DS_2004", "Three DS Transaction Id Is Missing. This Value Must Be Provided."), THREE_DS_CHALLENGE_INDICATOR_REQUIRED("3DS_2005", "Challenge Indicator Is Missing. This Value Must Be Provided."), THREE_DS_BROWSER_INFO_REQUIRED("3DS_2006", "Browser Info token Is Missing. This Value Must Be Provided."), THREE_DS_DF_REF_ID_REQUIRED("3DS_2007", "DF Reference Id Is Missing. This Value Must Be Provided."), THREE_DS_GATEWAY_ERROR("3DS_2008", "Three DS Transaction Processing Error from Gateway. Kindly contact Netvalve support."), THREE_DS_IMPL_TYPE_REQUIRED("3DS_2009", "3DS implementation type Is Missing. This Value Must Be Provided."), THREE_DS_DEVICE_DATA_NOT_COLLECTED("3DS_2010", "3DS device data not collected by browser or authentication attempted."), THREE_DS_ACS_NOT_COMPLETED("3DS_2011", "3DS ACS not completed by user or authentication attempted."),

 

3DS Provider-specific error codes

('CARDINAL' , '3DS_2101' , 'Card authentication failed' ) ('CARDINAL' , '3DS_2102' , 'Unknown device' ) ('CARDINAL' , '3DS_2103' , 'Unsupported device' ) ('CARDINAL' , '3DS_2104' , 'Exceeds authentication frequency limit' ) ('CARDINAL' , '3DS_2105' , 'Expired card' ) ('CARDINAL' , '3DS_2106' , 'Invalid card number' ) ('CARDINAL' , '3DS_2107' , 'Invalid transaction' ) ('CARDINAL' , '3DS_2108' , 'No card record' ) ('CARDINAL' , '3DS_2109' , 'Security failure' ) ('CARDINAL' , '3DS_2110' , 'Stolen card' ) ('CARDINAL' , '3DS_2111' , 'Suspected fraud' ) ('CARDINAL' , '3DS_2112' , 'Transaction not permitted for cardholder' ) ('CARDINAL' , '3DS_2113' , 'Cardholder not enrolled in service' ) ('CARDINAL' , '3DS_2114' , 'Transaction timed out at ACS' ) ('CARDINAL' , '3DS_2115' , 'Low confidence' ) ('CARDINAL' , '3DS_2116' , 'Medium confidence' ) ('CARDINAL' , '3DS_2117' , 'High confidence' ) ('CARDINAL' , '3DS_2118' , 'Very high confidence' ) ('CARDINAL' , '3DS_2119' , 'Exceeds ACS maximum challenges' ) ('CARDINAL' , '3DS_2120' , 'Non-payment transaction not supported' ) ('CARDINAL' , '3DS_2121' , '3RI transaction not supported' ) ('CARDINAL' , '3DS_2122' , 'ACS technical issue' ) ('CARDINAL' , '3DS_2123' , 'Decoupled Authentication required by ACS but not requested by 3DS Requestor' ) ('CARDINAL' , '3DS_2124' , '3DS Requestor decoupled max expiry time exceeded' ) ('CARDINAL' , '3DS_2125' , 'Decoupled Authentication was provided insufficient time to authenticate cardholder. ACS will not make attempt' ) ('CARDINAL' , '3DS_2126' , 'Authentication attempted but not performed by the cardholder' ) ('CARDINAL' , '3DS_2180' , 'Error connecting to ACS / Returned on all Data Only authentications / PAN/Token not eligible for SafeKey' ) ('CARDINAL' , '3DS_2181' , 'ACS timed out / Challenge exemption accepted / Message version number not supported by ACS for PAN/Token' ) ('CARDINAL' , '3DS_2182' , 'Invalid response from ACS / Challenge Mandate requested but could not be performed' ) ('CARDINAL' , '3DS_2183' , 'System Error response from ACS / DS dropped reason code received from ACS' ) ('CARDINAL' , '3DS_2184' , 'VMID not eligible for requested program' ) ('CARDINAL' , '3DS_2185' , 'VMID not eligible for requested program' ) ('CARDINAL' , '3DS_2186' , 'Protocol version not supported by ACS' ) ('CARDINAL' , '3DS_2187' , 'Transaction is excluded from Attempts Processing (includes non- reloadable pre-paid cards and non-payments (NPA)) / Device Channel is 3RI therefore did not route to Smart Authentication Stand-In' ) ('CARDINAL' , '3DS_2188' , 'Requested program not supported by ACS' ) ('RYVYL' , '3DS_2015' , 'Card authentication failed' ) ('RYVYL' , '3DS_2016' , 'Unknown Device' ) ('RYVYL' , '3DS_2017' , 'Unsupported Device' ) ('RYVYL' , '3DS_2018' , 'Exceeds authentication frequency limit' ) ('RYVYL' , '3DS_2019' , 'Expired card' ) ('RYVYL' , '3DS_2020' , 'Invalid card number' ) ('RYVYL' , '3DS_2021' , 'Invalid transaction' ) ('RYVYL' , '3DS_2022' , 'No Card record' ) ('RYVYL' , '3DS_2023' , 'Security failure' ) ('RYVYL' , '3DS_2024' , 'Stolen card' ) ('RYVYL' , '3DS_2025' , 'Suspected fraud' ) ('RYVYL' , '3DS_2026' , 'Transaction not permitted to cardholder' ) ('RYVYL' , '3DS_2027' , 'Cardholder not enrolled in service' ) ('RYVYL' , '3DS_2028' , 'Transaction timed out at the ACS' ) ('RYVYL' , '3DS_2029' , 'Exceeds ACS maximum challenges' )