{"metadata":{"image":[],"title":"","description":""},"api":{"url":"","auth":"required","results":{"codes":[]},"settings":"","params":[]},"next":{"description":"","pages":[]},"title":"Batch Transaction Errors","type":"basic","slug":"batch-errors","excerpt":"","body":"The following errors can be returned in response to a Batch Transaction request.\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Format of batch transaction errors\",\n  \"body\": \"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.\"\n}\n[/block]\n\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Code\",\n    \"h-1\": \"Name\",\n    \"h-2\": \"Description\",\n    \"1-0\": \"2\",\n    \"2-0\": \"3\",\n    \"3-0\": \"4\",\n    \"1-2\": \"callback-url element is required\",\n    \"1-1\": \"MISSING_CALLBACK_URL\",\n    \"2-1\": \"MISSING_BATCH_ID\",\n    \"2-2\": \"batch-id element is required\",\n    \"3-2\": \"Batch ID already exists\",\n    \"3-1\": \"DUPLICATE_BATCH_ID\",\n    \"0-0\": \"0\",\n    \"4-1\": \"MISSING_MERCHANT_TRANSACTION_ID\",\n    \"0-1\": \"UNEXPECTED_ERROR\",\n    \"4-0\": \"6\",\n    \"9-0\": \"20011\",\n    \"9-1\": \"TRANSACTION_TYPE_NOT_ALLOWED\",\n    \"9-2\": \"Only AUTH_CAPTURE card transactions, ECP or recurring PayPal payments are allowed in Batch\",\n    \"4-2\": \"merchant-transaction-id element is required for card transactions\",\n    \"0-2\": \"An unexpected error has occurred.\",\n    \"6-2\": \"The API version passed in the request is invalid.\",\n    \"6-0\": \"10000\",\n    \"6-1\": \"INVALID_API_VERSION\",\n    \"8-2\": \"User input suspected as malicious.\",\n    \"8-0\": \"11001\",\n    \"8-1\": \"XSS_EXCEPTION\",\n    \"7-0\": \"10001\",\n    \"7-2\": \"The resource passed in the request has violated validation rules. Additional information about the specific issue is provided in the error description.\",\n    \"7-1\": \"VALIDATION_GENERAL_FAILURE\",\n    \"5-0\": \"101\",\n    \"5-1\": \"INVALID_BATCH_ID\",\n    \"5-2\": \"Invalid batchId\"\n  },\n  \"cols\": 3,\n  \"rows\": 10\n}\n[/block]\n\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"<?xml version=\\\"1.0\\\" encoding=\\\"UTF-8\\\" standalone=\\\"yes\\\"?>\\n<batch-transaction xmlns=\\\"http://ws.plimus.com\\\">\\n  <batch-id>123</batch-id>\\n  <callback-url>http://sandbox.bluesnap.com/jsp/batch_callback.jsp</callback-url>\\n  <processing-info>\\n    <processing-status>fail</processing-status>\\n    <processing-errors>\\n      <processing-error>\\n        <processing-error-code>4</processing-error-code>\\n        <processing-error-name>DUPLICATE_BATCH_ID</processing-error-name>\\n        <processing-error-description>Batch ID already exists</processing-error-description>\\n      </processing-error>\\n    </processing-errors>\\n  </processing-info>\\n</batch-transaction>  \",\n      \"language\": \"xml\",\n      \"name\": \"Sample Batch Transaction Error\"\n    }\n  ]\n}\n[/block]","updates":[],"order":2,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"5ed5174637c3c607440c09e7","category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"Errors","slug":"errors","order":13,"from_sync":false,"reference":false,"_id":"5ed5174637c3c607440c0996","version":"5ed5174637c3c607440c0a3c","project":"57336fd5a6a9c40e00e13a0b","createdAt":"2015-10-15T16:21:09.840Z","__v":0},"user":"560d5913af97231900938124","project":"57336fd5a6a9c40e00e13a0b","parentDoc":null,"version":{"version":"8976-XML","version_clean":"8976.0.0-XML","codename":"3.34.0 Release","is_stable":false,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["5ed5174637c3c607440c098b","5ed5174637c3c607440c098c","5ed5174637c3c607440c098d","5ed5174637c3c607440c098e","5ed5174637c3c607440c098f","5ed5174637c3c607440c0990","5ed5174637c3c607440c0991","5ed5174637c3c607440c0992","5ed5174637c3c607440c0993","5ed5174637c3c607440c0994","5ed5174637c3c607440c0995","5ed5174637c3c607440c0996","5ed5174637c3c607440c0997","5ed5174637c3c607440c0998","5ed5174637c3c607440c0999","5ed5174637c3c607440c099a","5ed5174637c3c607440c099b","5ed5174637c3c607440c099c"],"_id":"5ed5174637c3c607440c0a3c","project":"57336fd5a6a9c40e00e13a0b","__v":0,"forked_from":"5e5d3a02fb6fb40050cb3c15","createdAt":"2018-04-24T15:24:22.608Z","releaseDate":"2018-04-24T15:24:22.608Z"},"createdAt":"2016-01-04T20:31:51.124Z","githubsync":"","__v":0}

Payment API (XML)

Card/Wallet Transactions

PayPal Transactions

ACH/ECP Transactions

SEPA Direct Debit Transactions

Local Bank Transfer transactions

Batch Transactions

Refunds

Vaulted Shoppers

Subscriptions

Fraud Review

Marketplace

Wallets

Errors

Resources

Test Data & Codes

Guides & Tools

Mobile SDK

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

Sample Batch Transaction Error
<?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>