{"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":"61a5208deadb750070998ee5","category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"Errors","slug":"errors","order":15,"from_sync":false,"reference":false,"_id":"61a5208deadb750070998e92","version":"61a5208deadb750070998f48","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.40 Release","is_stable":false,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["61a5208deadb750070998e87","61a5208deadb750070998e88","61a5208deadb750070998e89","61a5208deadb750070998e8a","61a5208deadb750070998e8b","61a5208deadb750070998e8c","61a5208deadb750070998e8d","61a5208deadb750070998e8e","61a5208deadb750070998e8f","61a5208deadb750070998e90","61a5208deadb750070998e91","61a5208deadb750070998e92","61a5208deadb750070998e93","61a5208deadb750070998e94","61a5208deadb750070998e95","61a5208deadb750070998e96","61a5208deadb750070998e97","61a5208deadb750070998e98","61a5208deadb750070998e99","61a5208deadb750070998e9a"],"_id":"61a5208deadb750070998f48","project":"57336fd5a6a9c40e00e13a0b","__v":0,"forked_from":"60fed269718a45001c25b4a0","createdAt":"2018-04-24T15:24:22.608Z","releaseDate":"2018-04-24T15:24:22.608Z"},"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>