Skip to main content

Welcome to our Dev Docs!

SubscriptionJS Callbacks

success(successData)

Most SubscriptionJS methods provide a success callback. Please refer to each method to see in which form successData will be provided.

error(errorData)

Most SubscriptionJS methods provide a callback to handle errors.

{
    "errorCode" : ["InvalidCardCvc"],
    "errorMessage" : "",
    "referenceId" : "",
    "referenceUrl" : "",
    "details" : ""
}

Notice

Please check the structure of the passed object before using it. Currently, the passed object might have a different structure under certain circumstances.

errorMessage is an error message for your internal use. It is NOT prepared for direct notification of the customer. referenceId is reserved for future use. referenceUrl Reserved for future use. details is reserved for future use. errorCode is an array that provides a hierarchy of error codes.

At least one value is provided. This can be used to implement error specific behaviour of your page, e.g. inform the customer some credit card data was incorrect and let him correct it.

Possible values created by SubscriptionJS:

Error Callback

Description

Aborted

During the checkout, if it is actively aborted by the Customer

AcquirerServerError

Technical problem on the Acquirer side

AmountLimitExceeded

Transaction amount > higher than limit

AuthorizationRejected

Authorization declined on payment provider side

BearerExpired

Payment bearer has expired, e.g. credit card has expired

BearerRejected

Payment bearer has been rejected e.g. it is blacklisted or invalid

InvalidAccountHolder

Invalid account holder

InvalidAccountNumber

Invalid bank account

InvalidAmount

  • Additional minus.PNG or 0

  • If the amount is too small or too high

InvalidBankCode

Invalid bank code

InvalidBic

Invalid BIC (Bank Identifier Code

InvalidCardType

Card type not supported, e.g. No American Express supported by the acquirer

InvalidCardNumber

Invalid credit card number

InvalidCardCvc

Invalid validation code

InvalidCardHolder

Invalid credit card holder

InvalidConfiguration

Invalid configuration of the Payment Provider

InvalidCountry

Invalid country

InvalidCouponCode

Invalid/Not applicable coupon code

InvalidCurrency

Invalid currency

InvalidData

Invalid data

InvalidExpirationDate

Filled expiration date not matching card expiration date

InvalidKey

Invalid Public Key

InvalidIban

Invalid IBAN (International Bank Account Number)

InvalidName

Customer name either invalid or empty

InvalidPaymentData

Invalid payment data

InvalidPaymentMethod

Not supported payment method

InvalidTransaction

Transaction can not be performed due to PSP specific error, e.g. reference code is already used

InvalidVatId

Invalid Vat ID

IteroServerError

Technical problem on Billwerk+ platform

PspServerError

Technical problem on payment provider system

RateLimit

Rate limit esceeded

Timeout

No answer from payment provider

UnmappedError

Payment provider error not mapped to Billwerk+ erro code

3DsProblem

Problem with a two-factor authentication for credit cards

Possible values returned by the server on failed payments:

AlreadyExecuted,
BearerInvalid,
BearerExpired,
Canceled,
LimitExceeded,
LoginError,
InsufficientBalance,
InternalError,
InvalidAmount,
InvalidBic,
InvalidCountry,
InvalidConfiguration,
InvalidCurrency,
InvalidData,
InvalidIBAN,
InvalidPreconditions,
InternalProviderError,
PermissionDenied,
PSPConnectionProblem,
PSPConnectionTimeout,
RateLimit,
Rejected,
UnmappedError //for PSP errors not mapped to a specific billwerk code
In this section: