Transaction Batching Error Reference
The table below outlines the error codes returned by our Transaction Batching 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_InvalidBatchId | The batch ID provided is invalid. Verify and provide a valid batch identifier. | 400 |
| Key_InvalidTransactionId | The transaction ID provided is invalid. Ensure you supply a valid transaction identifier. | 400 |
| Key_InvalidTransactionStatus | The transaction status does not allow this operation. Check the current status before retrying. | 400 |
| Key_InvalidCancellationRequest | The cancellation request is invalid or not permitted for the given transaction. | 400 |
| Key_TransactionIdsListCannotBeEmptyOrNull | The list of transaction IDs is required and cannot be empty or null. | 400 |
| Key_InvalidTransactionIdsList | The list of transaction IDs contains invalid or unrecognized values. | 400 |
| Key_OnlyAdyenTransactionsCanBeVoided | Only Adyen transactions are eligible for voiding. Other transaction types cannot be voided. | 400 |
| Key_BatchIsAlreadyProcessed | The batch has already been processed and cannot be modified or executed again. | 400 |
| Key_BatchIsReady | The batch is already marked as ready and cannot be updated further. | 400 |
| Key_BatchIsInProgress | The batch is currently in progress and cannot accept new changes. | 400 |
| Key_NoTransactionsFoundInBatch | No transactions were found in the specified batch. | 404 |
| Key_VoidFailed | The void request failed due to a processing error or invalid conditions. | 400 |
| Key_PaymentBatchingFeatureIsNotEnabled | The payment batching feature is not enabled for this merchant. Contact support to enable it. | 400 |
| Key_InvalidPaymentBatch | The payment batch provided is invalid or corrupted. Please resubmit with a valid batch. | 400 |
| Key_PaymentBatchNotFound | The requested payment batch could not be found. Verify the batch ID. | 404 |
| Key_PaymentBatchesNotFound | No payment batches were found matching the search criteria. | 404 |
| Key_InvalidMerchantId | The merchant ID provided is invalid. Ensure the merchant ID is correct. | 400 |
| Key_InvalidBatchStatus | The batch status does not allow this operation. Check the current status before retrying. | 400 |
| Key_PaymentBatchEventsNotFound | No events were found for the specified payment batch. | 404 |
| Key_TransactionIsNotAssociatedPaymentBatch | The specified transaction is not associated with the given payment batch. | 400 |
| Key_ActivePaymentBatchNotFound | No active payment batch was found for the current merchant or request. | 404 |
| Key_TodaysBatchIsAlreadyExecuted | The batch for today has already been executed and cannot be rerun. | 400 |
| Key_VoidReasonCannotBeNullOrEmpty | A reason for voiding is required and cannot be null or empty. | 400 |
| Key_TransactionsNotAssociatedWithBatch | Some or all transactions provided are not associated with the specified batch. | 400 |
| Key_BatchIsUnProcessed | The batch has not been processed yet and is not available for this operation. | 400 |
| Key_BatchIsInactive | The batch is marked as inactive and cannot be used for payment processing. | 400 |