Payments - Error codes

Learn about error codes and how to resolve them

Jupiter uses HTTP response status codes to indicate the success or failure of your API requests. If your request fails, Jupiter returns an error using the appropriate status code.

In general, there are three status code ranges you can expect:

• 2xx success status codes confirm that your request worked as expected.
• 4xx error status codes indicates an error because of the information provided (e.g., a required parameter was omitted).
• 5xx error status codes are rare and indicate an error with Jupiter’s servers.

Some 4xx errors that could be handled programmatically (e.g., a card is declined) include an error code a short string with a brief explanation. Below you will find a list of possible error codes that can be returned, along with additional information about how to resolve them.

Authorization Errors

• auth_header_not_present: authorization header is not provided in request.
• auth_invalid_api_token: authorization token provided in request is not valid.
• auth_invalid_api_user: user permissions are not correct for the api request.
• auth_invalid_role: user role is invalid.
• auth_invalid_submerchant: submerchant id is invalid. (NOTE: Submerchant ids should be a number.)
• auth_token_session: session for api user has expired or invalid.
• auth_invalid_content_type: content type for request is incorrect. Only type accepted is application/json. If an empty payload fails, try using empty brackets {} as a payload.

Transactions errors

• transaction_invalid_amount_decimals: amounts should be provided as a number with a dot as separator and only 2 decimal digits
• transaction_amount_exeeded: a cap is established for maximum amount depending on your user. If you need the cap to be revised, please contact support.
• transaction_malformed_token: transaction token does not correspond to a valid payment method.
• transaction_not_found: transaction is not in Jupiter records.
• transaction_reversal_error: reversal for the transaction has failed. If error persists after multiple requests, please contact support.
• transaction_no_token_provided: no payment method was provided in request.
• transaction_invalid_dynamic_fees: dynamic fee type, format or amount is not valid.
• transaction_tokenization_issue: tokenization request has failed.
• transaction_submerchant_invalid_status: merchant status is not valid for current operation.
• transaction_already_voided: transaction sent has already been voided.

Provisioning errors

• provisioning_invalid_payload: payload for merchant provisioning is invalid.
• provisioning_active_transactions: merchant can't be provisioned as transactions are still in transit.
• provisioning_active_payouts: merchant can't be provisioned as payouts are still in transit.
• payouts_error: payout request has failed.
• payouts_invalid_amount: amounts should be provided as a number with a dot as separator and only 2 decimal digits.
• payouts_invalid_payout: payout request is invalid.
• payouts_invalid_bank_account: bank account provided for payout is not valid.

Credit card processing errors

• tx_cc_partial_approved: a partial approval or authorization is the ability to partially authorize a transaction if the customer does not have the funds to cover the entire cost on their debit card, prepaid card or gift card. The merchant can obtain the remainder of the purchase amount in another form of payment.
• tx_cc_dvv_requested: dynamic currency conversion (DCC) is a credit card feature that allows you to make a point-of-sale (POS) credit card purchase in a foreign country using the currency of your home country.
• tx_cc_non_fin_card: non-financial debt consists of credit instruments issued by governmental entities, households and businesses that are not included in the financial sector.
• tx_cc_declined: a declined credit card transaction means that something went wrong while your purchase was being processed and that the purchase couldn’t be completed. If your credit card is declined, start by double-checking to ensure that you entered the right information. If you’re positive that you’re entering the correct information and your card is still being declined, check the back of your credit card for your issuer’s contact information.
• tx_cc_expired_card: card has expired.
• tx_cc_duplicated_approved: a transaction with identical amount and credit card information was submitted within the duplicate transaction window, yet it has been verified truthsworthy.
• tx_cc_duplicate: a transaction with identical amount and credit card information was submitted within the duplicate transaction window and has been rejected.
• tx_cc_pick_up_card: the error message “Pick up card” means that the cardholder bank has declined the transaction as the issuer wants to retrieve the card.
• tx_cc_referral_call_issuer: transaction has been declined and cardholder should contact issuer for assistance.
• tx_cc_balance_not_available: transaction could not retrieve card balance for processing transaction. Operation rejected.
• tx_cc_not_defined: transaction has been rejected with a non-defined cause. Cardholder should contact issuer for assistance.
• tx_cc_invalid_data: invalid credit card data sent.
• tx_cc_invalid_account: account is invalid.
• tx_cc_invalid_request: transaction request is invalid.
• tx_cc_auth_failed: transaction authorization failed.
• tx_cc_not_auth: transaction was not authorized and therefore rejected.
• tx_cc_out_of_balance: card has no available credit. Operation rejected.