{"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 or 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\": \"{\\n \\\"batchId\\\": \\\"PKB0035\\\",\\n \\\"callbackUrl\\\": https://pavelk-lap.bluesnap.int:7000/d,\\n \\\"processingInfo\\\": {\\n \\\"processingStatus\\\": \\\"fail\\\",\\n \\\"processingErrors\\\": {\\n \\\"processingError\\\": [\\n {\\n \\\"processingErrorCode\\\": \\\"4\\\",\\n \\\"processingErrorName\\\": \\\"DUPLICATE_BATCH_ID\\\",\\n \\\"processingErrorDescription\\\": \\\"Batch ID already exists\\\"\\n }\\n ]\\n }\\n }\\n}\",\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":"628531cd1258c8003f6dd1d7","category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"Errors","slug":"errors","order":15,"from_sync":false,"reference":false,"_id":"628531cd1258c8003f6dd1c9","version":"628531cd1258c8003f6dd27d","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.42 Release","is_stable":false,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["628531cd1258c8003f6dd1bf","628531cd1258c8003f6dd1c0","628531cd1258c8003f6dd1c1","628531cd1258c8003f6dd1c2","628531cd1258c8003f6dd1c3","628531cd1258c8003f6dd1c4","628531cd1258c8003f6dd1c5","628531cd1258c8003f6dd1c6","628531cd1258c8003f6dd1c7","628531cd1258c8003f6dd1c8","628531cd1258c8003f6dd1c9","628531cd1258c8003f6dd1ca","628531cd1258c8003f6dd1cb","628531cd1258c8003f6dd1cc","628531cd1258c8003f6dd1cd","628531cd1258c8003f6dd1ce","628531cd1258c8003f6dd1cf","628531cd1258c8003f6dd1d0","628531cd1258c8003f6dd1d1","628531cd1258c8003f6dd1d2"],"_id":"628531cd1258c8003f6dd27d","project":"57336fd5a6a9c40e00e13a0b","__v":0,"forked_from":"622783372cd60c003782d77e","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 or 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.
{
"batchId": "PKB0035",
"callbackUrl": https://pavelk-lap.bluesnap.int:7000/d,
"processingInfo": {
"processingStatus": "fail",
"processingErrors": {
"processingError": [
{
"processingErrorCode": "4",
"processingErrorName": "DUPLICATE_BATCH_ID",
"processingErrorDescription": "Batch ID already exists"
}
]
}
}
}