Overview

When using Jupico's APIs, you might encounter various error codes. Understanding these codes is essential to diagnose and resolve issues promptly. This guide provides an overview of the most common error codes and their meanings.

Error Codes

General Errors

Error Type	HTTP Code	Error Code	Error Message	Test Conditions
General	400	invalid_payload	Invalid payload.
General	404	wrong_url	Requested resource not found.
General	403	forbidden	Forbidden
General	503	service_unavailable	External service unavailable, try again later.	token: "b0a67cc8-d78e-4e71-afc3-2e8b00646973" amount: 101.10
General	500	internal_server_error	Internal server error.	token: "b0a67cc8-d78e-4e71-afc3-2e8b00646973" amount: 101.11

Authorization Errors

Error Type	HTTP Code	Error Code	Error Message
Authorization	401	auth_invalid_submerchant	SubMerchant not found or inactive
Authorization	401	auth_invalid_role	ApiUser not required permissions.
Authorization	401	auth_header_not_present	Authorization header missing.
Authorization	401	auth_invalid_api_token	Invalid api token.
Authorization	401	auth_invalid_api_user	ApiUser not active.
Authorization	401	auth_invalid_facilitator	Facilitator not found or inactive.
Authorization	401	auth_invalid_product	Product not found or inactive.
Authorization	401	auth_invalid_content_type	Invalid content type (expected: application/json)

Transaction Errors

