{"metadata":{"image":[],"title":"","description":""},"api":{"url":"","auth":"required","results":{"codes":[]},"settings":"","params":[]},"next":{"description":"","pages":[]},"title":"Subscription & Billing Plan Errors","type":"basic","slug":"subscription-billing-plan-errors","excerpt":"","body":"These errors can be returned in response to a subscription or billing plan request.\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Code\",\n    \"h-1\": \"Name\",\n    \"h-2\": \"Description\",\n    \"1-1\": \"INVALID_CHARGE_FREQUENCY\",\n    \"1-0\": \"24001\",\n    \"2-0\": \"24002\",\n    \"3-0\": \"24003\",\n    \"4-0\": \"24004\",\n    \"5-0\": \"24005\",\n    \"6-0\": \"24006\",\n    \"7-0\": \"24007\",\n    \"8-0\": \"24008\",\n    \"9-0\": \"24009\",\n    \"10-0\": \"24010\",\n    \"11-0\": \"24011\",\n    \"12-0\": \"24013\",\n    \"13-0\": \"24014\",\n    \"14-0\": \"24015\",\n    \"15-0\": \"24016\",\n    \"16-0\": \"24017\",\n    \"18-0\": \"26001\",\n    \"17-0\": \"24018\",\n    \"19-0\": \"26002\",\n    \"20-0\": \"26003\",\n    \"22-0\": \"90010\",\n    \"23-0\": \"90011\",\n    \"24-0\": \"90012\",\n    \"25-0\": \"90013\",\n    \"26-0\": \"90014\",\n    \"27-0\": \"90015\",\n    \"28-0\": \"90016\",\n    \"29-0\": \"90017\",\n    \"30-0\": \"90018\",\n    \"31-0\": \"90019\",\n    \"32-0\": \"90020\",\n    \"21-0\": \"90009\",\n    \"33-0\": \"90021\",\n    \"34-0\": \"90022\",\n    \"35-0\": \"90023\",\n    \"2-1\": \"MISSING_REQUIRED_FIELD\",\n    \"1-2\": \"Charge frequency ${chargeFrequency} is invalid\",\n    \"2-2\": \"${fieldName} is a required field.\",\n    \"3-1\": \"INVALID_BILLING_PLAN_CONFIGURATION\",\n    \"3-2\": \"Billing plan configuration provided is not supported. ${param1} cannot be used with ${param2}\",\n    \"4-1\": \"API_CONFIGURATION_ISSUE\",\n    \"4-2\": \"Request failed. Please contact Bluesnap for assistance\",\n    \"5-1\": \"RECURRING_PRICE_MINIMUM_LIMIT_NOT_REACHED\",\n    \"5-2\": \"Recurring Price should be higher than 1 USD or its equivalent in the chosen currency.\",\n    \"6-1\": \"PRICE_MUST_BE_POSITIVE\",\n    \"6-2\": \"Prices are always positive numbers.\",\n    \"7-1\": \"INVALID_GRACE_PERIOD\",\n    \"7-2\": \"Grace period value provided is not valid.\",\n    \"8-1\": \"INVALID_TRIAL_DAYS\",\n    \"8-2\": \"Trial days value provided is not valid.\",\n    \"9-1\": \"INVALID_MAX_NUMBER_OF_CHARGES\",\n    \"9-2\": \"Maximum number of charges value provided is not valid.\",\n    \"10-1\": \"INVALID_BILLING_PLAN_NAME_LENGTH\",\n    \"10-2\": \"Billing plan name must be between 1 and 199 characters\",\n    \"11-1\": \"CURRENCY_NOT_FOUND\",\n    \"11-2\": \"The currency provided is not found.\",\n    \"12-1\": \"ERROR_IN_REQUEST\",\n    \"12-2\": \"An unexpected error happened while processing your request. Please contact BlueSnap support for assistance.\",\n    \"13-1\": \"NON_UPDATABLE_FIELD\",\n    \"13-2\": \"${fieldName} cannot be updated. Please create a new plan instead.\",\n    \"14-1\": \"CANNOT_ADD_ELEMENT\",\n    \"14-2\": \"Cannot add ${elementName} to a plan that didn't already have one. Please create a new plan instead.\",\n    \"17-1\": \"CANNOT_DELETE_ELEMENT\",\n    \"17-2\": \"Cannot remove ${elementName} from a plan that already had one. Please create a new plan instead.\",\n    \"15-1\": \"INVALID_STATUS\",\n    \"15-2\": \"Status provided is invalid\",\n    \"16-1\": \"CANNOT_CREATE_INACTIVE_PLAN\",\n    \"16-2\": \"Cannot create an inactive billing plan\",\n    \"18-1\": \"NEGATIVE_PAGE_SIZE\",\n    \"19-1\": \"MAX_PAGE_SIZE_EXCEEDED\",\n    \"20-1\": \"INVALID_PAGINATION_PARAMETERS\",\n    \"18-2\": \"PageSize cannot be a negative number\",\n    \"19-2\": \"PageSize exceeds the maximum allowed size\",\n    \"20-2\": \"Cannot paginate using before and after at the same time\",\n    \"21-1\": \"SUBSCRIPTION_NOT_FOUND\",\n    \"21-2\": \"Subscription was not found.\",\n    \"22-1\": \"NON_OVERRIDABLE_PLAN_TYPE\",\n    \"22-2\": \"Billing plan type does not support initial charge.\",\n    \"23-1\": \"NON_OVERRIDABLE_TRIAL_DAYS\",\n    \"23-2\": \"Cannot override trial-period-days\",\n    \"24-1\": \"NON_OVERRIDABLE_INITIAL_CHARGE\",\n    \"24-2\": \"Cannot override initial-charge-amount\",\n    \"25-1\": \"NO_VAULTED_SHOPPER_FOUND\",\n    \"25-2\": \"Invalid vaultedShopperId-${vaultedShopperId} :no vaulted shopper found with given id\",\n    \"26-1\": \"NEGATIVE_QUANTITY\",\n    \"26-2\": \"Invalid quantity ${quantity} :subscription quantity should be greater than zero\",\n    \"27-1\": \"INVALID_CURRENCY\",\n    \"27-2\": \"Currency: ${currencyCode} is not a valid currency code according to the ISO 4217 standard.\",\n    \"28-1\": \"INVALID_OVERRIDE_TRIAL_DAYS\",\n    \"28-2\": \"Invalid value ${trialDays} :override trial days must be a number\",\n    \"29-1\": \"INVALID_RECURRING_CHARGE_AMOUNT\",\n    \"29-2\": \"Invalid value ${recurringChargeAmount} :recurring chargeamount should be a greater than zero\",\n    \"30-1\": \"INVALID_INITIAL_CHARGE_AMOUNT\",\n    \"30-2\": \"Invalid value ${initialChargeAmount} :initial chargeamount should be a greater than zero\",\n    \"31-1\": \"INCORRECT_PAYMENT_DETAILS\",\n    \"31-2\": \"recurring charge failed because the payment details were incorrect or insufficient\",\n    \"32-1\": \"MULTIPLE_CARDS_FOUND_NONE_SELECTED\",\n    \"32-2\": \"recurring charge failed because given vaulted shopper has multiple cards but none of them are selected\",\n    \"33-1\": \"SWITCH_PLAN_ERROR\",\n    \"33-2\": \"Failure during the switch contract procedure\",\n    \"34-1\": \"INVALID_DATE_FORMAT\",\n    \"34-2\": \"Expected date format is YYYY-MM-DD\",\n    \"35-1\": \"CANNOT_UPDATE_CANCELED_SUBSCRIPTION\",\n    \"35-2\": \"Please activate subscription before making modifications to it.\",\n    \"0-0\": \"20026\",\n    \"0-1\": \"MISMATCH_SUBSCRIPTION_CURRENCY\",\n    \"0-2\": \"The given currency must match the original subscription currency.\",\n    \"36-0\": \"-\",\n    \"36-1\": \"EXISTING_CHARGE_PENDING_APPROVAL\",\n    \"36-2\": \"Subscription Charge creation could not be completed because this subscription already has a payment pending approval.\"\n  },\n  \"cols\": 3,\n  \"rows\": 37\n}\n[/block]","updates":[],"order":7,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"5ed5174637c3c607440c09e8","category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"Errors","slug":"errors","order":13,"from_sync":false,"reference":false,"_id":"5ed5174637c3c607440c0996","version":"5ed5174637c3c607440c0a3c","project":"57336fd5a6a9c40e00e13a0b","createdAt":"2015-10-15T16:21:09.840Z","__v":0},"user":"560d5913af97231900938124","parentDoc":null,"project":"57336fd5a6a9c40e00e13a0b","version":{"version":"8976-XML","version_clean":"8976.0.0-XML","codename":"3.34.0 Release","is_stable":false,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["5ed5174637c3c607440c098b","5ed5174637c3c607440c098c","5ed5174637c3c607440c098d","5ed5174637c3c607440c098e","5ed5174637c3c607440c098f","5ed5174637c3c607440c0990","5ed5174637c3c607440c0991","5ed5174637c3c607440c0992","5ed5174637c3c607440c0993","5ed5174637c3c607440c0994","5ed5174637c3c607440c0995","5ed5174637c3c607440c0996","5ed5174637c3c607440c0997","5ed5174637c3c607440c0998","5ed5174637c3c607440c0999","5ed5174637c3c607440c099a","5ed5174637c3c607440c099b","5ed5174637c3c607440c099c"],"_id":"5ed5174637c3c607440c0a3c","project":"57336fd5a6a9c40e00e13a0b","__v":0,"forked_from":"5e5d3a02fb6fb40050cb3c15","createdAt":"2018-04-24T15:24:22.608Z","releaseDate":"2018-04-24T15:24:22.608Z"},"createdAt":"2016-08-01T11:19:24.022Z","githubsync":"","__v":0}

Payment API (XML)

Card/Wallet Transactions

PayPal Transactions

ACH/ECP Transactions

SEPA Direct Debit Transactions

Local Bank Transfer transactions

Batch Transactions

Refunds

Vaulted Shoppers

Subscriptions

Fraud Review

Marketplace

Wallets

Errors

Resources

Test Data & Codes

Guides & Tools

Mobile SDK

Subscription & Billing Plan Errors

These errors can be returned in response to a subscription or billing plan request.

Code
Name
Description

20026

MISMATCH_SUBSCRIPTION_CURRENCY

The given currency must match the original subscription currency.

24001

INVALID_CHARGE_FREQUENCY

Charge frequency ${chargeFrequency} is invalid

24002

MISSING_REQUIRED_FIELD

${fieldName} is a required field.

24003

INVALID_BILLING_PLAN_CONFIGURATION

Billing plan configuration provided is not supported. ${param1} cannot be used with ${param2}

24004

API_CONFIGURATION_ISSUE

Request failed. Please contact Bluesnap for assistance

24005

RECURRING_PRICE_MINIMUM_LIMIT_NOT_REACHED

Recurring Price should be higher than 1 USD or its equivalent in the chosen currency.

24006

PRICE_MUST_BE_POSITIVE

Prices are always positive numbers.

24007

INVALID_GRACE_PERIOD

Grace period value provided is not valid.

24008

INVALID_TRIAL_DAYS

Trial days value provided is not valid.

24009

INVALID_MAX_NUMBER_OF_CHARGES

Maximum number of charges value provided is not valid.

24010

INVALID_BILLING_PLAN_NAME_LENGTH

Billing plan name must be between 1 and 199 characters

24011

CURRENCY_NOT_FOUND

The currency provided is not found.

24013

ERROR_IN_REQUEST

An unexpected error happened while processing your request. Please contact BlueSnap support for assistance.

24014

NON_UPDATABLE_FIELD

${fieldName} cannot be updated. Please create a new plan instead.

24015

CANNOT_ADD_ELEMENT

Cannot add ${elementName} to a plan that didn't already have one. Please create a new plan instead.

24016

INVALID_STATUS

Status provided is invalid

24017

CANNOT_CREATE_INACTIVE_PLAN

Cannot create an inactive billing plan

24018

CANNOT_DELETE_ELEMENT

Cannot remove ${elementName} from a plan that already had one. Please create a new plan instead.

26001

NEGATIVE_PAGE_SIZE

PageSize cannot be a negative number

26002

MAX_PAGE_SIZE_EXCEEDED

PageSize exceeds the maximum allowed size

26003

INVALID_PAGINATION_PARAMETERS

Cannot paginate using before and after at the same time

90009

SUBSCRIPTION_NOT_FOUND

Subscription was not found.

90010

NON_OVERRIDABLE_PLAN_TYPE

Billing plan type does not support initial charge.

90011

NON_OVERRIDABLE_TRIAL_DAYS

Cannot override trial-period-days

90012

NON_OVERRIDABLE_INITIAL_CHARGE

Cannot override initial-charge-amount

90013

NO_VAULTED_SHOPPER_FOUND

Invalid vaultedShopperId-${vaultedShopperId} :no vaulted shopper found with given id

90014

NEGATIVE_QUANTITY

Invalid quantity ${quantity} :subscription quantity should be greater than zero

90015

INVALID_CURRENCY

Currency: ${currencyCode} is not a valid currency code according to the ISO 4217 standard.

90016

INVALID_OVERRIDE_TRIAL_DAYS

Invalid value ${trialDays} :override trial days must be a number

90017

INVALID_RECURRING_CHARGE_AMOUNT

Invalid value ${recurringChargeAmount} :recurring chargeamount should be a greater than zero

90018

INVALID_INITIAL_CHARGE_AMOUNT

Invalid value ${initialChargeAmount} :initial chargeamount should be a greater than zero

90019

INCORRECT_PAYMENT_DETAILS

recurring charge failed because the payment details were incorrect or insufficient

90020

MULTIPLE_CARDS_FOUND_NONE_SELECTED

recurring charge failed because given vaulted shopper has multiple cards but none of them are selected

90021

SWITCH_PLAN_ERROR

Failure during the switch contract procedure

90022

INVALID_DATE_FORMAT

Expected date format is YYYY-MM-DD

90023

CANNOT_UPDATE_CANCELED_SUBSCRIPTION

Please activate subscription before making modifications to it.

-

EXISTING_CHARGE_PENDING_APPROVAL

Subscription Charge creation could not be completed because this subscription already has a payment pending approval.