{"metadata":{"image":[],"title":"","description":""},"api":{"url":"","auth":"required","results":{"codes":[]},"settings":"","params":[]},"next":{"description":"","pages":[]},"title":"Alt Transaction Errors","type":"basic","slug":"alt-transaction-errors","excerpt":"","body":"The following errors can be returned in response to alt transaction requests.\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Code\",\n    \"h-1\": \"Name\",\n    \"h-2\": \"Description\",\n    \"4-0\": \"14010\",\n    \"14-0\": \"20020\",\n    \"15-0\": \"20021\",\n    \"16-0\": \"20022\",\n    \"17-0\": \"20023\",\n    \"18-0\": \"20024\",\n    \"19-0\": \"20025\",\n    \"21-0\": \"20026\",\n    \"25-0\": \"-\",\n    \"4-1\": \"FAILED_CREATING_PAYPAL_TOKEN\",\n    \"4-2\": \"An error occurs when connecting to PayPal. Please try again in a few moments or choose an alternative payment method.\",\n    \"14-1\": \"INVALID_ALT_TRANSACTION_TYPE\",\n    \"14-2\": \"Invalid Transaction Type.\",\n    \"15-2\": \"Cannot accept 'payer-info' and 'vaulted-shopper-id' elements.\",\n    \"15-1\": \"MULTI_SHOPPER_INFORMATION\",\n    \"16-1\": \"MISSING_SHOPPER_INFORMATION\",\n    \"16-2\": \"ECP transaction must include a 'payer-info' or 'vaulted-shopper-id' element.\",\n    \"17-1\": \"MISSING_PAYER_INFO_FIELDS\",\n    \"17-2\": \"This transaction must include a {fieldName} element within its 'payer-info' element.\",\n    \"18-1\": \"EXPECT_NO_ECP_DETAILS\",\n    \"18-2\": \"ECP transaction with Vaulted Shopper ID expect no ECP details, but an empty 'ecp-transaction' element instead.\",\n    \"19-1\": \"INVALID_ECP_ACCOUNT_TYPE\",\n    \"21-1\": \"MISMATCH_SUBSCRIPTION_CURRENCY\",\n    \"19-2\": \"Invalid Account Type. Please insert a valid value.\",\n    \"21-2\": \"The given currency must match the original subscription currency.\",\n    \"25-1\": \"MISSING_ARGUMENTS\",\n    \"25-2\": \"Cancel URL is a mandatory field.\\n*or*\\nReturn URL is a mandatory field.\",\n    \"12-2\": \"Transaction retrieval service failure. Multiple transactions found with merchant transaction ID: ${merchantTransactionId}.\",\n    \"12-1\": \"MULTIPLE_TRANSACTIONS_FOUND\",\n    \"12-0\": \"20002\",\n    \"8-0\": \"15008\",\n    \"8-1\": \"SHOPPER_NOT_FOUND\",\n    \"8-2\": \"The Shopper ID passed in the request was not found.\",\n    \"9-0\": \"15012\",\n    \"9-1\": \"SHOPPER_COUNTRY_OFAC_SANCTIONED\",\n    \"9-2\": \"One of the shopper's countries was defined as OFAC sanctioned.\",\n    \"10-0\": \"16003\",\n    \"10-1\": \"MULTIPLE_PAYMENT_METHODS_NON_SELECTED\",\n    \"10-2\": \"Shopper has multiple payment methods, but none is selected.\",\n    \"13-0\": \"20003\",\n    \"13-1\": \"TRANSACTION_LOCKED\",\n    \"13-2\": \"Transaction {transactionType} failed. Transaction locked.\",\n    \"3-0\": \"14002\",\n    \"3-1\": \"GENERAL_PAYMENT_PROCESSING_ERROR\",\n    \"3-2\": \"Payment processing failure due to an unspecified error. Description will contain the error code and message sent by the processor if applicable.\",\n    \"6-0\": \"14016\",\n    \"6-1\": \"NO_AVAILABLE_PROCESSORS\",\n    \"6-2\": \"There are no available processors for the specific request.\",\n    \"0-0\": \"10000\",\n    \"0-1\": \"INVALID_API_VERSION\",\n    \"0-2\": \"The API version passed in the request is invalid.\",\n    \"2-0\": \"11001\",\n    \"2-1\": \"XSS_EXCEPTION\",\n    \"2-2\": \"User input suspected as malicious.\",\n    \"1-0\": \"10001\",\n    \"1-2\": \"The resource passed in the request has violated validation rules. Additional information about the specific issue is provided in the error description.\",\n    \"1-1\": \"VALIDATION_GENERAL_FAILURE\",\n    \"22-0\": \"20027\",\n    \"22-1\": \"PAYPAL_UNSUPPORTED_CURRENCY\",\n    \"22-2\": \"The given currency {currency code} is not supported with PayPal.\",\n    \"24-0\": \"90009\",\n    \"24-1\": \"SUBSCRIPTION_NOT_FOUND\",\n    \"24-2\": \"Subscription service failure because subscription ID: {ID} cannot be found.\",\n    \"7-0\": \"14034\",\n    \"7-1\": \"INVALID_PAYMENT_DETAILS\",\n    \"7-2\": \"The payment details provided are invalid.\",\n    \"11-0\": \"17005\",\n    \"11-1\": \"INVALID_STEP_FIELD\",\n    \"11-2\": \"The request step PLACED has already been performed for this shopping context.\",\n    \"23-0\": \"24011\",\n    \"23-1\": \"CURRENCY_CODE_NOT_FOUND\",\n    \"23-2\": \"Currency code is missing.\",\n    \"5-0\": \"14011\",\n    \"5-1\": \"PAYMENT_METHOD_NOT_SUPPORTED\",\n    \"5-2\": \"The selected Payment Method is invalid.\",\n    \"20-0\": \"20025\",\n    \"20-1\": \"INVALID_PAYER_INFO_FIELDS\",\n    \"20-2\": \"The value in {fieldName} element is invalid.\"\n  },\n  \"cols\": 3,\n  \"rows\": 26\n}\n[/block]","updates":[],"order":1,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"5ed0377101fdb400214ded12","category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"Errors","slug":"errors","order":12,"from_sync":false,"reference":false,"_id":"5ed0377101fdb400214ded0a","version":"5ed0377101fdb400214dedaa","project":"57336fd5a6a9c40e00e13a0b","createdAt":"2015-10-15T16:21:09.840Z","__v":0},"parentDoc":null,"user":"560d5913af97231900938124","project":"57336fd5a6a9c40e00e13a0b","version":{"version":"8976-JSON","version_clean":"8976.0.0-JSON","codename":"3.34.0 Release","is_stable":false,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["5ed0377101fdb400214ded00","5ed0377101fdb400214ded01","5ed0377101fdb400214ded02","5ed0377101fdb400214ded03","5ed0377101fdb400214ded04","5ed0377101fdb400214ded05","5ed0377101fdb400214ded06","5ed0377101fdb400214ded07","5ed0377101fdb400214ded08","5ed0377101fdb400214ded09","5ed0377101fdb400214ded0a","5ed0377101fdb400214ded0b","5ed0377101fdb400214ded0c","5ed0377101fdb400214ded0d","5ed0377101fdb400214ded0e","5ed0377101fdb400214ded0f","5ed0377101fdb400214ded10"],"_id":"5ed0377101fdb400214dedaa","project":"57336fd5a6a9c40e00e13a0b","__v":0,"forked_from":"5e5d3aa2dc4d35003d784d9d","createdAt":"2018-04-24T15:22:41.561Z","releaseDate":"2018-04-24T15:22:41.561Z"},"createdAt":"2016-02-26T15:40:29.125Z","githubsync":"","__v":0}

Payment API (JSON)

Card/Wallet Transactions

PayPal Transactions

ACH/ECP Transactions

SEPA Direct Debit Transactions

Local Bank Transfer transactions

Refunds

Vaulted Shoppers

Subscriptions

Fraud Review

Marketplace

Wallets

Errors

JSON Objects

Test Data & Codes

Guides & Tools

Mobile SDK

Alt Transaction Errors

The following errors can be returned in response to alt transaction requests.

Code
Name
Description

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.

14002

GENERAL_PAYMENT_PROCESSING_ERROR

Payment processing failure due to an unspecified error. Description will contain the error code and message sent by the processor if applicable.

14010

FAILED_CREATING_PAYPAL_TOKEN

An error occurs when connecting to PayPal. Please try again in a few moments or choose an alternative payment method.

14011

PAYMENT_METHOD_NOT_SUPPORTED

The selected Payment Method is invalid.

14016

NO_AVAILABLE_PROCESSORS

There are no available processors for the specific request.

14034

INVALID_PAYMENT_DETAILS

The payment details provided are invalid.

15008

SHOPPER_NOT_FOUND

The Shopper ID passed in the request was not found.

15012

SHOPPER_COUNTRY_OFAC_SANCTIONED

One of the shopper's countries was defined as OFAC sanctioned.

16003

MULTIPLE_PAYMENT_METHODS_NON_SELECTED

Shopper has multiple payment methods, but none is selected.

17005

INVALID_STEP_FIELD

The request step PLACED has already been performed for this shopping context.

20002

MULTIPLE_TRANSACTIONS_FOUND

Transaction retrieval service failure. Multiple transactions found with merchant transaction ID: ${merchantTransactionId}.

20003

TRANSACTION_LOCKED

Transaction {transactionType} failed. Transaction locked.

20020

INVALID_ALT_TRANSACTION_TYPE

Invalid Transaction Type.

20021

MULTI_SHOPPER_INFORMATION

Cannot accept 'payer-info' and 'vaulted-shopper-id' elements.

20022

MISSING_SHOPPER_INFORMATION

ECP transaction must include a 'payer-info' or 'vaulted-shopper-id' element.

20023

MISSING_PAYER_INFO_FIELDS

This transaction must include a {fieldName} element within its 'payer-info' element.

20024

EXPECT_NO_ECP_DETAILS

ECP transaction with Vaulted Shopper ID expect no ECP details, but an empty 'ecp-transaction' element instead.

20025

INVALID_ECP_ACCOUNT_TYPE

Invalid Account Type. Please insert a valid value.

20025

INVALID_PAYER_INFO_FIELDS

The value in {fieldName} element is invalid.

20026

MISMATCH_SUBSCRIPTION_CURRENCY

The given currency must match the original subscription currency.

20027

PAYPAL_UNSUPPORTED_CURRENCY

The given currency {currency code} is not supported with PayPal.

24011

CURRENCY_CODE_NOT_FOUND

Currency code is missing.

90009

SUBSCRIPTION_NOT_FOUND

Subscription service failure because subscription ID: {ID} cannot be found.

-

MISSING_ARGUMENTS

Cancel URL is a mandatory field.
or
Return URL is a mandatory field.