Error Type	HTTP Code	Error Code	Error Message	Test Conditions
Transaction	200	tx_cc_declined	The card is declined.	token: "b0a67cc8-d78e-4e71-afc3-2e8b00646973" amount: 90.20
Transaction	200	tx_cc_declined_insufficient_funds	The card has insufficient funds.	token: "b0a67cc8-d78e-4e71-afc3-2e8b00646973" amount: 90.23
Transaction	200	tx_cc_declined_do_not_honor	The card is declined for an unknown reason.	token: "b0a67cc8-d78e-4e71-afc3-2e8b00646973" amount: 90.24
Transaction	200	tx_cc_declined_transaction_not_allowed	The card is declined to execute this type of transaction.	token: "b0a67cc8-d78e-4e71-afc3-2e8b00646973" amount: 90.25
Transaction	200	tx_cc_declined_stolen_card	The card is declined because it has been reported as stolen.	token: "b0a67cc8-d78e-4e71-afc3-2e8b00646973" amount: 90.26
Transaction	200	tx_cc_declined_fraudulent	The payment was declined because it is suspected as fraudulent.	token: "b0a67cc8-d78e-4e71-afc3-2e8b00646973" amount: 90.27
Transaction	200	tx_cc_declined_incorrect_cvc	The card security code is incorrect.	token: "b0a67cc8-d78e-4e71-afc3-2e8b00646973" amount: 90.22
Transaction	200	tx_cc_declined_incorrect_zip	The card postal code is incorrect.	token: "b0a67cc8-d78e-4e71-afc3-2e8b00646973" amount: 90.29
Transaction	200	tx_cc_declined_incorrect_number	The card number is incorrect.	token: "b0a67cc8-d78e-4e71-afc3-2e8b00646973" amount: 90.30
Transaction	200	tx_cc_declined_amount_exeeded	Amount exceeded sub-merchant limit.	token: "b0a67cc8-d78e-4e71-afc3-2e8b00646973" amount: 90.32
Transaction	200	tx_cc_declined_expired_card	The card is expired.	token: "b0a67cc8-d78e-4e71-afc3-2e8b00646973" amount: 90.31
Transaction	200	tx_cc_declined_pick_up_card	The cardholder bank has declined the transaction as the issuer wants to retrieve the card.	token: "b0a67cc8-d78e-4e71-afc3-2e8b00646973" amount: 90.28
Transaction	200	tx_cc_declined_referral_call_issuer	Transaction has been declined and cardholder should contact issuer for assistance.	token: "b0a67cc8-d78e-4e71-afc3-2e8b00646973" amount: 90.21
Transaction	200	tx_cc_declined_incorrect_address	The card address is incorrect.	token: "b0a67cc8-d78e-4e71-afc3-2e8b00646973" amount: 90.33
Transaction	200	tx_cc_declined_risk_profile	Transaction has been declined due to high risk.	token: "b0a67cc8-d78e-4e71-afc3-2e8b00646973" amount: 90.34
Transaction	200	tx_cc_declined_lost_card	The card is declined because the card is reported lost.	token: "b0a67cc8-d78e-4e71-afc3-2e8b00646973" amount: 90.35
Transaction	200	tx_cc_declined_restricted_card	This card is restricted and cannot be used for this transaction.	token: "b0a67cc8-d78e-4e71-afc3-2e8b00646973" amount: 90.36
Transaction	400	tx_cc_invalid_avs	AVS failed.
Transaction	400	tx_cc_duplicate	Transaction duplicated.	token: "b0a67cc8-d78e-4e71-afc3-2e8b00646973" amount: 100.12
Transaction	400	tx_cc_invalid_data	Invalid credit card data sent.
Transaction	400	tx_cc_not_auth	transaction was not authorized and therefore rejected.
Transaction	400	tx_cc_invalid_account	account is invalid or inactive
Transaction	400	tx_cc_token_corrupted	Credit card token corrupted, requires to be tokenized again.	token: "b0a67cc8-d78e-4e71-afc3-2e8b00646973" amount: 100.21
Transaction	400	tx_cc_token_not_found	Credit card token not found.	token: "b0a67cc8-d78e-4e71-afc3-2e8b00646973" amount: 100.22
Transaction	400	tx_cc_already_voided	Transaction already voided.	Create a transaction (sale/authorization) 2. Void it. 3. Try to void again.
Transaction	400	tx_cc_not_found	Transaction not found.	Provide an invalid "transactionId" for void, refund, capture operations
Transaction	400	tx_cc_reversal_failed	Reversal for the transaction has failed.	No additional information required
Transaction	400	tx_cc_error	Generic: (concat message error)	token: "b0a67cc8-d78e-4e71-afc3-2e8b00646973" amount: 100.17
Transaction	400	tx_cc_invalid_status	Invalid transaction status.	token: "b0a67cc8-d78e-4e71-afc3-2e8b00646973" amount: 100.18
Transaction	400	tx_cc_invalid_amount	Invalid amount for related transaction.	token: "b0a67cc8-d78e-4e71-afc3-2e8b00646973" amount: 100.19
Transaction	400	tx_cc_invalid_operation	This operation is invalid for related transaction.	Create an authorization Void the before transaction Try to capture the voided transaction (authorization) OR Try to refund an authorization
Transaction	400	tx_cc_already_refunded	Transaction already refunded.	Create a sale Create a full refund (same amount) of the before transaction Try to refund again
Transaction	400	tx_cc_disputed	Transaction disputed.
Transaction	400	tx_cc_void_unavailable	Unable to void: related transaction expired after 25 minutes.	token: "b0a67cc8-d78e-4e71-afc3-2e8b00646973" amount: 100.23
Transaction	400	tx_cc_invalid_taxWithHold	Parent and related transaction taxWithHold should match.
Transaction	400	tx_cc_invalid_refund_taxAmountRelease	Refund taxAmountRelease shouldn’t be greater than parent transaction taxAmount.
Transaction	400	tx_ach_declined_amount_exeeded	Amount exceeded sub-merchant limit.
Transaction	400	tx_ach_not_found	Amount exceeded sub-merchant limit.
Transaction	400	tx_ach_duplicate	Transaction duplicated.
Transaction	400	tx_ach_invalid_status	Invalid transaction status.
Transaction	400	tx_ach_invalid_amount	Invalid amount for related transaction.
Transaction	400	tx_ach_invalid_operation	This operation is invalid for related transaction.
Transaction	400	tx_ach_already_refunded	Transaction already refunded.
Transaction	400	tx_ach_reversal_failed	Reversal for the transaction has failed.
Transaction	400	tx_ach_token_not_found	Bank account token not found.
Transaction	400	tx_ach_token_corrupted	Bank account token corrupted, requires to be tokenized again.
Transaction	400	tx_ach_error	Generic
Transaction	400	tx_ach_invalid_taxWithHold	Parent and related transaction taxWithHold should match.
Transaction	400	tx_ach_invalid_refund_taxAmountRelease	Refund taxAmountRelease shouldn’t be greater than parent transaction taxAmount.
Transaction	400	tx_cc_taxAmount_exceeded	Tax amount exceeded.
Transaction	200	tx_cc_declined_unsupported_card	Unsupported card.
Transaction	400	tx_cc_retry	Please retry - possible reasons: format error, routing problem, system unavailable, or timeout.

Tokenization Errors

