Error Messages

Error Messages Guide

When processing transactions or requests, you might encounter the following errors:

Customer-Related Errors:

• Account Locked (customer_account_has_been_locked): The customer's Pay4Fun account is blocked.

• Account Approval Needed (customer_account_must_be_approved): The customer's Pay4Fun account hasn't been approved yet.

• Limit Reached (customer_money_in_limit_for_payment_method_type_reached): The customer has reached their transaction limit. They should contact Pay4Fun to update their profile.

• Not Authorized (customer_not_authorized): The customer is either suspended or blocked from performing transactions.

• Transaction Declined (declined_by_customer): The customer intentionally declined the transaction.

• Invalid Bank Data (invalid_bank_account_data): The bank account data provided by the customer is invalid.

• Invalid Main ID (invalid_customer_main_id): The customer's Main ID doesn't match the one specified in the request.

• Invalid Email (invalid_email): The customer's email address provided is not valid.

• Maximum Amount Exceeded (maximum_amount_exceeded): The transaction amount exceeds the maximum limit.

• Minimum Amount Not Met (minimum_amunt_not_reached): The transaction amount is below the minimum required.

• Customer Limit Reached (money_out_limit_reached): The customer has reached their transaction limit. They should contact Pay4Fun for profile updates.

Merchant-Related Errors:

• Duplicate Invoice ID (external_invoice_id_already_used): The Merchant's Invoice ID has been used in a previous transaction.

• Insufficient Balance (insufficient_balance): Your merchant balance is insufficient to complete the transaction.

• Invalid Request (invalid_request): The request sent is not valid.

• Invalid Currency (invalid_request_currency): The currency provided in the request is not valid.

• Hash Issue (invalid_security_hash): The Hash in the request seems off. Review the hash generation guidelines.

• Merchant Not Live (merchant_account_not_live): Your merchant account hasn't been activated for live transactions yet.

• Unauthorized IP Address (merchant_ip_not_authorized): The IP address making the API request isn't whitelisted.

• Merchant Not Authorized (merchant_not_authorized): Your merchant account isn't enabled.

• Merchant Not Found (merchant_not_found): The Merchant ID in the request isn't valid.

System-Related Errors:

• Processing Error (processing_error): An unexpected issue occurred while handling the merchant's request.