Error Codes
Example of error data
{
"message": "Provider Service Error",
...
"code": 34,
"isRetryable": false,
"type": "https://docs.payfurl.com/errorscodes#34"
}
Meanings:
message- payFURL standard error messagecode- payFURL standard error codeisRetryable- a flag to indicate you can retry the operation, and it may process successfully, or you cannot as it will fail againtype- a link to the error code documentation
Error Codes Table
| Code | Message | Notes |
|---|---|---|
| 0 | No Error | Default code, e.g. success. |
| 1 | Unknown Error | The error is unknown, please contact the support. |
| 2 | Invalid Amount | Amount must be bigger than 0, but not bigger than 10,000. |
| 3 | Invalid Authorise Details | Authorise Details for the provider are invalid. Need to verify request data or contact the support. |
| 4 | Invalid Capture Details | Capture was failed due to invalid Capture request details. Verify request data or contact the support. |
| 5 | Invalid Card Number | Invalid Card Number, please use correct card number. |
| 6 | Invalid CCV | Invalid CVV, please verify and use correct CVV for the card. |
| 7 | Invalid Country | Invalid Country code. See full list of countries and country codes here |
| 8 | Invalid Country for transfer | Invalid Country code for the transfer. |
| 9 | Invalid Expiry Date | Expiry Date is invalid. Please verify and use correct Expiry Date. |
| 10 | Invalid Payment Details | Invalid Payment Details. Please make sure you use valid payment information. |
| 11 | Invalid PayPal Account | Paypal Account is invalid. Please make sure you use correct Paypal Account information. |
| 12 | Invalid Refund Details | Refund Details is invalid. Please make sure you provide correct refund information. |
| 13 | Invalid Void Details | Void Details is invalid. Please make sure you provide correct void information. |
| 14 | Expired Card | Card has expired. Please use other card to process the request. |
| 15 | Insufficient Funds | Card has insufficient funds. Make sure you add more funds to the card and apply the request again. |
| 16 | Location not supported | Location is not supported. Please verify location information. |
| 17 | PayPal Billing agreement cancelled | Paypal Billing agreement cancelled. |
| 18 | 3D Secure failed | 3D Secure failed. Please contact the support for more details. |
| 19 | Account Email Unconfirmed | Account Email Unconfirmed. |
| 20 | Account Error | Account Error. |
| 21 | Account is locked or closed | Account is locked or closed. |
| 22 | Account not Authorised | Account not Authorised. |
| 23 | Account Restricted | Account Restricted. |
| 24 | Amount exceeds MaxAmount for payTo agreement | Amount exceeds MaxAmount for payTo agreement. Please verify and update the amount. |
| 25 | Amount too Large | Amount is too large. Please decrease it and try again. |
| 26 | Authentication/Authorization Error | Authentication/Authorization Error. |
| 27 | Billing Postal Code not supported | Billing Postal Code is not supported. Please update and try again. |
| 28 | Currency Compliance issues with transactions | Currency Compliance issues with transactions. |
| 29 | Currency not supported | Currency is not supported. Please change currency and try again. |
| 30 | Duplicate | Duplicate. |
| 31 | Duplicate Transaction | Duplicate Transaction. |
| 32 | Feature Unavailable | Feature Unavailable. |
| 33 | PayTo Agreement is not active | PayTo Agreement is not active. Please activate it and try again. |
| 34 | Provider Service Error | Provider Service Error. Please try again later or contact the support for more details. |
| 35 | Rate Limiting Applied | Rate Limiting Applied. |
| 36 | Receiver Account Locked | Receiver Account Locked. |
| 37 | Retry later | Retry later. |
| 38 | Sender Account Issue | Sender Account Issue. |
| 39 | Invalid ProviderId | ProviderId is invalid. Please verify and use valid CustomerId. |
| 40 | Invalid Authentication | Invalid Authentication. Please verify authentication parameters and try again. |
| 41 | Invalid Environment | Invalid Environment. Please contact the support. |
| 42 | Tokenise Card Error | Tokenise Card Error. Please verify tokenise parameters and try again. Or contact the support. |
| 43 | Transaction Error | Transaction Error. |
| 44 | Not support charge | Charge request is not supported. Please contact the support for more details. |
| 45 | Unable to refund | Unable to refund due to an error. Please verify request's parameters and try again. Or contact the support for more details. |
| 46 | Unable to charge | Unable to charge due to an error. Please verify request's parameters and try again. Or contact the support for more details. |
| 47 | Unable to capture | Unable to capture due to an error. Please verify request's parameters and try again. Or contact the support for more details. |
| 48 | Unable to void | Unable to void due to an error. Please verify request's parameters and try again. Or contact the support for more details. |
| 49 | Unable to add customer | Unable to add a customer due to an error. Please verify request's parameters and try again. Or contact the support for more details. |
| 50 | No transaction found | No transaction found. |
| 51 | Invalid or expired token | Invalid or expired token. Please update or renew token and try again. |
| 52 | Invalid CustomerId | CustomerId is invalid. Please verify and use valid CustomerId. |
| 53 | Invalid Charge | Charge is invalid. Please verify and use valid Charge. |
| 54 | Invalid Charge Status | Charge status is invalid. To process the request the charge must have correct status. |
| 55 | Invalid Card length | Invalid Card length. It must be 14 digits. |
| 56 | Invalid PaymentMethodId | PaymentMethodId is invalid. Please verify and use valid PaymentMethodId. |
| 57 | Invalid PaymentMethod | PaymentMethod is invalid. Please make sure you use correct PaymentMethod and try again. |
| 58 | Invalid Payment Type | Payment Type is invalid. It allows to be CARD only. |
| 59 | Invalid threeDSServerTransID | Invalid 3DS Server Transaction Id. |
| 60 | Invalid Transfer Amount | Invalid Transfer Amount. Transfer amount cannot be bigger then checkout amount. |
| 61 | Invalid ReferenceId | ReferenceId is invalid. Please verify reference/checkout id and try again. |
| 62 | Invalid VaultId | VaultId is invalid. Please verify and use valid VaultId. |
| 63 | No card providers configured | There is not configured any provider that can process the request. Please verify your providers list and configurations. |
| 64 | Customer has no DefaultPaymentMethodId | Default payment method is not defined for the customer. Please setup it and try again. |
| 65 | No provider found | There was not found a provider to create an agreement. Please verify your configuration and try again or contact the support. |
| 66 | No VaultId associated with this payment method | No VaultId associated with this payment method. Please make sure you create payment method with vault. |
| 67 | No transfer information provided | No transfer information provided. Please verify your request's parameters and try again. |
| 68 | Transfer larger than original charge | Total transfer amount is bigger than original charge amount. Please verify data and try again. |
| 69 | Duplicate Group reference | Duplicate Group reference. |
| 70 | Duplicate transfer reference | Duplicate transfer reference. |
| 71 | Feature Authorise & Capture is not supported by this provider | Feature Authorise & Capture is not supported by this provider. |
| 72 | Invalid CustomerId (removed) | CustomerId is invalid as it the customer was removed. Please verify and use valid CustomerId. |
| 73 | Invalid PaymentMethodId (removed) | PaymentMethodId is invalid as it the payment method was removed. Please verify and use valid PaymentMethodId. |
| 74 | Invalid Amount. Amount must be positive | Amount is invalid. It must be a positive value, e.g. > 0. |
| 75 | Feature Verify Pending is not supported by this provider | Feature Verify Pending is not supported by this provider. |
| 76 | Invalid Amount. Maximum available refund is less | Refund amount is bigger than the charge amount. Use equal to the charge amount or smaller value. Note that previous partial refunds count as well. |
| 77 | Invalid capture amount passed. Capture amount could not be more than a transaction one | Invalid capture amount passed. Capture amount could not be more than a transaction one. Use the same or smaller value. |
| 78 | Feature Partial Capture is not supported by this provider. Capture amount must be the same as a transaction one | Feature Partial Capture is not supported by this provider. Capture amount must be the same as a transaction one. Cannot be used smaller or bigger value. |
| 79 | Amount outside range for merchant | Amount is outside of a range that configured for the merchant. Please verify the range and adjust the amount before try again. |
| 80 | Gateway timeout | Provider's gateway timout. Please try to make a request again later. In case of regular occuring contact the support for more details. |
| 81 | Invalid PaymentInformation | PaymentInformation section of the request is missed. Please add the section and try again. |
| 82 | Cannot provide both ExpireDate & ExpireSeconds | The request contains both ExpireDate & ExpireSeconds. Please use one of these two fields only, either ExpireDate or ExpireSeconds. |
| 83 | Invalid ExpireDate or ExpireSeconds | The request contains invalid ExpireDate or ExpireSeconds. ExpireDate must be future date time stamp. ExpireSeconds must be bigger than 0. |
| 84 | Invalid ChargeId | ChargeId is invalid. Please verify and use valid ChargeId. |
| 85 | Cannot provide both VaultExpireDate & VaultExpireSeconds | The request contains both VaultExpireDate & VaultExpireSeconds. Please use one of these two fields only, either VaultExpireDate or VaultExpireSeconds. |
| 86 | Invalid Vault Expiry Date | Please verify VaultExpireDate or VaultExpireSeconds. VaultExpireDate must be future date time stamp. VaultExpireSeconds must be bigger than 0. |
| 87 | Invalid TokenId | TokenId is invalid. Please verify and use valid TokenId. |
| 88 | Invalid TransferId | TransferId is invalid. Please verify and use valid TransferId. |
| 89 | Invalid Notification Format | Transaction notification format is invalid. Please verify integration with the webhook. |
| 90 | Validation Error | Validation Error occurs when request data has incorrect or missed value(s). Please check "details" response info, verify and fix your request data and try again. |
| 91 | Token verification not supported | Token verification not supported occurs when selected gateway doesn't support token verification. |
| 92 | Invalid address | Invalid address occurs when request data has incorrect or missed value(s) in customer address. |
| 93 | Blocked Card | This credit card has been blocked. |
| 94 | Timeout | Timeout during the request execution. Please verify status and data before continue with the transaction. |
| 95 | Visa Installments is not supported by this provider | Visa Installments is not supported by this provider. |
| 96 | The order information is invalid | The order information is invalid. Please verify and fix your request data (e.g. list of items) and try again. |
| 97 | Metadata does not contain required field(s) | Metadata does not contain required field(s). For example, "Document Id". Please verify the provider required fields. |
| 98 | Fraud check is not supported by this provider | Given provider does not support Fraud check |
| 99 | Card is not enrolled for Visa Installments | Given card number is not enrolled for Visa Installments |
| 100 | This feature is not supported by this provider | This feature is not supported by this provider |
| 101 | Invalid BatchId | Invalid BatchId |
| 102 | Invalid Batch Data | Invalid Batch Data |
| 103 | Direct Debit is not supported by this provider | Direct Debit is not supported by this provider. |
| 104 | Invalid SubscriptionId | Invalid SubscriptionId |
| 105 | No data to update the PaymentMethod | No data to update the PaymentMethod. Please verify and fix your request data. |
| 106 | The Payment Method must be of type 'CARD' | The Payment Method must be of type 'CARD' |
| 107 | Unable to update the PaymentMethod | Unable to update the PaymentMethod |
| 108 | Unable to update Subscription | Unable to update Subscription |
| 109 | Unable to create webhook subscription | Unable to create webhook subscription |
| 110 | Unable to retrieve webhook subscription | Unable to retrieve webhook subscription |
| 111 | Unable to delete webhook subscription | Unable to delete webhook subscription |
| 112 | Blocked by Fraud rules | Blocked by Fraud rules |
| 113 | 3D Secure required | 3D Secure required. Please initiate 3D Secure check |
| 114 | Unable to create network token | Unable to create network token |
| 115 | Unable to create payment link | Unable to create payment link |
| 116 | Invalid Payment Link Id | Invalid Payment Link Id |
| 901 | Refer to card issuer | Refer to card issuer |
| 902 | Refer to card issuer's special conditions | Refer to card issuer's special conditions |
| 903 | Invalid merchant | Invalid merchant |
| 904 | Pick-up card | Pick-up card |
| 905 | Do not honor | Do not honor |
| 906 | Error | Error |
| 907 | Pick-up card, special condition | Pick-up card, special condition |
| 908 | Honour with identification | Honour with identification |
| 909 | Request in progress | Request in progress |
| 910 | Approved for partial amount | Approved for partial amount |
| 911 | Approved (VIP) | Approved (VIP) |
| 912 | Invalid transaction | Invalid transaction |
| 913 | Invalid amount | Invalid amount |
| 914 | Invalid card number (no such number) | Invalid card number (no such number) |
| 915 | No such issuer | No such issuer |
| 916 | Approved, update track 3 | Approved, update track 3 |
| 917 | Customer cancellation | Customer cancellation |
| 918 | Customer dispute | Customer dispute |
| 919 | Re-enter transaction | Re-enter transaction |
| 920 | Invalid response | Invalid response |
| 921 | No action taken | No action taken |
| 922 | Suspected malfunction | Suspected malfunction |
| 923 | Unacceptable transaction fee | Unacceptable transaction fee |
| 924 | File update not supported by receiver | File update not supported by receiver |
| 925 | Unable to locate record on file | Unable to locate record on file |
| 926 | Duplicate file update record, old record replaced | Duplicate file update record, old record replaced |
| 927 | File update field edit error | File update field edit error |
| 928 | File update file locked out | File update file locked out |
| 929 | File update not successful, contact acquirer | File update not successful, contact acquirer |
| 930 | Format error | Format error |
| 931 | Bank not supported by switch | Bank not supported by switch |
| 932 | Completed partially | Completed partially |
| 933 | Expired card | Expired card |
| 934 | Suspected fraud - pic up | Suspected fraud - pic up |
| 935 | Card acceptor contact acquirer | Card acceptor contact acquirer |
| 936 | Restricted card | Restricted card |
| 937 | Card acceptor call acquirer security | Card acceptor call acquirer security |
| 938 | Allowable PIN tries exceeded | Allowable PIN tries exceeded |
| 939 | No credit account | No credit account |
| 940 | Requested function not supported | Requested function not supported |
| 941 | Lost card | Lost card |
| 942 | No universal account | No universal account |
| 943 | Stolen card - pick-up | Stolen card - pick-up |
| 944 | No investment account | No investment account |
| 951 | Insufficient funds | Insufficient funds |
| 952 | No checking account | No checking account |
| 953 | No savings account | No savings account |
| 954 | Expired card | Expired card |
| 955 | Incorrect personal identification number | Incorrect personal identification number |
| 956 | No card record | No card record |
| 957 | Transaction not permitted to cardholder | Transaction not permitted to cardholder |
| 958 | Transaction not permitted to terminal | Transaction not permitted to terminal |
| 959 | Suspected fraud | Suspected fraud |
| 960 | Card acceptor contact acquirer | Card acceptor contact acquirer |
| 961 | Exceeds withdrawal amount limit | Exceeds withdrawal amount limit |
| 962 | Restricted card | Restricted card |
| 963 | Security violation | Security violation |
| 964 | Original amount incorrect | Original amount incorrect |
| 965 | Exceeds withdrawal frequency limit | Exceeds withdrawal frequency limit |
| 966 | Card acceptor call acquirer's security department | Card acceptor call acquirer's security department |
| 967 | Hard capture (requires that card be picked up at ATM) | Hard capture (requires that card be picked up at ATM) |
| 968 | Response received too late | Response received too late |
| 975 | Allowable number of PIN tries exceeded | Allowable number of PIN tries exceeded |
| 990 | Cutoff is in process (switch ending a day's business and starting the next. Transaction can be sent again in a few minutes) | Cutoff is in process (switch ending a day's business and starting the next. Transaction can be sent again in a few minutes) |
| 991 | Issuer or switch is inoperative | Issuer or switch is inoperative |
| 992 | Financial institution or intermediate network facility cannot be found for routing | Financial institution or intermediate network facility cannot be found for routing |
| 993 | Transaction cannot be completed. Violation of law | Transaction cannot be completed. Violation of law |
| 994 | Duplicate transmission | Duplicate transmission |
| 995 | Reconcile error | Reconcile error |
| 996 | System malfunction | System malfunction |