Cash Developer Portal
Crear cuenta

Support

Whatsapp
      
        Home
      HOLA.CASH API
        Quickstart
        API Reference
        Error codes
        Testing cards
        Sample code
      CHECKOUT WIDGET
        Quickstart
        Sample code
      E-COMMERCE PLUGINS
        Magento
        Woocommerce
      Ayuda
        Tutorials
        FAQs
      
        Contact sales




Support

Whatsapp

Error codes list

Details of Error codes returned by the API in the StatusDetail object in detail.code

API to the Hola Cash platform.

  • Supports:
    • Tokenization: Create and get payment tokens for credit cards.
    • Transaction: Charge, capture, refunds or get payments.
    • Order: Create or get orders.
    • Checkout: Get the checkout button to embed in your app or web page.

Details of Error codes returned by the API in the StatusDetail object in detail.code

Error codes list
Error code Description
successOperation successful
generic_errorAn error has occurred
invalid_responseAn unexpected error occurred
unauthorizedYou're not allowed to perform this operation
validation_errorThe request contains validation errors
action_requiredFurther action is required
new_cvv_requiredNew CVV value required
blocked_by_hola_cash_fraud_detectionThis action was blocked by hola.cash fraud detection
transaction_blockedThe transaction has been blocked
invalid_security_credentialsThe security credentials are not valid
invalid_anti_fraud_header_multipleMultiple instances of the anti-fraud header found. Just send one
invalid_anti_fraud_header_formatInvalid format for anti-fraud header, must be a valid JSON object that is converted to string and base64 encoded
invalid_anti_fraud_header_missing_ip_addressInvalid anti-fraud header, missing ip_address
invalid_anti_fraud_header_missing_device_idInvalid anti-fraud header, missing device_id
invalid_anti_fraud_header_missing_user_timezoneInvalid anti-fraud header, missing user_timezone
invalid_anti_fraud_header_invalid_user_timezoneInvalid format for user_timezone in the anti-fraud header
invalid_anti_fraud_header_invalid_ip_addressInvalid format for ip_address in the anti-fraud header
bank_account_clabe_unrecognizableCLABE is invalid
bank_account_clabe_already_existsCLABE is already in use
bank_account_clabe_associated_with_hola_cashYou cannot use this CLABE with hola.cash
bank_account_clabe_not_supported_spei_with_hola_cashThis CLABE is not supported with hola.cash
transaction_not_owned_by_cashuserYou do not own this transaction
transaction_already_completedTransaction is already completed
transaction_needs_more_information_to_completeMore information is required to complete the transaction
transaction_data_mismatchCould not find this transaction
transaction_pending_information_missingPending transaction with missing information
transaction_version_mismatchVersion mismatch
transaction_tid_invalidTransaction not found
transaction_pin_requiredPIN required to perform the transaction
transaction_already_cancelled_or_completedNo more actions possible on the transaction. The transaction has already been completed or cancelled
target_subaccount_not_openMerchant not valid
subaccount_not_verifiedInvalid merchant configuration. Merchant hasn't been verified
subscription_not_createdInvalid merchant configuration. Missing information
merchant_payment_disabledInvalid merchant configuration
merchant_is_cash_merchantInvalid merchant configuration
payment_method_not_allowedPayment method is not allowed
transaction_not_valid_capture_targetCannot capture this charge
transaction_capture_amount_greater_than_transaction_amountCannot capture more than original amount
transaction_not_valid_capture_target_already_capturedCharge was already captured
transaction_not_valid_capture_target_already_settledCharge was already settled
transaction_not_valid_capture_target_no_funds_to_captureCannot capture more than original amount
transaction_not_valid_capture_target_was_refundedCharge was already refunded
transaction_not_valid_refund_target_no_funds_to_refundCannot refund more than original amount
transaction_not_valid_refund_target_has_chargebackCannot refund, transaction has a chargeback
transaction_not_valid_refund_target_payment_method_type_not_supported_for_refundsPayment method type is not currently supported for refunds
transaction_not_valid_refund_target_transaction_created_date_invalidThe transaction exceeded the maximum time to make a refund.
transaction_not_valid_refund_target_subaccount_transacting_user_does_not_existsSubaccount transacting_user is not available for this subaccount
transaction_not_valid_capture_target_payment_method_type_not_supported_for_capturesPayment method type is not currently supported for captures
transaction_not_valid_completion_target_was_not_pendingTransaction to be completed is not longer in pending status
transaction_not_valid_cancellation_target_was_not_pendingTransaction to be cancelled is not longer in pending status
amount_limit_exceededYou have exceeded amount permitted on this card. Please use a different card or contact your bank
codi_transaction_blockedThis CODI transaction has been block, please try again later
credit_card_expired_yearCredit card is expired. Please correct the expiry information or use a different card
credit_card_expired_monthCredit card is expired. Please correct the expiry information or use a different card
incorrect_pinThe PIN is incorrect, please use a correct PIN and try again
credit_card_number_invalidCredit card number invalid. Please correct the information or use a different card
credit_card_expiredCredit card is expired. Please correct the expiry information or use a different card
credit_card_validation_code_requiredEnter a card validation code (CVV) and try again
test_credit_cardThis is a test credit card. Use a different credit card and try again
credit_card_validation_code_invalidCredit card validation code is not valid. Enter a valid code and try again
three_ds_authentication_failed3DS card authentication failed. Enter valid authentication and try again
credit_card_insufficient_fundsThis card does not have sufficient funds, please add fund or user a different card and try again
credit_card_stolenThe card was reported as stolen
credit_card_fraud_detectedThis transaction was blocked by hola.cash fraud detection
credit_card_purchase_not_supportedThis purchase is not permitted on this card. Please use a different card and try again or contact your bank
credit_card_not_supported_on_lineOnline purchases are not permitted for this card. Please contact your bank or use a different card and try again
credit_card_lostThe card was reported as lost
credit_card_restricted_by_bankThe bank has restricted the card
credit_card_hold_cardThe bank has requested the card to be retained
credit_card_call_bank_to_authorizeBank authorization is required for this charge. Please contact your bank or use a different card and try again
refund_failed_retry_after_24_hourTransaction can not be partially refunded today, try tomorrow.
temporary_error_try_again_laterThere was an error completing this transaction, please try again
card_declinedThis card has been declined by your bank. Please use a different card or contact your bank
order_not_foundThe requested order was not found
payment_token_not_validThe payment token is not valid
card_amount_highEnter a lower amount for the purchase and try again
card_amount_lowEnter a higher amount for the purchase and try again
data_issues_contact_hola_cashYour transaction has issues with the data submitted. Please contact hola.cash support to correct
merchant_email_address_already_existsMerchant email already exists
merchant_phone_number_already_existsMerchant phone number already exists
merchant_address_is_requiredMerchant address is required
invalid_merchant_categoryInvalid merchant category
merchant_username_already_existsMerchant username already exists
merchant_generic_validation_errorMerchant form contains validation errors
create_processor_account_failed_retryThis transaction attempt failed. Please retry in a few minutes
funds_transfer_not_supportedYour bank does not allow this action
card_withdrawal_limit_exceededYour bank has declined the transaction as the withdrawal limit has been exceeded
issuer_not_supportedYour bank does not support this card issuer
card_already_register_with_userThis card cannot be used for this transaction. Please use another card
invalid_card_expiryThe expiration date on this card is not valid. Please review the expiration date
3D_authentication_failed3DS authentication failed. Please try again or use another card
user_not_allowed_to_perform_transactionYou are not allowed to perform this action
service_errorService error
generic_processing_errorThe operation is not allowed for this customer or transaction
order_is_requiredThe hola.cash order id is required to be able to use use_order_payment_detail processing instruction as True
payment_detail_is_requiredTo create the charge you need to pass payment_detail and customer_details
order_payment_detail_and_customer_details_are_requiredThe provided hola.cash order should have associated the payment_detail and customer_details so we can execute the charge
order_already_associated_with_chargeThe provided hola.cash order is already associated to an existing completed charge
continuation_not_foundThe external reference id is not found.
invalid_query_paramThe query param provided in the API call is invalid
merchant_sub_account_does_not_existThe merchant does not have a subaccount related
merchant_does_not_existThe merchant does not exist
limit_out_of_boundsThe limit query param is invalid
integrity_or_database_issueThere was an issue performing the query, make sure that the query parameters are correct
invalid_cursor_after_or_beforeThe query param `after_id` or `before_id` must be a base64 string
after_id_and_before_id_both_presentMake sure to only send one of the following query param [after_id, before_id]
store_card_token_validation_failedstore card token validation failed
invalid_email_addressInvalid email address
digital_service_purchase_failureWe couldn't process the digital service purchase
payment_link_cannot_be_updatedWe cannot make this update to given payment link
payment_link_does_not_existsThis payment link does not exists.
payment_link_update_validation_errorThe body of the payment link update request has some validation error
payment_link_cannot_be_disabledTo disable a payment link make sure the current status of the payment link is 'active'
payment_link_cannot_be_enabledTo enable a payment link make sure the current status of the payment link is 'disabled'
payment_link_cannot_be_enabled_already_paid_max_timeswe cannot activate a payment link if it has already been paid maximum times
payment_link_cannot_be_enabled_past_expiration_datewe cannot activate a payment link if it has already been expired
amount_constraints_max_amount_exceeds_limitamount_constraints.maximum_amount must be less than the established max amount limit stablish for your account for payment link creation
amount_exceeds_limitThe amount must be less than the established max amount limit stablish for your account for payment link creation
amount_constraints_min_amount_lesser_than_minimum_limitamount_constraints.minimum_amount must be greater than the established min amount limit stablish for your account for payment link creation
amount_lesser_than_minimum_limitThe amount must be greater than the established min amount limit stablish for your account for payment link creation
create_charge_generic_validation_errorGeneral validation error on create charge
create_charge_invalid_phone_numberInvalid phone_number error on create charge
subscriptions_customer_not_foundThe customer provided was not found in the system. The subscription can not be created.
subscriptions_plan_not_foundThe plan provided was not found in the system. The subscription can not be created
subscriptions_inactive_planYou can not create a subscription with an inactive plan
plan_payment_link_creation_failedPayment link creation failed during plan creation
customer_could_not_be_createdThe customer could not be created in the system
subscription_could_not_be_createdThe subscription could not be created in the system
subscription_not_foundThe suscription was not found in the system
username_or_password_missing_errorUsername and/or Password to create login user were not provided
username_validation_did_not_pass_errorUsername validation did not pass, it must be a valid email address
password_validation_did_not_pass_errorPassword validation did not pass
payment_method_could_not_be_createdThe payment method could not be created in the system