Alt Transaction Errors

{"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 \"5-0\": \"14010\",\n \"16-0\": \"20020\",\n \"17-0\": \"20021\",\n \"18-0\": \"20022\",\n \"19-0\": \"20023\",\n \"20-0\": \"20024\",\n \"21-0\": \"20025\",\n \"23-0\": \"20026\",\n \"29-0\": \"-\",\n \"5-1\": \"FAILED_CREATING_PAYPAL_TOKEN\",\n \"5-2\": \"An error occurs when connecting to PayPal. Please try again in a few moments or choose an alternative payment method.\",\n \"16-1\": \"INVALID_ALT_TRANSACTION_TYPE\",\n \"16-2\": \"Invalid Transaction Type.\",\n \"17-2\": \"Cannot accept 'payer-info' and 'vaulted-shopper-id' elements.\",\n \"17-1\": \"MULTI_SHOPPER_INFORMATION\",\n \"18-1\": \"MISSING_SHOPPER_INFORMATION\",\n \"18-2\": \"Alt transaction must include a 'payer-info' or 'vaulted-shopper-id' element.\",\n \"19-1\": \"MISSING_PAYER_INFO_FIELDS\",\n \"19-2\": \"This transaction must include a {fieldName} element within its 'payer-info' element.\",\n \"20-1\": \"EXPECT_NO_ECP_DETAILS\",\n \"20-2\": \"ECP transaction with Vaulted Shopper ID expect no ECP details, but an empty 'ecp-transaction' element instead.\",\n \"21-1\": \"INVALID_ECP_ACCOUNT_TYPE\",\n \"23-1\": \"MISMATCH_SUBSCRIPTION_CURRENCY\",\n \"21-2\": \"Invalid Account Type. Please insert a valid value.\",\n \"23-2\": \"The given currency must match the original subscription currency.\",\n \"29-1\": \"MISSING_ARGUMENTS\",\n \"29-2\": \"Cancel URL is a mandatory field.\\n\\n*or*\\n\\nReturn URL is a mandatory field.\",\n \"14-2\": \"Transaction retrieval service failure. Multiple transactions found with merchant transaction ID: ${merchantTransactionId}.\",\n \"14-1\": \"MULTIPLE_TRANSACTIONS_FOUND\",\n \"14-0\": \"20002\",\n \"9-0\": \"15008\",\n \"9-1\": \"SHOPPER_NOT_FOUND\",\n \"9-2\": \"The Shopper ID passed in the request was not found.\",\n \"10-0\": \"15012\",\n \"10-1\": \"SHOPPER_COUNTRY_OFAC_SANCTIONED\",\n \"10-2\": \"One of the shopper's countries was defined as OFAC sanctioned.\",\n \"12-0\": \"16003\",\n \"12-1\": \"MULTIPLE_PAYMENT_METHODS_NON_SELECTED\",\n \"12-2\": \"Shopper has multiple payment methods, but none is selected.\",\n \"15-0\": \"20003\",\n \"15-1\": \"TRANSACTION_LOCKED\",\n \"15-2\": \"Transaction {transactionType} failed. Transaction locked.\",\n \"4-0\": \"14002\",\n \"4-1\": \"GENERAL_PAYMENT_PROCESSING_ERROR\",\n \"4-2\": \"Payment processing failure due to an unspecified error. Description will contain the error code and message sent by the processor if applicable.\",\n \"7-0\": \"14016\",\n \"7-1\": \"NO_AVAILABLE_PROCESSORS\",\n \"7-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 \"3-0\": \"11001\",\n \"3-1\": \"XSS_EXCEPTION\",\n \"3-2\": \"User input suspected as malicious.\",\n \"2-0\": \"10001\",\n \"2-2\": \"The resource passed in the request has violated validation rules. Additional information about the specific issue is provided in the error description.\",\n \"2-1\": \"VALIDATION_GENERAL_FAILURE\",\n \"24-0\": \"20027\",\n \"24-1\": \"PAYPAL_UNSUPPORTED_CURRENCY\",\n \"24-2\": \"The given currency {currency code} is not supported with PayPal.\",\n \"28-0\": \"90009\",\n \"28-1\": \"SUBSCRIPTION_NOT_FOUND\",\n \"28-2\": \"Subscription service failure because subscription ID: {ID} cannot be found.\",\n \"8-0\": \"14034\",\n \"8-1\": \"INVALID_PAYMENT_DETAILS\",\n \"8-2\": \"The payment details provided are invalid.\",\n \"13-0\": \"17005\",\n \"13-1\": \"INVALID_STEP_FIELD\",\n \"13-2\": \"The request step PLACED has already been performed for this shopping context.\",\n \"27-0\": \"24011\",\n \"27-1\": \"CURRENCY_CODE_NOT_FOUND\",\n \"27-2\": \"Currency code is missing.\",\n \"6-0\": \"14011\",\n \"6-1\": \"PAYMENT_METHOD_NOT_SUPPORTED\",\n \"6-2\": \"The selected Payment Method is invalid.\",\n \"22-0\": \"20025\",\n \"22-1\": \"INVALID_PAYER_INFO_FIELDS\",\n \"22-2\": \"The value in {fieldName} element is invalid.\",\n \"1-0\": \"10000\",\n \"1-1\": \"SERVER_GENERAL_FAILURE\",\n \"1-2\": \"Price is a negative figure.\",\n \"11-0\": \"16001\",\n \"11-1\": \"MISSING_ARGUMENTS\",\n \"11-2\": \"Return URL is a mandatory field for iDEAL and Sofort transactions.\",\n \"25-0\": \"20033\",\n \"25-1\": \"IDEAL_UNSUPPORTED_PAYMENT_INFO\",\n \"25-2\": \"Currency 'EUR' in country {country code} is not supported by iDEAL.\",\n \"26-0\": \"20035\",\n \"26-1\": \"SOFORT_UNSUPPORTED_PAYMENT_INFO\",\n \"26-2\": \"Currency {currency code} in country {country} is not supported by Sofort transaction.\"\n },\n \"cols\": 3,\n \"rows\": 30\n}\n[/block]","updates":[],"order":1,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"60a40b18fa93ca00237af4d1","category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"Errors","slug":"errors","order":14,"from_sync":false,"reference":false,"_id":"60a40b18fa93ca00237af4c7","version":"60a40b18fa93ca00237af576","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.38 Release","is_stable":false,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["60a40b18fa93ca00237af4bd","60a40b18fa93ca00237af4be","60a40b18fa93ca00237af4bf","60a40b18fa93ca00237af4c0","60a40b18fa93ca00237af4c1","60a40b18fa93ca00237af4c2","60a40b18fa93ca00237af4c3","60a40b18fa93ca00237af4c4","60a40b18fa93ca00237af4c5","60a40b18fa93ca00237af4c6","60a40b18fa93ca00237af4c7","60a40b18fa93ca00237af4c8","60a40b18fa93ca00237af4c9","60a40b18fa93ca00237af4ca","60a40b18fa93ca00237af4cb","60a40b18fa93ca00237af4cc","60a40b18fa93ca00237af4cd","60a40b18fa93ca00237af4ce","60a40b18fa93ca00237af4cf"],"_id":"60a40b18fa93ca00237af576","project":"57336fd5a6a9c40e00e13a0b","__v":0,"forked_from":"603d5bd1309e0703644e931e","createdAt":"2018-04-24T15:22:41.561Z","releaseDate":"2018-04-24T15:22:41.561Z"},"createdAt":"2016-02-26T15:40:29.125Z","githubsync":"","__v":0}

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.

10000

SERVER_GENERAL_FAILURE

Price is a negative figure.

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.

16001

MISSING_ARGUMENTS

Return URL is a mandatory field for iDEAL and Sofort transactions.

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

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

20033

IDEAL_UNSUPPORTED_PAYMENT_INFO

Currency 'EUR' in country {country code} is not supported by iDEAL.

20035

SOFORT_UNSUPPORTED_PAYMENT_INFO

Currency {currency code} in country {country} is not supported by Sofort transaction.

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.

Return URL is a mandatory field.

Developer Hub

Payment API (JSON)

Card/Wallet Transactions

PayPal Transactions

ACH/ECP Transactions

iDEAL Transactions

Local Bank Transfer transactions

SEPA Direct Debit Transactions

Sofort Transactions

Refunds

Vaulted Shoppers

Subscriptions

Fraud Review

Marketplace

Wallets

Errors

JSON Objects

Test Data & Codes

Guides & Tools

Mobile SDK