SubscriptionJS Callbacks
Most SubscriptionJS methods provide a success callback. Please refer to each method to see in which form successData will be provided.
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 |
---|---|
| During the checkout, if it is actively aborted by the Customer |
| Technical problem on the Acquirer side |
| Transaction amount > higher than limit |
| Authorization declined on payment provider side |
| Payment bearer has expired, e.g. credit card has expired |
| Payment bearer has been rejected e.g. it is blacklisted or invalid |
| Invalid account holder |
| Invalid bank account |
|
|
| Invalid bank code |
| Invalid BIC (Bank Identifier Code |
| Card type not supported, e.g. No American Express supported by the acquirer |
| Invalid credit card number |
| Invalid validation code |
| Invalid credit card holder |
| Invalid configuration of the Payment Provider |
| Invalid country |
| Invalid/Not applicable coupon code |
| Invalid currency |
| Invalid data |
| Filled expiration date not matching card expiration date |
| Invalid Public Key |
| Invalid IBAN (International Bank Account Number) |
| Customer name either invalid or empty |
| Invalid payment data |
| Not supported payment method |
| Transaction can not be performed due to PSP specific error, e.g. reference code is already used |
| Invalid Vat ID |
| Technical problem on Billwerk+ platform |
| Technical problem on payment provider system |
| Rate limit esceeded |
| No answer from payment provider |
| Payment provider error not mapped to Billwerk+ erro code |
| 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