Codes and Descriptions

codes and descriptions where the codes remain fixed, the descriptions may change you should not build any error handling logic based on these descriptions codes for codes and descriptions docid zrsihomuew xnrq4pbtj codes and descriptions docid zrsihomuew xnrq4pbtj codes and descriptions docid zrsihomuew xnrq4pbtj card types each card type has its own unique id direct api implementation card types id card type 0 unknown 1 visa 2 mastercard 3 visa electron 4 switch 5 solo 6 laser 7 china union pay 8 amex 9 jcb 10 maestro 11 visa debit 12 mastercard debit 13 visa purchasing 14 discover 15 carnet 16 carte bancaire 17 diners club international 18 elo 19 farmers cards 20 soriana 21 private label card 22 q card 23 style 24 true rewards 25 uatp 26 bankard 27 banamex costco mobile sdk implementation card types id card type 0 unknown 1 visa 2 mastercard 7 china union pay 8 amex 9 jcb 10 maestro 13 diners club 14 discover error types there are three types of error, each having their own response structure codes and descriptions docid zrsihomuew xnrq4pbtj codes and descriptions docid zrsihomuew xnrq4pbtj codes and descriptions docid zrsihomuew xnrq4pbtj the model and processing error response provides you with the error code and information on why the transaction request failed judopay's validation checks , and what is needed to resolve the error model errors a model error occurs when the transaction request fails judopay's validation of the fields in the request model this could be an incorrect field value, or the field has been incorrectly formatted for example missing cv2 incorrect cardnumber / expirydate incorrect number of characters example model error response structure example model error { "details" \[ { "code" 46, "fieldname" "expirydate", "message" "sorry, but the expiry date entered is in the past please check your details and try again " } ], "message" "sorry, we're unable to process your request please check your details and try again ", "code" 1, "category" 2 } you can also receive more than one model error in a response the example below details a list of errors, each corresponding to a particular field in the request list of model errors { "details" \[ { "code" 30, "fieldname" "cardnumber", "message" "sorry, it looks like the card number entered is invalid please check your details and try again " }, { "code" 31, "fieldname" "cv2", "message" "sorry, you've not supplied the 3 digit card security code please check your details and try again " } ], "message" "sorry, we're unable to process your request please check your details and try again ", "code" 1, "category" 2 } processing errors a processing error occurs when the transaction request fails judopay's account configuration and permissions validation , there is missing information in the request, or the request is stopped because of the transaction's risk rule score some processing errors are associated with authentication errors a processing error may require a change in your account's configuration and permissions, or your business requirements / business logic needs to be reflected in your payment flow for example, the following may not have been set up to reflect your business logic on your account token and secret permissions (api credentials) enforce risk rules enforce avs checks enforce cv2 checks judoid configurations currencies card schemes payment methods routing to update your account configurations and permissions, contact customer support mailto\ help\@judopay com for more information on permissions, see introduction docid\ s 8hoamytkgy13t0p657 example processing error response structure example processing error { "message" "sorry, we're currently unable to route this transaction please check your account details and try again if this issue persists, please contact customer services ", "code" 72, "category" 3 } gateway errors the transaction request has passed all judopay's validation checks the next step in the payment flow is for the gateway to perform their checks a gateway error occurs when for example, the gateway verifies the request details with the issuing bank , who declines the request as there are not enough funds in the account this response contains the receiptid the gateway error response structure follows the same structure as a successful transaction response example gateway error response structure example gateway error { "receiptid" "934833196070240256", "yourpaymentreference" "b5dcd2ca dda3 43d7 9741 4a522e0dd980", "type" "payment", "createdat" "2023 01 23t15 33 22 2975+00 00", "result" "declined", "message" "card declined", "judoid" 100042597, "merchantname" "shodan ai routing", "appearsonstatementas" "apl /shodanairouting ", "originalamount" "2,502 00", "netamount" "2,502 00", "amount" "2,502 00", "currency" "gbp", "acquirertransactionid" "35522451090210825124", "externalbankresponsecode" "", "carddetails" { "cardlastfour" "4963", "enddate" "1224", "cardtype" 11, "cardscheme" "visa", "cardfunding" "debit", "cardcategory" "electron", "cardqualifier" 0, "cardcountry" "ve", "bank" "todoticket 2004, c a " }, "consumer" { "consumertoken" "dojmka8l5uem7aze", "yourconsumerreference" "abner fay68\@example com" }, "threedsecure" { "attempted" false }, "risks" { "postcodecheck" "unknown", "cv2check" "not checked", "merchantsuggestion" "allow" } } error codes and descriptions where the codes remain fixed, the descriptions may change you should not build any error handling logic based on these descriptions the judopay transaction api uses the following error codes code description 0 sorry, an error has occurred please try again later 1 sorry, we're unable to process your request please check your details and try again 7 sorry, we were unable to authorize this request please check your details and permissions before trying again 9 sorry, we were unable to process your payment please try again later 11 sorry, we were unable to process your payment at this time your card has not been charged 12 sorry, we were unable to process your payment please check your details and try again 19 sorry, but the transaction specified was not found 21 sorry, an error has occurred please try again later 22 sorry, an error has occurred please try again later 23 please ensure your 'from' date is in dd/mm/yyyy format 24 please ensure your 'to' date is in dd/mm/yyyy format 25 we were unable to find the webpayment identified by this reference 27 this endpoint is not available as the api version requested is too low 28 this endpoint is not available as it has been deprecated for the api version requested 39 api version not supported 40 sorry, but the api version you are targeting is invalid please review this and try again 41 sorry, but the api version is missing from your header please check your details and try again 42 sorry, it looks like the preauth you are referencing has expired 43 sorry, it looks like you're trying to make a collection on an invalid transaction type collections can only be performed on preauths 45 sorry, this transaction has been voided you cannot perform a collection on a voided transaction 46 sorry, but the amount you're trying to collect is greater than the pre auth 47 sorry, but it looks like the transaction you are trying to refund is invalid refunds can only be performed on sales and collections 48 sorry, this transaction has been voided you cannot perform a refund on a voided transaction 49 sorry, but the amount you're trying to refund is greater than the original transaction 50 sorry, but it looks like the original transaction you're specifying is an invalid type for the request you're trying to perform 51 sorry, but it looks like the transaction you are trying to void has already been voided 52 sorry, but it looks like the transaction you are trying to void has already been collected 53 sorry, but it looks like the void you are trying to process is for a different amount than the original preauth 54 sorry, but we are currently unable to accept payments to this account please contact customer services 55 sorry, we're unable to find the judo id specified please confirm your judo id and try again 56 sorry, but the transaction specified was not found please check your details and try again 57 sorry, but there was no consumer found for the transaction specified please check your details and try again 58 sorry, but this transaction does not require 3d secure authorization please check you're sending authorization to the correct transaction 59 sorry, but it looks like this transaction has already been authorised via 3d secure 60 3d secure was not successful for this transaction 61 we've been unable to decrypt the supplied apple pay token please check your api client configuration in the dashboard 62 sorry, we were unable to find the transaction you have referenced in your request 63 sorry, but the transaction you are referencing was not successful 64 sorry, but it looks like you're using a test card only real cards are valid in this environment 65 sorry, but the collection request you've specified is not valid please check your details and try again 66 sorry, but we were unable to find your original transaction to refund please check your details and try again 67 sorry, but your refund request was not valid please check that the original transaction was a sale or collection, has not previously been refunded, was not for a lesser amount than your refund request 68 sorry, but your void request is not valid please check your details and try again 69 our server encountered a problem when processing your transaction 70 sorry, but it looks like the card token specified is not valid please check your details and try again 71 sorry, an error has occurred please try again later 72 sorry, we're currently unable to route this transaction please check your account details and try again if this issue persists, please contact customer services 73 sorry, but this card type is not currently supported on this account 74 the cv2 entered is invalid 76 sorry, but it appears the web payment reference you've specified is not valid 77 judo id not found, please check the judo id 78 sorry, but you are attempting to register a card with an incorrect transaction type please check your details and try again 79 sorry, but it looks you're trying to register this card with an invalid amount please check the amount of your request and try again 80 sorry, but the content type was not specified or is currently unsupported currently only application/json is supported 81 sorry, we encountered an error while authenticating your request please check your authentication details and try again if this issue continues, please contact customer services 82 sorry, the transaction you've specified has not been found please check your details and try again 84 sorry, it looks like permissions are not enabled to perform this request application permissions can be configured in the judo dashboard 85 the content type was not specified or is unsupported for the request made to the judopay api currently supported content type is limited to application/json 86 sorry, this payment has been stopped as it is a duplicate transaction 140 something went wrong encrypting card details we apologise for any inconvenience caused please try again later 150 we've been unable to decrypt the supplied encrypted payload please ensure the message has not been modified 151 the encrypted blob is for another account 152 something went wrong retrieving card details we apologise for any inconvenience caused please try again later 153 the one time token is not valid it could have expired please try again 154 your provided consumer reference is incorrect, please check your details and try again 155 sorry, but the web payment expiry date must be in the future 156 sorry, but the web payment expiry date must be within a year 157 sorry, the card authentication attempt was unsuccessful 158 sorry, but your card authentication has failed 159 sorry, but your card authentication attempt was rejected by the issuer 160 sorry, but we were unable to authenticate your card please check your details and try again 161 sorry, but the card expiry date must be in the future 162 sorry, but the card expiry date must be in the future 163 sorry, but the expiry date must be within 6 months in the past 164 unable to process transaction device is not recognised by 3ds server 165 unable to process transaction card authentication failed with 3ds server 166 unable to process transaction no record of card number found by 3ds server 167 unable to process transaction suspected fraudulent transaction indicated by 3ds server 168 unable to process transaction acs authentication request has timed out please try again 169 unable to process transaction too many challenge attempts 171 unable to process transaction security failure indicated by 3ds server 172 unable to access the click to pay decryption service, please try again later 173 unable to decrypt the click to pay payload 174 we could not complete the click to pay transaction as some information is missing 175 card not enrolled for 3d secure 2 176 status update only allowed for open payment sessions please refer to judo api documentation for more details 177 authentication was attempted but failed due to issuer response 178 authentication was attempted but failed as the card holder is not enrolled for 3d secure 2 179 unable to authenticate transaction as card number is not recognised by the issuer please try again with a different card 180 unable to authenticate transaction as device is not supported 181 unable to authenticate as this is an invalid transaction 182 unable to authenticate transaction as card authentication has failed 183 authentication rejected by the issuer due to suspected fraud 184 authentication rejected by the issuer due to invalid transaction 185 authentication rejected by the issuer as card authentication has failed 186 authentication rejected by the issuer as card used is flagged as stolen 187 authentication rejected by the issuer as the card holder is not permitted to perform this transaction 188 authentication rejected by the issuer as card number is not recognised please try again with a different card 191 this field is used to return issuer specific messages to the cardholder the exact content of this message differs per issuer 192 unable to process transaction please contact your issuing bank 193 unable to process transaction as the card holder is not enrolled for 3d secure 2 194 unable to process transaction too many authentication attempts 195 unable to process transaction as the card has expired please try again with a different card 196 unable to process transaction as the card number is invalid please try again with a different card 197 unable to process transaction as this is an invalid transaction 198 unable to process transaction please contact your issuing bank 199 unable to process transaction please contact your issuing bank 210 unable to process transaction please contact your issuing bank 211 unable to process transaction as card used is flagged as stolen 212 unable to process transaction as device is not supported 213 authentication rejected by the issuer as the card holder is not enrolled for 3d secure 2 214 authentication rejected by the issuer as the card has expired please try again with a different card 215 authentication rejected by the issuer as the card number is invalid please try again with a different card 216 authentication rejected by the issuer security failure indicated by 3ds server 217 unable to authenticate transaction please contact your issuing bank 218 unable to authenticate transaction please contact your issuing bank 219 unable to authenticate transaction security failure indicated by 3ds server 220 authentication was attempted but failed due to issuer response 400 we've been unable to decrypt the supplied android pay wallet please confirm the public key in your app and check your api client configuration in the dashboard 403 sorry, but we were unable to authenticate your request please check your details and try again 404 sorry, but the requested resource was not found please check your details and try again 472 missing account configuration details please contact the onboarding team to update your account 601 unable to decrypt the google pay payload 602 unable to access the google pay decryption service, please try again later 603 non tokenized google pay cards not supported please verify the card can be tokenized for contactless google pay payments 20000 sorry, but the applicationmodel must not be null please check your details and try again 20001 sorry, but the application reference must not be null please check your details and try again 20002 sorry, but this application has already gone live and cannot be updated via this endpoint 20003 sorry, but the product selection is missing please check your details and try again 20004 sorry, but this application has already gone live and cannot be updated via this endpoint 20005 sorry, but you have not set your api application rec id 20006 sorry, but this request is not formatted correctly please review your request and try again 20010 sorry, but the application reference must not be empty please supply a reference and try again 20011 sorry, but an application with the application reference supplied was not found please check your details and try again 20013 sorry, but you have not specified a sort type valid sort types include time descending and time ascending 20014 sorry, but the page size needs to include at least one record per page 20015 sorry, but the page size is currently limited to 500 or less 20016 sorry, but the offset supplied needs to be greater than zero 20017 sorry, but the merchant id supplied was not found please check your details and try again 20018 sorry, but the merchant id supplied was not found please check your details and try again 20021 we're unable to parse this document, please ensure it conforms to our api requirements and then try again 20022 sorry, something went wrong, please check your authentication details and judo, then try again 20023 to create a web payment, you'll need to perform a post to the url 20026 the receipt id specified is not valid for the request you are attempting 20028 permanent lockout we detected suspicious activity on this account and have locked it for your protection please contact our customer service team on 0203 503 600 to unlock your account 667003 webpayment reference is invalid 667004 judoid not found, please check the judo id 667005 this account is currently unable to accept payments please contact customer services