# Donation API Errors
Description of Payments errors and list of payments errors that can be returned.
# Error Structure
When an error occurs in the Payments API, a JSON response payload will contain information regarding the nature of the error that occurred. These Error Codes will take the following form:
{
"code": 20004,
"message": "Backend request error occurred while attempting to process a Transaction",
"details": "An error occurred while attempting to process a Transaction in the backend"
}
Code: A 5 digit error code. Error Codes are 'bucketed' according to the nature of the error that has occurred. Errors that are logically related are contained within the same bucket. The first digit in any error code denotes the bucket to which it belongs such that any error code 1xxxx will be a Validation error, any error 4xxxx will be a Payments error etc...
Message: A message associated with the Error Code.
Details: Any further details about the nature of the error that has occurred.
In addition, Payments will use the HTTP Response code to provide further details of the nature of the error.
400 - a Bad Request. The request was incorrect and could not be processed by the Payments API.
404 - Not found. An entity could not be found. i.e. User not found.
403 - Forbidden. The JWT you have passed in to the request could not be Authenticated and you are forbidden to perform the action.
500 - Internal Error. An Internal Error has occurred with the Payments API.
# Error Codes
# 2xxxx - Backend
Errors related to the Benevity Backend.
| Code | Message | Details |
|---|---|---|
| 20000 | A connection to the Benevity backend could not be established | No HMAC |
| 20001 | Backend request error | Response may contain one of:
|
| 20002 | Unable to get HMAC password for the provided company. | |
| 20004 | Backend request error occurred while attempting to process a Transaction | An error occurred while attempting to process a Transaction in the backend |
| 20009 | Backend request error occurred while attempting to process an Apple Pay Transaction. | An error occurred while attempting to process an Apple Pay Transaction in the backend |
| 20010 | An error occurred while processing the donation in the backend. The Payment has been refunded. | The appropriate error(s) returned by the transaction service |
# 3xxxx - Authentication
Errors related to Authentication/Authorization.
| Code | Message | Details |
|---|---|---|
| 30000 | You are not authorized to perform the request action. | Not authorized |
# 4xxxx - Payments
Payments API specific errors.
| Code | Message | Details |
|---|---|---|
| 40000 | Element not found | Error in adding Token to CreditCard. User does not exist |
| 40001 | Unsupported merchant processor | Response may contain one of:
|
| 40002 | User not found | Response may contain one of:
|
| 40003 | CreditCard not found | Response may contain one of:
|
| 40004 | Subscription not found | Error in getting Subscription. Subscription does not |
| 40005 | Subscription not found | Error getting Subscription list. |
| 40006 | Transaction not found | Response may contain one of:
|
| 40007 | TransactionTemplate not found for Subscription | No Template Transaction could be found for the specified Subscription |
| 40008 | MerchantAccount not found | Response may contain one of:
|
| 40010 | User with the specified userId already exists | A User with the specified userId already exists |
| 40011 | Bad Request | Error occurred in processing request |
| 40012 | No merchant accounts were found in the Benevity backend | Response may contain one of:
|
| 40013 | No routable foundations were found in the Benevity backend | Failed to find any routable foundations for user userId |
| 40014 | User does not have access to this card | User cannot access this card |
| 40015 | A token already exists for this Credit Card number, User and MerchantAccount | Token exists for this CreditCard and MerchantAccount. |
| 40016 | CreditCard is not valid. | Response may contain one of:
|
| 40018 | Failed to create the Subscription. | Unable to create the subscription |
| 40019 | Error processing Transaction. Token does not exist for the CreditCard and MerchantAccount | No token found for merchant account |
| 40020 | An error occurred with the Payment Processor. Unable to create the VaultedShopper | Error saving credit card. |
| 40021 | The user never entered their card details when tokenizing with Payment Processor | Credit card details were not entered by the user |
| 40022 | Payment Processor did not return a vaulted shopper with credit card details. | Unexpected no creditCardInfo from creating Bluesnap vaulted shopper. No card details. |
| 40023 | An error occurred while fetching the ApplePay Wallet Token | Error requesting ApplePay Wallet Token |
| 40024 | An error occurred while fetching a Credit Card Token | Error requesting CreditCard Token |
| 40026 | Missing parameters | Parameter 'user' required |
| 40028 | Uknown Action supplied for a PurchaseItem | Unable to process Transaction in the backend. An unknown action was supplied to a PurchaseItem |
| 40031 | UserAccessId is a required parameter. | Error in processing transaction. User access id required on payments user when using UserPurchaseCreditsAndDonate. Be sure to add the access id upon creating payments user. |
| 40032 | Unable to parse the JSON request. Content does not conform to JSON syntax as per specification | Returns a message representing the json parsing exception that was thrown |
| 40033 | Unable to parse the JSON request. A fatal error occurred. | Returns a message representing the json parsing exception that was thrown |
| 40034 | Unable to parse the JSON request. Unrecognized property | Returns a message representing the json parsing exception that was thrown |
| 40035 | Request method unsupported | Request Method method |
| 40036 | The merchant account does not support the supplied currency. | MerchantAccount [merchantAccountId] does not support the currency [currencyCode] |
| 40037 | Receipt email is required if you specified that a receipt is to be sent. | An email is required if send_receipt is set to true |
| 40039 | The specified Subscription Frequency is not supported | The specified Subscription frequency is not supported |
| 40040 | Unable to refund Transaction. Already refunded | Transaction has already been refunded. |
| 40041 | Unexpected error occurred retrieving company subscriptions. | Unexpected error occurred retrieving company subscriptions. |
| 40042 | An exception occured while processing merchant transaction fees | Error mapping merchant fee transaction object with entity |
| 40043 | Merchant transaction fee not found | Response may contain one of:
|
| 40048 | An error occurred with the Payment Processor. Unable to get the VaultedShopper | Error getting VaultedShopper |
| 40052 | An exception occurred while fetching transaction daily reports from Bluesnap | Error when fetching transaction daily reports from Bluesnap |
| 40054 | An error occurred before processing the donation in the backend. The Payment has been refunded | An error occurred before processing the donation in the backend |
| 40055 | An error occurred before processing the donation in the backend. The Apple Pay Payment has been refunded | An error occurred before processing the Apple Pay Transaction in the backend |
# 42xxx - Payments Processor
Payments specific errors related to the Payment Processor.
| Code | Message | Details |
|---|---|---|
| 42500 | CreditCard Transaction declined by Payment Processor | Please see the documentation at: https://developers.bluesnap.com/v8976-XML/docs/card-transaction-errors (opens new window) for more information. |
| 42501 | Apple Pay Transaction declined by Payment Processor | Please see the documentation at: https://developers.bluesnap.com/v8976-XML/docs/card-transaction-errors (opens new window) for more information. |
| 42502 | General Payment Failure with Payment Processor | Please see the documentation at: https://developers.bluesnap.com/v8976-XML/docs/card-transaction-errors (opens new window) for more information. |
| 42503 | An error occurred with Payment Processor due to an issue with api usage | Please see the documentation at: https://developers.bluesnap.com/v8976-XML/docs/card-transaction-errors (opens new window) for more information. |
| 42504 | A payment was declined by the payment processor | This error is never directly returned by the Payments API |
| 42505 | Payment Processor Fraud Detection error | Please see the documentation at: https://developers.bluesnap.com/v8976-XML/docs/fraud-errors (opens new window) for more information. |
| 42506 | An error occurred with the VaultedShopper in Payment Processor | Please see the documentation at: https://developers.bluesnap.com/v8976-XML/docs/card-transaction-errors (opens new window) for more information. |
| 42507 | An error occurred with the wallet in Payment Processor | Please see the documentation at: https://developers.bluesnap.com/v8976-Tools/docs/wallet-errors (opens new window) for more information. |
| 42508 | An unknown error was returned by Payment Processor for the Transaction | No error message returned from Bluesnap |
| 42509 | A validation error was returned by Payment Processor for the Transaction | Please see the documentation at: https://developers.bluesnap.com/v8976-XML/docs/card-transaction-errors (opens new window) for more information. |
| 42510 | Server General Failure reported by Payment Processor | Please see the documentation at: https://developers.bluesnap.com/v8976-Extended/docs/general-errors (opens new window) for more information. |
| 42511 | An error occurred while refunding a Transaction. Transaction cannot be refunded | An unexpected error occurred while refunding a Transaction |
| 42512 | Payment Processor AVS Mismatch | Please see the documentation at: https://developers.bluesnap.com/v8976-JSON/docs/fraud-event (opens new window) for more information. |
| 42513 | Error in validation. | Contains a string with the specific constraints that have been violated. |
| 42517 | An attempt was made to process a different request with the same referenceNumber as a previous request that was processed within the last 24hrs. | Please see the documentation at: https://developers.bluesnap.com/v8976-JSON/reference/idempotency-errors (opens new window) for more information. |
| 42518 | The Idempotency Key sent to the Payment Processor is invalid. | Please see the documentation at: https://developers.bluesnap.com/v8976-JSON/reference/idempotency-errors (opens new window) for more information. |
| 42519 | An attempt was made to process a duplicate request with the same referenceNumber as a previous request that was processed within the last 24hrs. | Please see the documentation at: https://developers.bluesnap.com/v8976-JSON/reference/idempotency-errors (opens new window) for more information. |
# 5xxxx - Internal Errors
Internal Errors that have occurred in the Payments API.
| Code | Message | Details |
|---|---|---|
| 50000 | Key violation. Duplicate Users for the same Company and UserId exist. | Encountered duplicate users! |
| 50001 | Internal Error getting SubscriptionResponse. | Error getting Subscription |
| 50002 | Internal Error getting User | Response may contain one of:
|
| 50003 | Internal Error getting CreditCard | Response may contain one of:
|
| 50004 | Internal Error in fetching Transaction from the database. | TransactionId [transactionId] could not be fetched |
| 50005 | Internal Error occurred | Response may contain one of:
|
| 50006 | An internal error occurred. Error copying fields in PropertyUtils | Error when copy bean: beanClassName |
| 50009 | An internal error with the Payment Processor occurred while processing Payment | Response may contain one of:
|
| 50010 | An internal error occurred with the Payment Processor. A Forbidden response was received. Please ensure your environment is setup correctly. | Response may contain one of:
|
| 50011 | An internal error occurred with the Recurring Subscription Process. | Response may contain one of:
|
| 50012 | An internal error occurred while attempting to deactivate a Subscription. | Error deactivating Subscription |
| 50013 | An internal error occurred while resending the transaction fee. | An exception occurred while resending transaction fee. |
| 50014 | Internal Error while saving or updating Credit Card. | Response may contain one of:
|
| 50015 | Internal Error while attempting to add a token to the CreditCard | An internal error occurred while attempting to add a token to the CreditCard |