{"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 \"10-0\": \"80002\",\n \"10-1\": \"BATCH_PROCESSING_IN_PROGRESS\",\n \"10-2\": \"The processing of this batch is not yet complete. Try again later.\"\n },\n \"cols\": 3,\n \"rows\": 11\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":"5ff39c12e2e8fa00503ad544","category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"Errors","slug":"errors","order":14,"from_sync":false,"reference":false,"_id":"5ff39c12e2e8fa00503ad537","version":"5ff39c12e2e8fa00503ad5e4","project":"57336fd5a6a9c40e00e13a0b","createdAt":"2015-10-15T16:21:09.840Z","__v":0},"user":"560d5913af97231900938124","project":"57336fd5a6a9c40e00e13a0b","parentDoc":null,"version":{"version":"8976-JSON","version_clean":"8976.0.0-JSON","codename":"3.36.1 Release","is_stable":false,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["5ff39c12e2e8fa00503ad52d","5ff39c12e2e8fa00503ad52e","5ff39c12e2e8fa00503ad52f","5ff39c12e2e8fa00503ad530","5ff39c12e2e8fa00503ad531","5ff39c12e2e8fa00503ad532","5ff39c12e2e8fa00503ad533","5ff39c12e2e8fa00503ad534","5ff39c12e2e8fa00503ad535","5ff39c12e2e8fa00503ad536","5ff39c12e2e8fa00503ad537","5ff39c12e2e8fa00503ad538","5ff39c12e2e8fa00503ad539","5ff39c12e2e8fa00503ad53a","5ff39c12e2e8fa00503ad53b","5ff39c12e2e8fa00503ad53c","5ff39c12e2e8fa00503ad53d","5ff39c12e2e8fa00503ad53e","5ff39c12e2e8fa00503ad53f"],"_id":"5ff39c12e2e8fa00503ad5e4","project":"57336fd5a6a9c40e00e13a0b","__v":0,"forked_from":"5fc6c6094cb8fa066b0d2ea3","createdAt":"2018-04-24T15:22:41.561Z","releaseDate":"2018-04-24T15:22:41.561Z"},"createdAt":"2016-01-04T20:31:51.124Z","githubsync":"","__v":0}
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.
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.
<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>