Error Type	HTTP Code	Error Code	Error Message
Tokenization	200	tkn_cc_expired_credit_card	The card is expired.
Tokenization	200	tkn_cc_invalid_expiration_year	Invalid expiration year, expected either YY or YYYY.
Tokenization	200	tkn_cc_invalid_expiration_month	Invalid expiration month, expected either M or MM.
Tokenization	200	tkn_cc_invalid_expiration_date	The card is expired.
Tokenization	200	tkn_cc_invalid_number	The card number is invalid.
Tokenization	200	tkn_cc_invalid_security_code	The security code is invalid.
Tokenization	200	tkn_cc_unsupported_card_type	Unsupported card type.
Tokenization	200	tkn_cc_live_mode_test	You are using a test card in live mode.
Tokenization	200	tkn_cc_insufficient_funds	The card has insufficient funds.
Tokenization	200	tkn_cc_do_not_honor	The card was declined for an unknown reason.
Tokenization	400	tkn_invalid_public_key	Invalid SubMerchant public key.
Tokenization	400	tkn_cc_not_tokenizable	Credit card not tokenizable.
Tokenization	400	tkn_error	Tokenization error.
Tokenization	401	tkn_oneTimeToken_expired	One time token expired
Tokenization	429	tkn_cc_too_many_requests	Too many requests.

Payout Errors

Error Type	HTTP Code	Error Code	Error Message
Payouts	400	payouts_invalid_status	Invalid payouts status.
Payouts	400	payouts_not_found	Payouts not found.
Payouts	400	payouts_insufficient_funds	Payouts funds insufficient.
Payouts	400	payouts_invalid_bank_account	Bank account not found or inactive.
Payouts	400	payouts_invalid_mode	Payouts invalid mode, expected dynamic.
Payouts	400	payouts_debit_invalid_amount	Amount in debit must be negative
Payouts	400	payouts_credit_invalid_amount	Amount in credit must be positive

Provisioning

Error Type	HTTP Code	Error Code	Error Message
backend	400	provisioning_application_invalid	SubMerchant applications not found or inactive.
backend	400	provisioning_application_missing_owner	This application type must have at least one owner.
backend	400	provisioning_ownershiptype_single_owner	This ownership type must have a single owner.
backend	400	provisioning_ownershiptype_invalid_owner	Owners are not valid for this type of application.
backend	400	provisioning_ownershiptype_invalid_identity	Invalid ownership type for this identity type.
backend	400	provisioning_ownership_invalid_percentage	The sum of all ownership percentages must be between 76% and 100%.
backend	400	provisioning_bank_account_already_tokenized	Bank account already tokenized.
backend	400	provisioning_bank_account_invalid_status	Bank account invalid status.
backend	400	provisioning_bank_account_not_found	Bank account not found.
backend	400	provisioning_invalid_identity_type	Invalid identity type.
backend	400	provisioning_invite_invalid	Invite not found or inactive.

Hosted Session Errors

Error Type	HTTP Code	Error Code	Error Message
Hosted session	400	hosted_session_not_found	Hosted session not found.
Hosted session	400	hosted_session_invalid_status	Hosted session has invalid status.
Hosted session	400	hosted_session_payment_link_invalid_status	Payment link has invalid status.

Invoice Errors

Error Type	HTTP Code	Error Code	Error Message
Invoice	400	invoice_invalid	Invoice not found or inactive.
Invoice	400	invoice_invalid_status	Invoice has invalid status.
Invoice	400	invoice_amount_exeeded	Amount exeeded SubMerchant limit.
Invoice	400	invoice_invalid_items_amount	Total amount of items is invalid.
Invoice	400	invoice_update_invalid_status	Status can only change from 'Draft' to 'Created' upon update.

Product Errors

Error Type	HTTP Code	Error Code	Error Message
Product	400	product_invalid	Product not found or inactive.
Product	400	product_invalid_mcc	Invalid mccCode.
Product	400	product_invalid_ownershiptype	Invalid ownership type.

Customer Errors

Error Type	HTTP Code	Error Code	Error Message
Customer	400	customer_invalid	Customer not found or inactive.

User Errors

Error Type	HTTP Code	Error Code	Error Message
User	400	api_user_invalid	Api user not found or inactive.

Subscription Errors

Error Type	HTTP Code	Error Code	Error Message
Subscription	400	subscription_error	Error on subscription.
Subscription	400	subscription_plan_invalid	Plan not found or inactive.
Subscription	400	subscription_plan_duplicated_name	Plan name is already in use.
Subscription	400	subscription_invalid	Subscription not found or inactive.
Subscription	400	subscription_schedule_not_found	Schedule does not exist on subscription.
Subscription	400	subscription_invalid_pricing_model	Wrong schedule's pricing model type.
Subscription	400	subscription_invalid_pricing_model_params	Subscription invalid pricing model params.
Subscription	400	subscription_active_subscribers	Plan has active subscribers.

Bank Account Errors

Error Type	HTTP Code	Error Code	Error Message
bankaccount	400	bankaccount_invalid_routing_number	Bank account routing number is invalid.
bankaccount	400	bankaccount_invalid_account_number	Bank account account number is invalid.