Batch Transaction Errors

The following errors can be returned in response to a Batch Transaction request.

📘

Format of batch transaction errors

Some batch transaction errors are formatted differently from other error types. They include the processing-info element, which contains the processing-status, processing-error-code, processing-error-name, and processing-error-description elements. For details, see the sample error below.

Code

Name

Description

0

UNEXPECTED_ERROR

An unexpected error has occurred.

2

MISSING_CALLBACK_URL

callback-url element is required

3

MISSING_BATCH_ID

batch-id element is required

4

DUPLICATE_BATCH_ID

Batch ID already exists

6

MISSING_MERCHANT_TRANSACTION_ID

merchant-transaction-id element is required for card transactions

101

INVALID_BATCH_ID

Invalid batchId

10000

INVALID_API_VERSION

The API version passed in the request is invalid.

10001

VALIDATION_GENERAL_FAILURE

The resource passed in the request has violated validation rules. Additional information about the specific issue is provided in the error description.

11001

XSS_EXCEPTION

User input suspected as malicious.

20011

TRANSACTION_TYPE_NOT_ALLOWED

Only AUTH_CAPTURE card transactions, ECP or recurring PayPal payments are allowed in Batch

80002

BATCH_PROCESSING_IN_PROGRESS

The processing of this batch is not yet complete. Try again later.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<batch-transaction xmlns="http://ws.plimus.com">
  <batch-id>123</batch-id>
  <callback-url>http://sandbox.bluesnap.com/jsp/batch_callback.jsp</callback-url>
  <processing-info>
    <processing-status>fail</processing-status>
    <processing-errors>
      <processing-error>
        <processing-error-code>4</processing-error-code>
        <processing-error-name>DUPLICATE_BATCH_ID</processing-error-name>
        <processing-error-description>Batch ID already exists</processing-error-description>
      </processing-error>
    </processing-errors>
  </processing-info>
</batch-transaction>