Tpay
DOCS

Error Codes

Following table shows possibile error codes and related error that can be returned by API.

Error codeError description
access_denied
Adding bank account not allowed for current user
already_refunded
Transaction is already refunded
apple_pay_wallet_init_exception
An error occurred during Apple Pay initialization. Please try again later.
apple_pay_wallet_unavailable
Apple Pay channel is unavailable. Please try again later.
bank_group_does_not_exist
Provided bank group does not exist!
blik_token_not_present
BLIK token not present!

cannot_create_refund

Cannot create refund for this payment channel

Cannot create refund - time limit excedeed

cannot_create_transaction
Cannot create transaction
cannot_refund_collect_transaction
Cannot create refund for collect transaction
cannot_refund_marketplace_transaction
Cannot create refund for marketplace transaction
channel_passed_with_group
Property pay.channelId cannot be passed when pay.groupId is given
channel_unavailable
Provided channel is unavailable!
channel_unavailable_for_source
Provided channel is unavailable for given source
configuration_error
Wrong configuration
contact_data_missing
At least one contact person need to have contact data
country_not_valid
Country does not exists
crc_not_unique
Hidden description is not unique!
empty_autopayment
Autopayment cannot be empty!
encryption_error
Incorrect card encryption format

field_required

Main address must have a valid country specified

Object %s is required

general

An error occurred while the transaction create. Please try again later

An error occurred while the tokenization create. Please try again later

Unsupported merchant acquirer

Unable to fetch merchant by session

Unable to fetch merchant card

Unable to fetch merchant code

Error occurred during generate tokenization title

incorrect_content_type
Incorrect request content type
incorrect_save_param
Incorrect type

incorrect_token

Cannot pay with this token

Cannot remove this token

internal_server_error
Internal Server Error
invalid_account_id
Provided accountId is invalid

invalid_address_flag

At least one address with flag %s

Only one address should have flag %s

invalid_alior_installments_tripartite_articles_total_price
The articles total price is not equal to transaction amount!
invalid_alior_installments_tripartite_request_structure
The request structure for this channel is invalid!
invalid_card_token_length
Card token length is invalid!
invalid_file
Ensure file is correct
invalid_offer_code
Offer code cannot be used
invalid_qr_logo_image
Provided logo image is invalid
invalid_qr_logo_type
Provided not supported image type
invalid_qr_output_type
Requested not supported image type
invalid_qr_size
Requested not supported image size
invalid_request_body
Failed to decode request body

is_required

At least one address is required

At least one website is required

Card expiry date is required when refund by EISOP.

is_too_long
Website description should be up to 128 characters

mcc_invalid

Mcc not found

Mcc has been found, but cannot be used

no_acquirer
No acquirer
no_payment_data
Missing payment data
no_sufficient_funds_or_refund_limit_reached
No sufficient funds or the refund limit has been reached

not_array

Field should be array

Field should be array of elements

Element of field %s should by an array

Element of field %s should be an array

not_natural_int
pay.groupId Is not neutral

not_string

notification.$key Is not a string

payer.$key Is not a string

$field Is not a string

not_valid
This field is missing
partner_cannot_create_transaction
Partner can not create transactions!
payment_failed
Payment failed
refund_failed
Refund has not been created
refund_period_expired
Refund period expired
representative_or_contact_missing
Account need to have at least one representative and contact person
save_should_not_be_true_if_token_is_provided
Save should not be true if token is provided
too_low
amount Is too low. Should be greater than 0
transaction_blocked
The transaction is being processed
transaction_does_not_exist
Transaction does not exist
transaction_lock
The transaction is locked
transaction_select_error
Error while fetching transactions
ts:channel:amount_outside_range
Payment with Channel ID %s is not available for this amount.
ts:channel:both_channel_and_group_specified
You cannot specify both channelId and groupId on pay object.
ts:channel:channel_blocked
Channel with ID %s is currently blocked.
ts:channel:channel_disabled
Channel with ID %s is currently disabled.
ts:channel:channel_disabled_for_pos
Pos ID %s has not enabled payment with channel ID %s.
ts:channel:collect_prohibited
Channel ID %s is not available for collect payments.
ts:channel:group_disabled_for_pos
Pos ID %s has no enabled channels for group %s.
ts:channel:not_available
Channel with ID %s is not available.

ts:channel:not_found

Channel with ID %s was not found.

Channel for Group with ID %s was not found.

Card acquirer for merchant ID %s was not found.

ts:channel:source_prohibited
Payment with Channel ID %s is not available for %s source.
ts:channel:surcharge_prohibited
Channel ID %s is not available for surcharge payments.
ts:collect:amount_outside_range
Collect payment for Merchant ID %s is not available for this amount.
ts:collect:empty_collect_data
Collect data is required for collect merchant
ts:collect:iban_not_allowed
Bank Account Number %s is not on the allowed list for collect payments for Merchant ULID %s.
ts:country:not_valid
Country was not recognized: %s
ts:merchant:disabled
Payments for Merchant with ID %s are disabled.
ts:merchant:is_partner
Merchant with ID %s belongs to a Partner account. Payments are disabled.

ts:merchant:not_found

Merchant with ID %s was not found.

Merchant with ULID %s was not found.

ts:payer:phone:not_valid
Phone number is invalid: %s
ts:pos:not_found
Pos with ID %s was not found.
ts:pos:result_url_not_overridable
Result URL of this POS is set not to be overridable.
ts:request:no_ip
No client IP found in the request.
ts:transaction:not_inserted
Failure on insert for transaction with provisionary ID %s.
ts:transaction:payer_data_not_inserted
Failure on payer data insert for transaction with ID %d, ULID %s.
ts:transaction:payer_info_not_inserted
Failure on payer info insert for transaction with ID %d, ULID %s.
unexpected_field
Field %s is unexpected for this request
unsupported_blik_token
This channel does not support the BLIK token!
url_override_is_disabled
Cannot change result URL
validation_invalid_account_id
Provided accountId is invalid
validation_invalid_document_type
Provided document type is invalid
validation_invalid_person_id
Provided personId is invalid
wrong_alias
Wrong alias type sent with given data combination!
wrong_auth level_value
Wrong auth level for given purchase type!
wrong_autopayment_alias
Wrong alias type for autopayment!
wrong_date_format
Wrong date format
wrong_expiration_date_format
Wrong expiration date format!
wrong_frequency_format
Wrong frequency format!
wrong_init_date_format
Wrong init date format!
wrong_model_data_combination
Incorrect sent autopayment data combination!
wrong_purchase_type
Provided channel does not support selected purchase type!
wrong_status
Transaction is already paid or cancelled