{"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":"60fed21a76106200102eae21","category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"Errors","slug":"errors","order":15,"from_sync":false,"reference":false,"_id":"60fed21a76106200102eae14","version":"60fed21a76106200102eaec3","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.39 Release","is_stable":false,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["60fed21a76106200102eae0a","60fed21a76106200102eae0b","60fed21a76106200102eae0c","60fed21a76106200102eae0d","60fed21a76106200102eae0e","60fed21a76106200102eae0f","60fed21a76106200102eae10","60fed21a76106200102eae11","60fed21a76106200102eae12","60fed21a76106200102eae13","60fed21a76106200102eae14","60fed21a76106200102eae15","60fed21a76106200102eae16","60fed21a76106200102eae17","60fed21a76106200102eae18","60fed21a76106200102eae19","60fed21a76106200102eae1a","60fed21a76106200102eae1b","60fed21a76106200102eae1c","613a2bc99ca316007473ee77"],"_id":"60fed21a76106200102eaec3","project":"57336fd5a6a9c40e00e13a0b","__v":1,"forked_from":"60a40b18fa93ca00237af576","createdAt":"2018-04-24T15:22:41.561Z","releaseDate":"2018-04-24T15:22:41.561Z"},"createdAt":"2016-01-04T20:31:51.124Z","githubsync":"","__v":0}

Payment API (JSON)

Card/Wallet Transactions

PayPal Transactions

ACH/ECP Transactions

iDEAL Transactions

Local Bank Transfer transactions

SEPA Direct Debit Transactions

Sofort Transactions

Batch Transactions

Refunds

Vaulted Shoppers

Subscriptions

Fraud Review

Marketplace

Wallets

Errors

JSON Objects

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 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.

Sample Batch Transaction Error
{
    "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"
                }
            ]
        }
    }
}