PayFacto API - v1.0 - Return Codes

PayFacto API - v1.0 - Return Codes

PayFacto API - v1.0 - Return Codes

Complete reference for all return codes returned by the PayFacto Payment API v1.0. Because the full list is too large for a single page, codes are organized by numeric range and alphabetic prefix. Use your browser's search (Ctrl+F / Cmd+F) to find a specific code.

πŸ”’

  Numeric Return Codes (2 & 3-Digit Codes)

Because the list of all possible return codes is too large for a single page, this section describes the available numeric return codes with 2 or 3 digits.

CodeDescriptionDetailsMerchant's Action Plan
00Transaction approvedThe transaction was completed without errors.No action to take.
01Guidance document / proposal refused
02Refer to the card issuer
03Invalid merchant
04Declined – Seize cardThe issuing bank sent a β€œseize card” status for reasons unknown.Seize the card and contact the acquirer.
05Transaction declinedThe transaction was declined. This may be due to several reasons.Retry the transaction. If the problem persists, contact PayFacto's customer service.
06Format errorA field (other than transaction code, amount, date, or card number) sent by the banking module as part of the transaction request is invalid or does not follow the acquirer's criteria.Retry the transaction with the same card. Retry the transaction with a different card. If the problem persists, contact PayFacto's customer service.
07Card seized / special conditions
08Recognize with approved ID
09Request being processed
10Approved for a partial amount
11VIP approved
12Invalid transactionThe transaction code sent by the banking module as part of the transaction request is invalid or does not follow the acquirer's criteria.Retry the transaction. If the problem persists, contact PayFacto's customer service.
13Invalid amountThe amount sent as part of the transaction request is invalid or does not follow the acquirer's criteria.Confirm the amount and retry. If the problem persists, contact PayFacto's customer service.
14Invalid card numberThe card number sent as part of the transaction request is invalid or does not follow the acquirer's criteria.Make sure you support this type of card and retry. Retry the transaction with a different card. If the problem persists, contact PayFacto's customer service.
15Invalid issuer
16Approved / update track 3
17Canceled by the client
18Conflict with the client
19Retry transactionRetry the transaction. If the problem persists, contact PayFacto's customer service.
20Invalid response
21No action taken
22Suspected abnormality
23Invalid transaction feesThe transaction fee amount sent as part of the transaction request is invalid or does not follow the acquirer's criteria.Confirm the transaction fee amount and retry. If the problem persists, contact PayFacto's customer service.
24Action File not received
25Record not found
26Duplicate record
27System error – AcquirerProblem with the acquirer's system.Retry the transaction. If the problem persists, contact the acquirer.
28System error – AcquirerProblem with the acquirer's system.Retry the transaction. If the problem persists, contact the acquirer.
29System error – AcquirerProblem with the acquirer's system.Retry the transaction. If the problem persists, contact the acquirer.
30Invalid format
31Bank not supported
32Partially filled
33Expired cardThe client's card is expired.Retry the transaction with a different card.
34Suspected fraud / seize card
35Contact acquirer / seize card
36Restricted cardThe card is subject to restrictions and cannot be used.Retry the transaction with a different card.
37Call the security of the acquirer
38Maximum number of PIN input attempts reached – Seize cardThe maximum number of attempts to enter the PIN has been reached.Seize the card and contact the acquirer.
39No credit account linked to the cardThere is no account linked to this card.Retry the transaction with a different card.
40Unsupported transactionThe requested transaction is not supported by the issuing bank.Contact the acquirer.
41Lost cardThis card has been declared lost and deactivated.Retry the transaction with a different card.
42No universal account
43Stolen cardThis card has been declared stolen and deactivated.Seize the client's card and contact the acquirer.
44No investment account
51Insufficient fundsThe client does not have sufficient funds in this account to perform the transaction.Retry the transaction with a different card.
52No checking accountThere is no checking account linked to this card.Retry the transaction with another account type or a different card.
53No savings accountThere is no savings account linked to this card.Retry the transaction with another account type or a different card.
54Expired card (from the issuing bank)The client's card has expired.Retry the transaction with a different card.
55Invalid PINThe client has entered the wrong PIN.Retry the transaction.
56Inactive cardThe issuing bank reports that this card has not been activated.Retry the transaction with a different card.
57Transaction not allowed with this cardThis transaction cannot be performed with this card.Retry the transaction with a different card. If the problem persists, contact PayFacto's customer service.
58Transaction not allowed on this terminalThe requested transaction cannot be performed on this terminal.Contact PayFacto's customer service.
59Suspected fraud / refuse
60Contact acquirer / refuse
61Withdrawal limit exceeded for this accountThe issuing bank has determined that the client has reached the maximum withdrawal amount.Retry the transaction with a different card.
62Limited use cardThe issuing bank claims that this card is restricted. The card cannot be used at the moment.Retry the transaction with a different card. If the problem persists, contact the acquirer.
63MAC security failureThe MAC key is invalid.Retry the transaction a few times (2 or 3). If the problem persists, contact PayFacto's customer service.
64Original amount incorrect
65Card use frequency limit reachedThe maximum number of withdrawals with this card has been reached.Retry the transaction with a different card.
66Call the security of the acquirer / refuse
67No ATM
68Response timed outThe maximum amount of time for the acquirer's response has been reached.Retry the transaction. If the problem persists, contact the acquirer.
75Maximum number of PIN input attempts reachedThe card has been blocked due to the high number of PIN entry attempts.Retry the transaction with a different card.
77Invalid transaction dateThe transaction date sent by the banking module as part of the transaction request is not valid. It does not correspond to the current or next day's date.Retry the transaction. If the problem persists, contact PayFacto's customer service.
78Maximum number of invalid PINs reachedThe card has been blocked due to the high number of PIN entry attempts.Retry the transaction with a different card.
81Invalid PIN blockSecurity problem.Retry the transaction a few times (2 or 3). Retry the transaction with a different card. Contact PayFacto's customer service.
82PIN length errorThe PIN must contain between 4 and 12 characters. The client is not entering the correct PIN.Retry the transaction if the client requests it.
84Invalid transaction sequence numberSynchronization problem with the acquirer.Retry the transaction a few times (2 or 3). If the problem persists, contact PayFacto's customer service.
87PIN key synchronization errorSecurity problem.Retry the transaction a few times (2 or 3). If the problem persists, contact PayFacto's customer service.
88MAC key synchronization errorSecurity problem.Retry the transaction a few times (2 or 3). If the problem persists, contact PayFacto's customer service.
90Abort In progress
91Issuing bank's system is inoperativeThe issuing bank's system cannot be reached.Contact the acquirer to report the problem.
92Cannot find financial institutionThe card's issuing bank is unknown.Retry the transaction with a different card.
93Violation of the law
94Duplicate transactionThe acquirer has already received this request.Retry the transaction. If the problem persists, contact PayFacto's customer service.
95Error of approximation
96Acquirer's system is faultyOne or more of the acquirer's processes are not functional.Retry the transaction. If the problem persists, contact the acquirer to report the problem.
266Transaction canceled
350Transaction timeout
πŸ”’

  Numeric Return Codes (3XXX)

Because the list of all possible return codes is too large for a single page, this section describes the available numeric return codes between 3000 and 3999.

CodeDescriptionDetailsMerchant's Action Plan
3666One or more terminals are busyEach merchant has a set number of terminals. Code 3666 indicates that a transaction was sent by the merchant and all the merchant's terminals are busy processing a transaction. This may be due to two causes: pending transactions are all directed to a server, thus overloading the CT-Payment Solution; or the number of terminals is insufficient to support a merchant's transaction during peak periods.If the problem persists, contact PayFacto's customer service.
3667Semi-integrated terminal is busyA recovery is currently being processed.Wait 15 seconds and retry the transaction. If the problem persists, contact PayFacto's customer service.
3668Waiting for a recoveryAn error has occurred with the semi-integrated terminal. A recovery must be executed before another transaction can be processed.Make sure everything is plugged in correctly. If needed, restart the driver, unplug and replug the power from the terminal. Wait 35 seconds and retry the transaction. If the problem persists, contact PayFacto's customer service.
3777Inexistent terminal and/or merchantA transaction merchant or terminal has not been configured in the Dispatcher module.If the problem persists, contact PayFacto's customer service.
πŸ”’

  Numeric Return Codes (5XXX)

Because the list of all possible return codes is too large for a single page, this section describes the available numeric return codes between 5000 and 5999.

CodeDescriptionDetailsMerchant's Action Plan
5000SuccessfulNo error.Continue the transaction process according to the documentation.
5001β€œNull” transaction codeThe parameter is null or blank.Check your application. The field must correspond to the specification provided in the documentation. If it does not, contact PayFacto's customer service.
5002Invalid size: transaction codeThe parameter received does not respect the length given in the merchant's API documentation.Check your application. The field must correspond to the specification provided in the documentation. If it does not, contact PayFacto's customer service.
5003Code_rejected_cotrans
5004β€œNull” value: company numberThe parameter received is null or blank.Check your application. The field must correspond to the specification provided in the documentation. If it does not, contact PayFacto's customer service.
5005Invalid size: company numberThe parameter received does not respect the length given in the merchant's API documentation.Check your application. The field must correspond to the specification provided in the documentation. If it does not, contact PayFacto's customer service.
5006Rejected company number
5008Invalid size: merchant numberThe parameter received does not respect the length given in the merchant's API documentation.Check your application. The field must correspond to the specification provided in the documentation. If it does not, contact PayFacto's customer service.
5009Code_rejected_nummarch
5010β€œNull” value: customer numberThe parameter received is null or blank.Check your application. The field must correspond to the specification provided in the documentation. If it does not, contact PayFacto's customer service.
5011Invalid size: customer numberThe parameter received does not respect the length given in the merchant's API documentation.Check your application. The field must correspond to the specification provided in the documentation. If it does not, contact PayFacto's customer service.
5012Code_rejected_numclient
5013β€œNull” value: amountThe parameter received is null or blank.Check your application. The field must correspond to the specification provided in the documentation. If it does not, contact PayFacto's customer service.
5014Invalid size: amountThe parameter received does not respect the length given in the merchant's API documentation.Check your application. The field must correspond to the specification provided in the documentation. If it does not, contact PayFacto's customer service.
5015Code_rejected_montant
5016β€œNull” value: invoice numberThe parameter received is null or blank.Check your application. The field must correspond to the specification provided in the documentation. If it does not, contact PayFacto's customer service.
5017Invalid size: invoice numberThe parameter received does not respect the length given in the merchant's API documentation.Check your application. The field must correspond to the specification provided in the documentation. If it does not, contact PayFacto's customer service.
5018Code_rejected_numfact
5019β€œNull” value: entry typeThe parameter received is null or blank.Check your application. The field must correspond to the specification provided in the documentation. If it does not, contact PayFacto's customer service.
5020Invalid size: entry typeThe parameter received does not respect the length given in the merchant's API documentation.Check your application. The field must correspond to the specification provided in the documentation. If it does not, contact PayFacto's customer service.
5021Code_rejected_typesaisie
5022β€œNull” value: card typeThe parameter received is null or blank.If the problem persists, contact PayFacto's customer service.
5023Invalid type: card typeThe parameter received does not respect the length given in the merchant's API documentation.If the problem persists, contact PayFacto's customer service.
5024Code_rejected_typecarte
5025β€œNull” value: card numberThe parameter received is null or blank.If the problem persists, contact PayFacto's customer service.
5026Invalid size: card numberAs a result of human intervention, the length value is not valid.If the problem persists, contact PayFacto's customer service.
5027Code_rejected_numcarte
5028β€œNull” value: expiration dateThe parameter received is null or blank.If the problem persists, contact PayFacto's customer service.
5029Invalid size: expiration dateAs a result of human intervention, the length value is not valid.If the problem persists, contact PayFacto's customer service.
5030Code_rejected_dateexpi
5031β€œNull” value: POS terminal numberThe parameter received is null or blank.Check your application. The field must correspond to the specification provided in the documentation. If it does not, contact PayFacto's customer service.
5032Invalid size: POS terminal numberAs a result of human intervention, the length value is not valid.Check your application. The field must correspond to the specification provided in the documentation. If it does not, contact PayFacto's customer service.
5033Code_rejected_numtpv
5034β€œNull” value: language codeThe parameter received is null or blank.Check your application. The field must correspond to the specification provided in the documentation. If it does not, contact PayFacto's customer service.
5035Invalid size: language codeAs a result of human intervention, the length value is not valid.Check your application. The field must correspond to the specification provided in the documentation. If it does not, contact PayFacto's customer service.
5036Code_rejected_colang
5037β€œNull” value: currencyThe parameter received is null or blank.Check your application. The field must correspond to the specification provided in the documentation. If it does not, contact PayFacto's customer service.
5038Invalid size: currencyAs a result of human intervention, the length value is not valid.Check your application. The field must correspond to the specification provided in the documentation. If it does not, contact PayFacto's customer service.
5039Code_rejected_devise
5040β€œNull” value: cashier numberThe parameter received is null or blank.Check your application. The field must correspond to the specification provided in the documentation. If it does not, contact PayFacto's customer service.
5041Invalid size: cashier numberAs a result of human intervention, the length value is not valid.Check your application. The field must correspond to the specification provided in the documentation. If it does not, contact PayFacto's customer service.
5042Code_rejected_numcaissier
5043β€œNull” value: β€œsuccessful” URLThe parameter received is null or blank.Check your application. The field must correspond to the specification provided in the documentation. If it does not, contact PayFacto's customer service.
5044β€œNull” value: β€œfailure” URLThe parameter received is null or blank.Check your application. The field must correspond to the specification provided in the documentation. If it does not, contact PayFacto's customer service.
5050Customer's time is upThe time allocated to the entry page was up before the customer could press the β€œPay” button.The customer must start the transaction over again. He/she has three minutes to enter his/her credit card data and press the Pay button.
5051Interaction with the database has failed1. The payment server cannot find the transaction information to be returned to the customer. 2. The payment server cannot connect to the payment solution database. 3. The payment solution database is not available to conduct a SQL request.If the problem persists, contact PayFacto's Customer Service.
5052Invalid merchant1. The merchant number in the request is not the one given in the PayFacto solution. 2. The merchant number is not configured on PayFacto's servers.Check your application. The field must correspond to the value provided by customer service when the payment solution was being integrated. If this is not the case, contact PayFacto's customer service.
5053Invalid company1. The company number in the request is not the one given in the PayFacto solution. 2. The company number is not configured on PayFacto's servers.Check your application. The field must correspond to the value provided by customer service when the payment solution was being integrated. If this is not the case, contact PayFacto's customer service.
5054Inactive companyThe customer is not active.If the problem persists, contact PayFacto's customer service.
5055Invalid addressThere is no configured address for the merchant.Ask your customer administrator to configure the address in the management tool or contact PayFacto's customer service.
5056Code_error_redir_infos
5057Code_error_client_address
5058Code_error_url_cont_deta
5059Code_error_card_list
5060Session invalid or expiredThe session is not valid or does not exist. The time has expired or the transaction has already been processed.Start the transaction over.
5061Code_w4redir_noresponse
5062Code_w4redir_fatalerror
5071Transaction cancelled by the customerThis happens when the client hits the β€œCancel” button on the entry page.The customer must start the transaction over if he/she has made an error. If not, processing ends.
5072Invalid POST parametersAcxsys returned parameters are invalid.Contact PayFacto customer service.
5073Transaction not completedTransaction was not completed at the customer's financial institution.Retry the transaction.
5074IOP version not supportedThe Interac online version returned by Acxsys is invalid.Contact PayFacto customer service.
5075Invalid redirection URLAcxsys redirection session parameters are invalid.Contact PayFacto customer service.
5076Invalid or expired sessionThe session is invalid or expired.Retry the transaction.
5077Cancellation of the transaction on the receipt pageTransaction cancelled by the customer on the receipt page.Retry the transaction.
5079Transaction cancelledTransaction is cancelled (ACK not received) before merchant's request for redirection's response.Retry the transaction.
5110Raw_Buf invalidEncryption status. Impossible to decrypt the data received from the merchant API.If the problem persists, contact PayFacto's customer service.
5111Decrypting is impossibleEncryption status. Impossible to decrypt the data received from the merchant API.If the problem persists, contact PayFacto's customer service.
5112Backup requestEncryption status. The merchant's unique identifier is not the one supplied in the API; the server recommends performing security encryption.If the problem persists, contact PayFacto's customer service.
5113Merchant's unique identification number is not validThe merchant's unique identification number is not valid.If the problem persists, contact PayFacto's customer service.
5800Code_fatal_sql_exception
5801Code_fatal_crypt_exception
5802Code_fatal_user_api_exception
5803Code_fatal_protocol_exception
5804Code_fatal_sym_crypt_exception
5805Code_fatal_unknown_exception
5806Code_fatal_unknown_trx_exception
5807Code_fatal_unknown_sid_exception
5808Code_fatal_mercapi_exception
πŸ”’

  Numeric Return Codes (6XXX)

Because the list of all possible return codes is too large for a single page, this section describes the available numeric return codes between 6000 and 6999.

CodeDescriptionDetailsMerchant's Action Plan
6000Invalid fileCheck file. If the problem persists, contact PayFacto's Customer Service.
6001Batch number already usedThe batch number must be unique.Change the number and resend the file. If the problem persists, contact PayFacto's Customer Service.
6002Incorrect parameter in a transactionOne or more transactions have a parameter in an incorrect format.Check file. If the problem persists, contact PayFacto's Customer Service.
6003Invalid number of transactionsThe number of transactions specified in the header does not match the number of transactions in the file.Check the file. If the problem persists, contact PayFacto's Customer Service.
6004Invalid headerThe header has an invalid format.Check the file. If the problem persists, contact PayFacto's Customer Service.
6005Invalid merchantThe merchant specified in the header does not match the merchant whose batch is to be processed.Check the file. If the problem persists, contact PayFacto's Customer Service.
6006Cannot decryptMake sure that the file was properly encrypted and transmitted. If the problem persists, contact PayFacto's Customer Service.
6007Decryption errorIf the problem persists, contact PayFacto's Customer Service.
6008Cannot encryptIf the problem persists, contact PayFacto's Customer Service.
6009Encryption errorIf the problem persists, contact PayFacto's Customer Service.
6010Cannot move fileThe file could not be moved from the β€œout” directory to the β€œdone” directory because of the FTP server security settings.Make sure that the user name used by PayFacto has the necessary rights to move files. If the problem persists, contact PayFacto's Customer Service.
6012No transaction foundA batch must contain at least one transaction.If the problem persists, contact PayFacto's Customer Service.
6013Invalid extension for an unencrypt fileThe file extension must be CSV or TXT.The extension must match the specifications stated in the documentation. If the problem persists, contact PayFacto's customer service.
6014Invalid extension for an encrypt fileThe file extension must be ENC.The extension must match the specifications stated in the documentation. If the problem persists, contact PayFacto's customer service.
6015An error occurred while archiving the file.If the problem persists, contact PayFacto's customer service.
6016The batch processing number is invalid.Verify the batch processing number.The batch processing number must match the specifications stated in the documentation. If the problem persists, contact PayFacto's customer service.
6020Transaction timeoutCheck the transaction report to determine whether that transaction was processed. If the problem persists, contact PayFacto's Customer Service.
πŸ”’

  Numeric Return Codes (8XXX)

Because the list of all possible return codes is too large for a single page, this section describes the available numeric return codes between 8000 and 8999. These codes are specific to the recurring billing module.

CodeDescriptionDetailsMerchant's Action Plan
8101Null value: client numberThe value of this field does not follow the specifications stated in the recurrence documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
8102Invalid value: client numberThe value of this field does not follow the specifications stated in the recurrence documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
8103Null value: nameThe value of this field does not follow the specifications stated in the recurrence documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
8104Invalid value: nameThe value of this field does not follow the specifications stated in the recurrence documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
8105Null value: emailThe value of this field does not follow the specifications stated in the recurrence documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
8106Invalid value: emailThe value of this field does not follow the specifications stated in the recurrence documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
8107Null value: credit cardThe value of this field does not follow the specifications stated in the recurrence documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
8108Invalid value: credit cardThe value of this field does not follow the specifications stated in the recurrence documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
8109Null value: expiration dateThe value of this field does not follow the specifications stated in the recurrence documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
8110Invalid value: expiration dateThe value of this field does not follow the specifications stated in the recurrence documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
8111Null value: tokenThe value of this field does not follow the specifications stated in the recurrence documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
8112Invalid value: tokenThe value of this field does not follow the specifications stated in the recurrence documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
8113Null value: languageThe value of this field does not follow the specifications stated in the recurrence documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
8114Invalid value: languageThe value of this field does not follow the specifications stated in the recurrence documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
8115Unknown client numberThe value of this field does not exist on the server.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
8116Client not verifiedClient is not verified.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
8117Client has no cardThere is no credit card associated with this client.Add a credit card to the client record.
8118Pre-authorization check failedThe pre-authorization to check if the card is valid to the issuer, failed.Check your transaction list to obtain the reason why it was refused.
8119Invalid value: statusThe value of this field does not follow the specifications stated in the recurrence documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
8120Invalid value: merchant idThe value of this field does not follow the specifications stated in the recurrence documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
8121Null value: sessionThe value of this field does not follow the specifications stated in the recurrence documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
8122Unknown value: sessionThe value of this field does not follow the specifications stated in the recurrence documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
8123Invalid value: sessionThe value of this field does not follow the specifications stated in the recurrence documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
8124Invalid value: URLThe value of this field does not follow the specifications stated in the recurrence documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
8125Invalid length: URLThe value of this field does not follow the specifications stated in the recurrence documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
8130Invalid value: beginning dateThe value of this field does not follow the specifications stated in the recurrence documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
8131Invalid value: end dateThe value of this field does not follow the specifications stated in the recurrence documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
8132Invalid value: account numberThe value of this field does not follow the specifications stated in the recurrence documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
8133Invalid value: descriptionThe value of this field does not follow the specifications stated in the recurrence documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
8134Invalid value: TokenThe value of this field does not follow the specifications stated in the recurrence documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
8135Invalid value: IDThe value of this field does not follow the specifications stated in the recurrence documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
8136Wrong ID numberThe value of this field does not follow the specifications stated in the recurrence documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
8137Wrong tokenThe value of this field does not follow the specifications stated in the recurrence documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
8138Invalid value: merchantThe value of this field does not follow the specifications stated in the recurrence documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
8139Invalid value: statusThe value of this field does not follow the specifications stated in the recurrence documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
8140Invalid value: amountThe value of this field does not follow the specifications stated in the recurrence documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
8141Invalid value: frequencyThe value of this field does not follow the specifications stated in the recurrence documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
8142Invalid value: currencyThe value of this field does not follow the specifications stated in the recurrence documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
8143Invalid value: number of withdrawalThe value of this field does not follow the specifications stated in the recurrence documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
8144Wrong statusThe value of this field does not match the value on the server.Retry the transaction. If the problem persists, contact PayFacto's customer service.
8145Wrong subscription numberThe value of this field does not match the value on the server.Retry the transaction. If the problem persists, contact PayFacto's customer service.
8146Invalid recurring amountThe value of this field does not follow the specifications stated in the recurrence documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
8147Invalid subscriberThe value of this field does not follow the specifications stated in the recurrence documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
8148Invalid merchantThe value of this field does not follow the specifications stated in the recurrence documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
8149Invalid next bill dateThe value of this field does not follow the specifications stated in the recurrence documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
8150Invalid invoice numberThe value of this field does not follow the specifications stated in the recurrence documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
8151Invalid invoice statusThe value of this field does not follow the specifications stated in the recurrence documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
8152Wrong tokenThe value of this field does not follow the specifications stated in the recurrence documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
8153Invalid last bill dateThe value of this field does not follow the specifications stated in the recurrence documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
8154The start date must be earlier than the end date.The value of this field does not follow the specifications stated in the recurrence documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
8155The next bill date must be earlier than the end date.The value of this field does not follow the specifications stated in the recurrence documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
8156Invalid value: CVVThe value of this field does not follow the specifications stated in the documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
πŸ”’

  Numeric Return Codes (9XXX)

Because the list of all possible return codes is too large for a single page, this section describes the available numeric return codes between 9000 and 9999. Most field-level validation errors fall in this range.

CodeDescriptionDetailsMerchant's Action Plan
9001Null value: transaction codeThe received parameter is either null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9002Invalid length: transaction codeThe received parameter doesn't follow the required length mentioned in the documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9003Rejected value: transaction codeThe received parameter is not in the list of possible values for this field, as mentioned in the documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9004Null value: company numberThe received parameter is either null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9005Invalid length: company numberThe received parameter doesn't follow the length described in the documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9006Rejected value: company numberThe received parameter is not configured in the payment solution.Make sure that the application uses the correct company number, provided by PayFacto when the payment solution was integrated. If it does, contact PayFacto's Customer Service.
9007Null value: merchant numberThe received parameter is either null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9008Invalid length: merchant numberThe received parameter doesn't follow the length described in the documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9009Rejected value: merchant numberThe received parameter is not configured in the payment solution.Make sure that your application uses the merchant number provided by PayFacto when the payment solution was integrated. If it does, contact PayFacto's Customer Service.
9010Null value: customer numberThe received parameter is either null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9011Invalid length: customer numberThe received parameter doesn't follow the length described in the documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9012Rejected value: customer numberThe received parameter doesn't follow the specifications described in the documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9013Null value: amountThe received parameter is either null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9014Invalid length: amountThe received parameter doesn't follow the length described in the documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9015Rejected value: amountThe received parameter doesn't follow the specifications described in the documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9016Null value: bill numberThe received parameter is either null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9017Invalid length: bill numberThe received parameter doesn't follow the length described in the documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9018Rejected value: bill numberThe received parameter doesn't follow the specifications described in the documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9019Null value: input typeThe received parameter is either null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9020Invalid length: input typeThe received parameter doesn't follow the length described in the documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9021Rejected value: input typeThe received parameter is not in the list of possible values for this field, as mentioned in the documentation, or the input type is valid but not associated with the merchant.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9022Null value: card typeThe received parameter is either null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9023Invalid length: card typeThe received parameter doesn't follow the length described in the documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9024Rejected value: card typeThe received parameter is not in the list of possible values for this field, as mentioned in the documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9025Null value: card numberThe received parameter is either null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9026Invalid length: card numberThe received parameter doesn't follow the length described in the documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9027Rejected value: card numberThe received parameter doesn't follow the specifications described in the documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9028Null value: expiration dateThe received parameter is either null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9029Invalid length: expiration dateThe received parameter doesn't follow the length described in the documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9030Rejected value: expiration dateThe received parameter doesn't follow the specifications described in the documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9031Null value: POS terminal numberThe received parameter is either null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9032Invalid length: POS terminal numberThe received parameter doesn't follow the length described in the documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9033Rejected value: POS terminal numberThe received parameter doesn't follow the specifications prescribed in the documentation, or the merchant is not a POS terminal merchant.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9034Null value: language codeThe received parameter is either null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9035Invalid length: language codeThe received parameter doesn't follow the length described in the documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9036Rejected value: language codeThe received parameter is not in the list of possible values for this field, as mentioned in the documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9037Null value: currencyThe received parameter is either null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9038Invalid length: currencyThe received parameter doesn't follow the length described in the documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9039Rejected value: currencyThe received parameter is not in the list of possible values for this field, as mentioned in the documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9040Null value: operator idThe received parameter is either null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9041Invalid length: operator idThe received parameter doesn't follow the length described in the documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9042Rejected value: operator idThe received parameter is rejected, because it does not respect the specifications of the field mentioned in the documentation.Check your application. The field must correspond to the given specification in the documentation. If it is not the case, contact PayFacto's customer service.
9043Database errorThe parameter received was null.Contact PayFacto's Customer Service.
9044Empty character [banking module's response]The received parameter is null.If the problem persists, contact PayFacto's Customer Service.
9045Invalid responseInvalid response coming from the monitoring transactions.You should not receive this return code. It is reserved for an internal PayFacto solution application.
9046Incomplete responseThe Dispatcher module's response is incomplete according to the communication protocol. This is often caused by a communication problem.Retry the transaction. If the problem persists, contact PayFacto's Customer Service.
9047Banking module protocol errorCritical error recording a terminal's status into the database.Retry the transaction. If the problem persists, contact PayFacto's Customer Service.
9048Submitted twiceThe bill number submitted has already been used for another transaction and the merchant's management tool's configuration prohibits bill duplicates.Configure the application so as not to send the same bill number twice, or contact PayFacto's Customer Service to modify the configuration in order to allow the change.
9049Fatal error 1A critical error occurred while processing the transaction.Retry the transaction. If the problem persists, contact PayFacto's Customer Service.
9050Fatal error 2A critical error occurred while processing the transaction.Retry the transaction. If the problem persists, contact PayFacto's Customer Service.
9051Time outTransaction processing has timed out. This is often caused by an inactive Dispatcher module.Retry the transaction. If the problem persists, contact PayFacto's Customer Service.
9052Protocol error
9053Server error
9054Inactive merchant codePOS terminal merchant is deactivated in the payment solution's configuration.If the problem persists, contact PayFacto's Customer Service.
9055Database errorA critical error occurred while processing the transaction with the database.If the problem persists, contact PayFacto's Customer Service.
9056Null value: original invoice numberThe received parameter is null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9057Invalid length: original invoice numberThe received parameter doesn't follow the length described in the documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9058Rejected value: original invoice numberThe received parameter was rejected because it does not follow the documentation's guidelines.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9059Terminal busyIn POS terminal mode, the terminal passed as a parameter is busy processing a transaction. This may occur when two transactions are sent simultaneously to the same terminal.Retry the transaction. If the problem persists, contact PayFacto's Customer Service.
9060Terminal busy in DispatcherIn POS terminal mode, the terminal passed as a parameter is unavailable in the Dispatcher module. This can be caused by a reversal, which congests the terminal for a moment.Retry the transaction. If the problem persists, contact PayFacto's Customer Service.
9061Invalid responseInvalid response coming from the monitoring transactions.No return code should appear. It is reserved for an internal PayFacto solution application.
9062Company number does not match that of original transactionThe original transaction number you submitted exists, but is not associated with your company number. Possible for refunds without a card and preauthorization transactions.Check your application. Make sure you have the correct original transaction number and company number.
9063Merchant number does not match that of original transactionThe original transaction number you submitted exists but is not associated with your merchant number. Possible for refunds without a card and preauthorization transactions.Check your application. Make sure you have the correct original transaction number and company number.
9064Original invoice number does not match that of original transactionThe original transaction number you submitted is different from that received when processing the original transaction. Possible for refunds without a card and preauthorization transactions.The original invoice number must be the same as that of the original transaction.
9065Original transaction is not a purchaseYou are trying to perform a refund without a card for an original transaction that is not a purchase.You may only perform refunds without a card for purchase transactions. Make sure you have the correct original transaction number.
9066Invalid original transaction statusThe original transaction's status is invalid and does not allow you to perform the transaction. The transaction was most likely declined or cancelled.Make sure the original transaction has a suitable status for the transaction you just tried. If it does, contact PayFacto's Customer Service.
9067Original authorization number does not match that of the original transactionThe authorization number parameter you have entered exists, but is not associated with your merchant number.Check your application. The original authorization number must match that of the original transaction you are trying to perform (preauthorization).
9068The original transaction number does not match any actual transactionThere is no transaction in the system matching the original transaction number you have sent.Check your application. Make sure that you are sending the correct original transaction number.
9069Original transaction is not a preauthorizationThe original transaction parameter sent during the transaction is not a refund.Check your application. Make sure that you are sending the correct original transaction number.
9101No record found
9102Invalid length: original reference numberThe parameter received doesn't respect the length that the documentation mentioned.No return code should be received. It is reserved for an internal PayFacto solution application.
9103Invalid length: original authorization numberThe parameter received doesn't respect the length that the documentation mentioned.No return code should be received. It is reserved for an internal PayFacto solution application.
9106Batch not ready to close
9107Invalid amount for cancellation managerThe amount of the cancelled transaction is not equal to the amount of the original transaction.
9108Completion errorThere was an error completing a preauthorization.Retry the transaction. If the problem persists, contact PayFacto's Customer Service.
9109Preauthorization already completedA preauthorization has already been performed for the transaction. You can only perform a preauthorization once.Check your application. Make sure that the preauthorization has not already been performed.
9110Amount is too high for transactionThe transaction amount is higher than that of the preauthorization. The transaction amount must be equal to or lower than the preauthorization amount.Check your application. Make sure that the amount you are sending is equal to or lower than the preauthorized amount.
9111Raw buffer impossibleDecryption status. Cannot decrypt the data sent by the merchant API.Retry the transaction. If the problem persists, contact PayFacto's Customer Service.
9112Cannot decryptDecryption status. Cannot decrypt the data sent by the merchant API.Retry the transaction. If the problem persists, contact PayFacto's Customer Service.
9113Backup requestedDecryption status. The merchant's unique identifier is not that provided by the API; the server recommends switching to safety encryption.Retry the transaction. If the problem persists, contact PayFacto's Customer Service.
9114Merchant cannot perform transactionThis transaction is deactivated in the payment solution's configuration.Contact PayFacto's Customer Service to enable this transaction in your configuration.
9115Administrative transaction in progressA batch closing process is in progress for this merchant. No transaction can be performed while closing a batch.Wait a few moments and retry the transaction. If the problem persists, contact PayFacto's Customer Service.
9116Transaction code is not compatible with input typeA refund without card is attempted for a POS terminal merchant (PIN pad input). You cannot perform a refund without card transaction on a PIN pad.Check your application. Make sure that you have not sent the refund transaction without card on a point-of-sale terminal.
9117Null value: track fieldThe received parameter is either null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9118Invalid length: track fieldThe received parameter doesn't follow the length described in the documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9119Rejected value: track fieldThe received parameter was rejected: it does not follow the field's specifications stated in the documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9120Invalid transaction with selected input typeThe selected transaction type cannot be performed with this input type.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9121Validation status of the verification code is invalidThe transmitter received an invalid verification code.Retry the transaction.
9122Validation status of the verification code is invalid (CVV/CVC2 = N)The transmitter received the verification code but it does not correspond with that which should be on the card.Communicate with the cardholder to check the three-digit code before carrying out the transaction even if the authorization request was approved. Retry the transaction.
9123Validation status of the verification code is invalid (CVV/CVC2 = S)The transmitter could not carry out the verification of the three-digit code and warns the merchant that the card should contain a three-digit code.Communicate with the cardholder to check the three-digit code before carrying out the transaction. Retry the transaction.
9126Invalid tokenThe received parameter doesn't follow the length described in the documentation or is valid but not associated with the merchant/client.Verify your data. The field must match the specifications stated in the documentation. If it does, contact PayFacto's Customer Service.
9127Inactive clientThe received token matches a client who was removed from the recurrence.Verify your data.
9128Invalid transaction for the acquirerThe transaction type is not supported by the acquirer.Contact PayFacto's Customer Service.
9129Invalid input type for the acquirerThe input type is not supported by the acquirer.Contact PayFacto's Customer Service.
9130Invalid transactions status for a recoveryThe transaction is not in a valid status for a recovery.Retry the transaction. If the problem persists, contact PayFacto's Customer Service.
9131Recovery impossible for the terminalThe recovery can only be done with a semi-integrated terminal.Retry the transaction. If the problem persists, contact PayFacto's Customer Service.
9132Card Bin blockedThe Card Bin was blocked by the risk team to avoid Bin attacks.The client must use another card.
9133Token with expired credit cardReceived token matches a customer with an expired credit card.You must obtain the customer's new credit card information and update the customer profile in order to process a transaction with that token.
9134Token with no credit cardReceived token corresponds to a customer who has no credit card in their profile.You must obtain the customer's credit card information and update the customer profile in order to process a transaction with that token.
9135Invalid length: Transaction IDThe received parameter doesn't follow the length described in the documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9136Rejected value: Transaction IDThe received parameter was rejected: it does not follow the field's specifications stated in the documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9137Invalid transaction with selected input typeThe selected transaction type cannot be performed with this input type.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9138Invalid Acquirer configurationAcquirer selected for the merchant is invalid.Contact PayFacto's Customer Service.
9139Invalid transaction for the acquirerThe transaction type is not supported by the acquirer.Contact PayFacto's Customer Service.
9140Invalid length: Issuer confirmation numberThe received parameter doesn't follow the length described in the documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9141Rejected value: Issuer confirmation numberThe received parameter was rejected: it does not follow the field's specifications stated in the documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9142Invalid length: Issuer nameThe received parameter doesn't follow the length described in the documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9143Rejected value: Issuer nameThe received parameter was rejected: it does not follow the field's specifications stated in the documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9144β€œNull” value: AVS AddressThe parameter is null or blank.Check your application. The field must correspond to the specification provided in the documentation. If it does not, contact PayFacto's customer service.
9145β€œNull” value: Postal codeThe parameter is null or blank.Check your application. The field must correspond to the specification provided in the documentation. If it does not, contact PayFacto's customer service.
9146Validation status of the verification code is invalid (AVS = Z)
9147Validation status of the verification code is invalid (AVS = A)
9148Validation status of the verification code is invalid (AVS = N)
9149Validation status of the verification code is invalid (AVS = U) / Invalid length: CAVVThe value of this field does not follow the specifications stated in the recurrence documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9150β€œNull” value: XIDThe parameter is null or blank.Check your application. The field must correspond to the specification provided in the documentation. If it does not, contact PayFacto's customer service.
9151Invalid length: XIDThe value of this field does not follow the specifications stated in the recurrence documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9152Invalid length: UCAFThe value of this field does not follow the specifications stated in the recurrence documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9155Transaction not cancellable.The original transaction type is not cancellable.The merchant must retry with another original transaction.
9160Invalid length: OEM Wallet DataThe received parameter doesn't follow the length described in the documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9161Rejected value: OEM Wallet DataThe received parameter was rejected: it does not follow the field's specifications stated in the documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9162Original transaction is not an In-App PurchaseOriginal transaction provided is not an In-App Purchase.Make sure you have the correct original transaction number.
9163Original transaction is not an In-App refundOriginal transaction provided is not an In-App Refund.Make sure you have the correct original transaction number.
9164Null value: TUIDThe parameter is null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9165Invalid length: TUIDThe received parameter doesn't follow the length described in the documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9166Rejected value: TUIDThe received parameter was rejected: it does not follow the field's specifications stated in the documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9200Null value: Transaction typeThe parameter is null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9201Invalid length: Transaction typeThe value of this field does not follow the specifications stated in the recurrence documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9202Rejected value: Transaction typeThe received parameter was rejected: it does not follow the field's specifications stated in the documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9203Null value: Debit typeThe parameter is null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9204Invalid length: Debit typeThe value of this field does not follow the specifications stated in the recurrence documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9205Rejected value: Debit typeThe received parameter was rejected: it does not follow the field's specifications stated in the documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9206Null value: Start dateThe parameter is null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9207Invalid length: Start dateThe value of this field does not follow the specifications stated in the recurrence documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9208Rejected value: Start dateThe received parameter was rejected: it does not follow the field's specifications stated in the documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9209Null value: End dateThe parameter is null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9210Invalid length: End dateThe value of this field does not follow the specifications stated in the recurrence documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9211Rejected value: End dateThe received parameter was rejected: it does not follow the field's specifications stated in the documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9212Null value: FrequencyThe parameter is null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9213Invalid length: FrequencyThe value of this field does not follow the specifications stated in the recurrence documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9214Rejected value: FrequencyThe received parameter was rejected: it does not follow the field's specifications stated in the documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9215Null value: Number of debitsThe parameter is null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9216Invalid length: Number of debitsThe value of this field does not follow the specifications stated in the recurrence documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9217Rejected value: Number of debitsThe received parameter was rejected: it does not follow the field's specifications stated in the documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9218Fatal error
9219Rejected value: Batch numberThe received parameter was rejected: it does not follow the field's specifications stated in the documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9220Invalid length: Batch numberThe value of this field does not follow the specifications stated in the recurrence documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9221Batch not open
9222Batch not found or not closable
9223Batch total not foundThe selected batch does not exist or is empty.The merchant must use another batch number.
9224CAVV Status: P
9225CAVV Status: FTransaction refused.Retry the transaction with a valid CAVV value.
9226CAVV Status: N
9227Pending transactionThe transaction is pending for acknowledgement.Acknowledge the transaction and retry.
9228Protocol: maximum number of send attempts reached
9229Batch error
9231Void impossible
9235Recurring options errorisCredential, isInstallment & isCredentialOnFile are mutually exclusive options.Submit one of the three options.
9300Null value: AmountThe parameter is null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9301The CVV value does not correspond to the card type.The received parameter was rejected: it does not follow the field's specifications stated in the documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9302Null value: IOP Transaction numberThe parameter is null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9303Rejected value: IOP Transaction numberThe received parameter was rejected: it does not follow the field's specifications stated in the documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9304Rejected value: Expiration dateThe received parameter was rejected: it does not follow the field's specifications stated in the documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9305Null value: CVV/CVC2The parameter is null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9306Rejected value: CVV/CVC2The received parameter was rejected: it does not follow the field's specifications stated in the documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9307Null value: Type CVV/CVC2The parameter is null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9308Rejected value: CVV/CVC2 TypeThe received parameter was rejected: it does not follow the field's specifications stated in the documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9309Null value: Transaction dateThe parameter is null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9310Null value: Financial informationThe parameter is null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9311Null value: Card holderThe parameter is null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9312Null value: Card holder first nameThe parameter is null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9313Null value: Card holder last nameThe parameter is null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9314Null value: Card holder addressThe parameter is null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9315Rejected value: Card holder nameThe received parameter was rejected: it does not follow the field's specifications stated in the documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9316Rejected value: merchant owning institutionThe received parameter was rejected: it does not follow the field's specifications stated in the documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9317Null value: Merchant statusThe parameter is null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9318Null value: Last modification dateThe parameter is null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9319Null value: Transaction statusThe parameter is null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9320Null value: MerchantThe parameter is null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9321Rejected value: Advanced options typeThe received parameter was rejected: it does not follow the field's specifications stated in the documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9322Rejected value: Advanced optionsThe received parameter was rejected: it does not follow the field's specifications stated in the documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9323Null value: IOP numberThe parameter is null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9324Rejected value: IOP NumberThe received parameter was rejected: it does not follow the field's specifications stated in the documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9325Rejected value: Manageable option typeThe received parameter was rejected: it does not follow the field's specifications stated in the documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9326Rejected value: Simple optionThe received parameter was rejected: it does not follow the field's specifications stated in the documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9327Rejected value: Simple option typeThe received parameter was rejected: it does not follow the field's specifications stated in the documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9328Null value: Simple OptionThe parameter is null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9329Null value: Client terminal numberThe parameter is null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9330Null value: Bank terminal numberThe parameter is null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9331Null value: Serial numberThe parameter is null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9333Rejected value: Bank terminal numberThe received parameter was rejected: it does not follow the field's specifications stated in the documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9334Rejected value: Bank terminal number (format)The value must be alphanumeric.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9335Rejected value: Client terminal numberThe received parameter was rejected: it does not follow the field's specifications stated in the documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9336Rejected value: Serial numberThe received parameter was rejected: it does not follow the field's specifications stated in the documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9339Null value: TerminalThe parameter is null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9340Null value: SystemThe parameter is null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9341Null value: Keep aliveThe parameter is null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9342Rejected value: Keep aliveThe received parameter was rejected: it does not follow the field's specifications stated in the documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9343Rejected value in that context: Keep aliveThe received parameter was rejected: it does not follow the field's specifications stated in the documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9344Null value: ConfigurationThe parameter is null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9345Null value: OwnerThe parameter is null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9346Null value: Owner idThe parameter is null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9347Null value: Owner nameThe parameter is null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9348Null value: Processing transaction informationThe parameter is null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9349Null value: Processing transaction information typeThe parameter is null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9350Null value: Processing transaction token informationThe parameter is null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9351Rejected value: Processing transaction informationThe received parameter was rejected: it does not follow the field's specifications stated in the documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9352Null value: ProvinceThe parameter is null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9353Rejected value: ProvinceThe received parameter was rejected: it does not follow the field's specifications stated in the documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9354Null value: Transaction categoryThe parameter is null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9355Null value: Creation dateThe parameter is null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9356Null value: Transaction IdThe parameter is null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9357Null value: Transaction statusThe parameter is null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9358Null value: Transaction numberThe parameter is null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9359Invalid transactionThe received parameter was rejected: it does not follow the field's specifications stated in the documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9360Null value: Transaction dataThe parameter is null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9361Null value: One of the transaction dataThe parameter is null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9362Null value: Terminal database identifierThe parameter is null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9363Rejected value: Settlement dateThe received parameter was rejected: it does not follow the field's specifications stated in the documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9364Null value: Last modify dateThe parameter is null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9365Null value: Settlement statusThe parameter is null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9366Null value: Settlement configurationThe parameter is null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9367Null value: Identifier (id)The parameter is null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9368Rejected value: OwnerThe received parameter was rejected: it does not follow the field's specifications stated in the documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9369Null value: Connect TimestampThe parameter is null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9370Null value: Use TimestampThe parameter is null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9371Null value: Terminal IdThe parameter is null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9372Rejected value: Terminal IdThe received parameter was rejected: it does not follow the field's specifications stated in the documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9373Null value: TerminalThe parameter is null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9374Rejected value: Bill typeThe received parameter was rejected: it does not follow the field's specifications stated in the documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9375Rejected value: Bill PrefixThe received parameter was rejected: it does not follow the field's specifications stated in the documentation.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9376Null value: Now dateThe parameter is null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9377Null value: Recur MerchantThe parameter is null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9378Rejected value: Reference NumberThe parameter is null or blank.The field must match the specifications stated in the documentation. If it does, contact PayFacto's Customer Service.
9500Number of attempts to submit request exceededNumber of attempts exceeded.Retry the transaction. If the problem persists, contact PayFacto's Customer Service.
9501Transaction refused by the acquirerThe transaction is refused. Several reasons are possible.Retry the transaction. If the problem persists, contact PayFacto's Customer Service.
9502The amount exceeds the maximum amount of the acquirer.The transaction is refused.Retry the transaction. If the problem persists, contact PayFacto's Customer Service.
9503The processor for the acquirer's transactions is not found.The transaction is refused.Retry the transaction. If the problem persists, contact PayFacto's Customer Service.
9504Rejected value: OwnerThe transaction's holder is not a merchant.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9505The transaction can't be processed because the chosen terminal is already reserved.Retry the transaction with a non-reserved terminal. If the problem persists, contact PayFacto's Customer Service.
9506The chosen terminal does not belong to the merchant.Retry the transaction with a terminal owned by the merchant. If the problem persists, contact PayFacto's Customer Service.
9507Merchant found.Retry with a valid merchant. If the problem persists, contact PayFacto's Customer Service.
9508Merchant not found.Retry with a valid merchant. If the problem persists, contact PayFacto's Customer Service.
9509Null value: Converted merchantThe parameter is null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9510Merchant internal id not found.Retry with a valid merchant. If the problem persists, contact PayFacto's Customer Service.
9511Multiple merchant found.Retry with a valid merchant. If the problem persists, contact PayFacto's Customer Service.
9512Terminal not found.Retry with a valid terminal. If the problem persists, contact PayFacto's Customer Service.
9513Null value: Terminal number sequenceThe parameter is null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9514Terminal found.Retry with a valid terminal. If the problem persists, contact PayFacto's Customer Service.
9515Null value: Converted terminalThe parameter is null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9516Transaction settings insertion failed.Contact PayFacto's Customer Service.
9517Transaction settings deletion failed.Contact PayFacto's Customer Service.
9518Null value: Converted settlement configurationThe parameter is null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9519Settlement update failed.Contact PayFacto's Customer Service.
9520Settlement configuration not found.Contact PayFacto's Customer Service.
9521Multiple settlement configuration found.Contact PayFacto's Customer Service.
9522Client not found.Retry with a valid client. If the problem persists, contact PayFacto's Customer Service.
9523Terminal status not found.Retry with a valid terminal status. If the problem persists, contact PayFacto's Customer Service.
9524Terminal found.Retry with a valid terminal. If the problem persists, contact PayFacto's Customer Service.
9525Null value: Converted terminalThe parameter is null or blank.Check your application. The field must match the specifications stated in the documentation. If it does not, contact PayFacto's Customer Service.
9800SQL fatal errorThe payment server was unable to send a request to the database.Retry the transaction. If the problem persists, contact PayFacto's Customer Service.
9801Cannot decrypt message contentsThe payment server was unable to decrypt the merchant API's message.Retry the transaction. If the problem persists, contact PayFacto's Customer Service.
9802Merchant API version errorThe merchant API's version is not compatible with the payment server.Retry the transaction. If the problem persists, contact PayFacto's Customer Service.
9803Data Validation ErrorThe payment information returned by the acquirer does not match PayFacto data.Retry the transaction. If the problem persists, contact PayFacto's Customer Service.
9804reCAPTCHA verification failedThis is most likely a fraudulent transaction being attempted by a bot.Decline the transaction.
9991Fatal error for a purchase for TPVV
9992Fatal error for a refund for TPVV
9993Fatal error for a cancellation for TPVV
9994Fatal error for a batch process for a TPVV
9995Fatal error for other transaction for TPVV
9996Fatal error for other transaction for TOTAL
9999Fatal error
πŸ†•

  A-Prefix Return Codes

The following table lists all return codes that begin with the letter A. These codes relate to API-level communication issues.

CodeDescriptionDetailsMerchant's Action Plan
A0Payment server did not return a transaction response (API)Possible network problem.Retry the transaction. If the problem persists, contact PayFacto's customer service.
A1Communication problem with payment server (API)A problem occurred while sending the message. Either there is a network problem or the payment server is down.Retry the transaction. If the problem persists, contact PayFacto's customer service.
A2Problem sending the transaction to payment server (API)Possible network problem.Retry the transaction. If the problem persists, contact PayFacto's customer service.
A3Problem writing transaction list (API)Internal banking module problem.If the problem persists, contact PayFacto's customer service.
A4Response problem (API)There is a problem with the payment server's response. It may be caused by a TCP network problem.Retry the transaction. If the problem persists, contact PayFacto's customer service.
πŸ†•

  B-Prefix Return Codes

The following table lists all return codes that begin with the letter B. These codes relate to banking module and terminal configuration issues.

CodeDescriptionDetailsMerchant's Action Plan
B1Bank manager errorAn error was detected in the banking module. One or more fields were not received.If the problem persists, contact PayFacto's customer service.
B2Invalid sequence numberThis return code is similar to code 84 but is for administrative transactions.You should not receive this return code. It is reserved for an internal PayFacto solution application.
B3Transaction code not supported by terminalThe transaction is unsupported by the acquirer's configuration for this terminal.If this transaction must be supported, contact PayFacto's customer service.
B4Card not supported by terminalThis card number is not supported by the acquirer.If this card type must be supported, contact PayFacto's customer service.
B5Invalid acquirer's response formatThe server cannot recognize the format of the acquirer's response.Retry the transaction. If the problem persists, contact PayFacto's customer service.
B6Network switch is incapable of delivering the message
B7Format of the header for the banking response is invalidThe header of the purchaser's received answer is invalid, possibly because of a telecommunication problem. This transaction cannot be reversed. It is possible to have an imbalance during batch closure.Contact PayFacto's customer service to reverse the transaction. Retry the transaction.
BHMaximum number of PIN tries reached
πŸ†•

  H-Prefix Return Codes

The following table lists all return codes that begin with the letter H. These codes relate to telecommunication link and session issues.

CodeDescriptionDetailsMerchant's Action Plan
H0No available sessionInternal banking module problem.If the problem persists, contact PayFacto's customer service.
H1Link out of orderLink 3201 (or another dedicated link) is down.Retry the transaction. If the problem persists, contact PayFacto's customer service.
H2Telecommunication session closing in progressA problem with the link to the acquirer may have occurred while a transaction was waiting to be sent.Retry the transaction. If the problem persists, contact PayFacto's customer service.
H3Application cannot establish telecommunication link because its data structures are fullThere is not enough available memory to establish a connection.Retry the transaction. If the problem persists, contact PayFacto's customer service.
H4Invalid parameterThe received request's format is invalid.Retry the transaction. If the problem persists, contact PayFacto's customer service.
H6The received data is corrupted
πŸ†•

  M-Prefix Return Codes

The following table lists all return codes that begin with the letter M. These codes relate to main module and batch processing issues.

CodeDescriptionDetailsMerchant's Action Plan
M0Batch closing requiredThe transaction log has reached its maximum capacity, or the maximum number of transactions per batch is reached. A batch closing will be initiated automatically upon reception of this code.Wait a few moments and retry the transaction. If the problem persists, contact PayFacto's customer service.
M1Terminal is not initializedThe terminal was not initialized after being installed or has not been redefined in the CT-Payment Solution's banking module. Upon receipt of this return code, the banking module automatically initiates a transaction to load banking parameters in the terminal.Wait a few moments and retry the transaction. If the problem persists, contact PayFacto's customer service.
M2Attempting to cancel an unknown transactionThe transaction to be cancelled is in a batch file which was already closed or the data indicated on the original transaction at the time of cancellation are incorrect. To cancel a transaction, it is necessary that it be in an active batch file.You should not receive this return code. It is reserved for an internal PayFacto Solution application.
M3Treatment of the SAF
M4Invalid transactionThe transaction data is invalid.Retry the transaction. If the problem persists, contact PayFacto's customer service.
M5Invalid transaction amountThe transaction amount is invalid (missing, zero or negative).Retry the transaction with a valid amount.
M6Invalid card numberThe card number is either missing or incorrect.Retry the transaction with a valid credit card matching the selected input type.
M7Invalid card expiration dateThe client's card has expired.Retry the transaction with an unexpired card.
M8Error processing acquirer's responseThe main module has timed out. The banking module has received a response, but the main module has not received the transaction's response.Retry the transaction. If the problem persists, contact PayFacto's customer service.
M9Partial success of a multi-purchaser transaction
MAAdministrative transaction failureThe transaction failed for all acquirers.You should not be receiving this return code. It is reserved for an internal PayFacto Solution application.
MBRequest to close a batch file which is already closed
MCPriority reversal pending in the SAF (Store and Forward) fileThere is a reversal pending in the banking module. No other transaction can be performed until the reversal is completed.Wait a few moments and retry. If the problem persists, contact PayFacto's customer service.
MDConfirmation message of the purchaser on standby in SAF
MEMain module detected invalid responseThe response was not adequately processed because one or more transactional fields are missing in the response.Retry the transaction. If the problem persists, contact PayFacto's customer service.
MFRectification forced by HPOS
MHCancelled transactionThe transaction that you tried to cancel was already cancelled successfully.You should not receive this return code. It is reserved for an internal PayFacto solution application.
MIThe terminal indicates that the batch is off balance (between the terminal and the acquirer)The batch will be closed and the reconciliation files created (if configured).
MJThe terminal indicates that the batch is empty (closed manually or automatically at the terminal)The batch will be closed and the reconciliation files created (if configured).
πŸ†•

  P-Prefix Return Codes

The following table lists all return codes that begin with the letter P. These codes relate to PIN pad and terminal communication.

CodeDescriptionDetailsMerchant's Action Plan
P2PIN pad module errorAn internal error was detected by the PIN pad.Retry the transaction. If the problem persists, contact PayFacto's customer service.
P3PIN pad communication errorCommunication error between the payment server and the PIN pad driver, or between the PIN pad driver and the PIN pad.Make sure that the PIN pad is properly connected and that the PIN pad driver is operational. In the PIN pad configuration module, make sure that the IP address and the port are accurate. Retry the transaction. If the problem persists, contact PayFacto's customer service.
P4Transaction authentication errorThe PIN pad has detected a security problem with the acquirer's response.Retry the transaction a few times. If the problem persists, contact PayFacto's customer service.
P5PIN pad timed outThe client did not confirm the transaction on the PIN pad within the allotted time.Retry the transaction if the client requests it.
P6Transaction cancelled by client on PIN padThe client pressed the PIN pad's ANNUL/CANCEL button.Retry the transaction if the client requests it.
P7Magnetic card reading errorThe card is illegible (demagnetized) or was not properly swiped in the terminal.Retry the transaction. If the problem persists, retry the transaction with a different card.
P8Error on number of tracks
P9Terminal busyThe terminal indicates that it is busy.Retry the transaction. If the problem still persists, unplug and replug the power from the terminal. If the problem still persists, contact PayFacto's customer service.
PDUnexpected Terminal Behavior
PENAK received from terminalThe terminal indicates it can't process the transaction.Retry the transaction. If the problem still persists, unplug and replug the power from the terminal. If the problem still persists, contact PayFacto's customer service.
PFDriver resetThe user has selected β€œFree terminal” while a transaction is in progress on the terminal.The merchant must keep a copy of the terminal receipt. Do not resend the transaction if the receipt indicates that the transaction was approved.
PNBank module internal errorUnexpected error with the main payment application.If the problem persists, contact PayFacto's customer service.
PPTransaction reversedReceipt shows approved transaction but the application didn't return an authorization code and has reversed the transaction.Retry the transaction. If the problem persists, contact PayFacto's customer service.
PQNo recovery data availableRecovery data is unavailable in the terminal recovery file.Check your application. The field must correspond to the specification provided in the documentation. If it does not, contact PayFacto's customer service.
PRCommunication error with terminalCommunication error. The transaction has been sent but no response has been received. A recovery will be done automatically by PayFacto to try to get the response from the terminal.The merchant must keep a copy of the terminal receipt. Do not resend the transaction if the receipt indicates that the transaction was approved. Make sure everything is plugged in correctly.
PSFollowing PR, the recovery can't get the information for the transaction.The transaction can be accepted, refused or cancelled. The communication error can be caused by the power cable, the serial cable or the network cable that was unplugged during the transaction.Nothing to do. If the problem persists, contact PayFacto's customer service.
PTFollowing PR, the recovery can't get the information for the transaction.The transaction can be accepted, refused or cancelled. The communication error can be caused by the power cable or the network cable that was unplugged during the transaction.Nothing to do. If the problem persists, contact PayFacto's customer service.
PUCommunication error with terminalCommunication error between the driver and the terminal.Make sure the serial cable of the terminal is plugged correctly into the computer running the driver.
PVError communicating with terminalFollowing the information of reconnection, the driver never sent the transaction to the terminal.Retry the transaction. If the problem persists, contact PayFacto's customer service.
PWDriver restarted while a transaction is in progressThe driver was restarted while a transaction is in progress on the terminal. The transaction can be accepted, refused or cancelled.The merchant must keep a copy of the terminal receipt. Do not resend the transaction if the receipt indicates that the transaction was approved.
PXCan't write on driver's hard disk.The driver can't write its work file on the disk, either because it does not have write permissions on the directory, or because the chosen directory does not exist.Verify the driver configuration. If no directory is configured, press β€œLog file” to check the location of the log file. The working file is written in the same directory as the log file. Check the write permissions on this directory.
PZTimeoutThe driver did not receive a response from the terminal within the prescribed time.Make sure there is no current transaction on the terminal. Retry the transaction. If a transaction is in progress on the terminal, press the ANNUL/CANCEL button on the terminal before resubmitting.
⏱

  P1xx / P2xx / P3xx β€” Abandonment Tracking

These codes track exactly where in the terminal flow a transaction was cancelled or timed out by the customer. All codes in this range share the same details and action: Details β€” "Abandonment tracking return code. This return code gives the screen or menu where the transaction was cancelled or timed out." Action β€” "Please retry the transaction if the client requests it."

ℹ️

These codes are informational only and do not represent system errors. They exist purely to help support teams diagnose exactly where in the terminal UI flow a customer abandoned a transaction.

CodeDescription
P108CONTACTLESS DECLINED CARD ERROR
P120HOST INVALID DATA
P121SENDING TRX WHEN TERMINAL WAITING FOR REVERSAL IF REVERSAL FAILS TRX CANCELLED
P122OPERATION NOT SUPPORTED
P200SALE ADD TIP CANCEL
P201SALE ADD TIP PERCENTAGE PRESET 1 CANCEL
P202SALE ADD TIP PERCENTAGE PRESET 2 CANCEL
P203SALE ADD TIP PERCENTAGE PRESET 3 CANCEL
P204SALE ADD TIP PERCENTAGE OTHER CANCEL
P205SALE ADD TIP AMOUNT CANCEL
P206SALE SWIPE INSERT TAP KEY CANCEL
P207SALE CASHBACK CANCEL
P208SALE CASHBACK UP CASHBACK PRESET 1 CANCEL
P209SALE CASHBACK UP CASHBACK PRESET 2 CANCEL
P210SALE CASHBACK UP CASHBACK PRESET 3 CANCEL
P211SALE CASHBACK UP CASHBACK AMOUNT CANCEL
P212SALE SELECT ACCOUNT CANCEL
P213SALE SELECT ACCOUNT CARD REMOVED
P214SALE SELECT ACCOUNT CHEQUING ENTER PIN CANCEL
P215SALE SELECT ACCOUNT SAVING ENTER PIN CANCEL
P216PRE AUTH SWIPE INSERT TAP KEY CANCEL
P217PRE AUTH NO SUPPORTED APPLICATIONS CANCEL
P218PRE AUTH NO SUPPORTED APPLICATIONS SWIPE KEY CANCEL
P219PRE AUTH NO SUPPORTED APPLICATIONS INVALID CARD CANCEL
P220REFUND SWIPE INSERT TAP KEY CANCEL
P221REFUND SELECT ACCOUNT CANCEL
P222REFUND SALE SELECT ACCOUNT CARD REMOVED
P223REFUND SELECT ACCOUNT CHEQUING ENTER PIN CANCEL
P224REFUND SELECT ACCOUNT SAVING ENTER PIN CANCEL
P225VOID SWIPE INSERT TAP KEY CANCEL
P226VOID SWIPE INSERT TAP KEY ENTER PIN CANCEL
P227CASH ADD TIP CANCEL
P228CASH ADD TIP PERCENTAGE PRESET 1 CANCEL
P229CASH ADD TIP PERCENTAGE PRESET 2 CANCEL
P230CASH ADD TIP PERCENTAGE PRESET 3 CANCEL
P231CASH ADD TIP PERCENTAGE OTHER CANCEL
P232CASH ADD TIP AMOUNT CANCEL
P233VERIFY ACCOUNT SWIPE INSERT TAP KEY CANCEL
P234SWIPE PROMPT MERCHANT PASSWORD CANCEL
P235SWIPE PROMPT LAST 4 DIGITS CANCEL
P236MANUAL ENTRY PROMPT MERCHANT PASSWORD CANCEL
P237MANUAL ENTRY PROMPT EXPIRY DATE CANCEL
P238MANUAL ENTRY PROMPT CVV CANCEL
P239VERIFY ACCOUNT PIN CANCEL
P240CREDIT PIN CANCEL
P241SALE PIN CARD REMOVED
P242REFUND PIN CARD REMOVED
P243SWIPE INSERT TAP KEY CANCEL
P244MANUAL ENTRY PROMPT CANCEL
P245VOID PIN CARD REMOVED
P246CASHBACK PRESET 1 CARD REMOVED
P247CASHBACK PRESET 2 CARD REMOVED
P248CASHBACK PRESET 3 CARD REMOVED
P249CASHBACK AMOUNT CARD REMOVED
P250CREDIT PIN CARD REMOVED
P251SALE GENERIC CANCEL
P252CASH GENERIC CANCEL
P270AMOUNT CONFIRMATION SCREEN CANCEL
P300SALE ADD TIP TIMEOUT
P301SALE ADD TIP PERCENTAGE PRESET 1 TIMEOUT
P302SALE ADD TIP PERCENTAGE PRESET 2 TIMEOUT
P303SALE ADD TIP PERCENTAGE PRESET 3 TIMEOUT
P304SALE ADD TIP PERCENTAGE OTHER TIMEOUT
P305SALE ADD TIP AMOUNT TIMEOUT
P306SALE SWIPE INSERT TAP KEY TIMEOUT
P307SALE CASHBACK TIMEOUT
P308SALE CASHBACK UP CASHBACK PRESET 1 TIMEOUT
P309SALE CASHBACK UP CASHBACK PRESET 2 TIMEOUT
P310SALE CASHBACK UP CASHBACK PRESET 3 TIMEOUT
P311SALE CASHBACK UP CASHBACK AMOUNT TIMEOUT
P312SALE SELECT ACCOUNT TIMEOUT
P313SALE SELECT ACCOUNT CHEQUING ENTER PIN TIMEOUT
P314SALE SELECT ACCOUNT SAVING ENTER PIN TIMEOUT
P315PRE AUTH SWIPE INSERT TAP KEY TIMEOUT
P316PRE AUTH NO SUPPORTED APPLICATIONS TIMEOUT
P317PRE AUTH NO SUPPORTED APPLICATIONS SWIPE KEY TIMEOUT
P318PRE AUTH NO SUPPORTED APPLICATIONS INVALID CARD TIMEOUT
P319REFUND SWIPE INSERT TAP KEY TIMEOUT
P320REFUND SELECT ACCOUNT TIMEOUT
P321REFUND SELECT ACCOUNT CHEQUING ENTER PIN TIMEOUT
P322REFUND SELECT ACCOUNT SAVING ENTER PIN TIMEOUT
P323VOID SWIPE INSERT TAP KEY TIMEOUT
P324VOID SWIPE INSERT TAP KEY ENTER PIN TIMEOUT
P325CASH ADD TIP TIMEOUT
P326CASH ADD TIP PERCENTAGE PRESET 1 TIMEOUT
P327CASH ADD TIP PERCENTAGE PRESET 2 TIMEOUT
P328CASH ADD TIP PERCENTAGE PRESET 3 TIMEOUT
P329CASH ADD TIP PERCENTAGE OTHER TIMEOUT
P330CASH ADD TIP AMOUNT TIMEOUT
P331VERIFY ACCOUNT SWIPE INSERT TAP KEY TIMEOUT
P332SWIPE PROMPT MERCHANT PASSWORD TIMEOUT
P333SWIPE PROMPT LAST 4 DIGITS TIMEOUT
P334MANUAL ENTRY PROMPT MERCHANT PASSWORD TIMEOUT
P335MANUAL ENTRY PROMPT EXPIRY DATE TIMEOUT
P336MANUAL ENTRY PROMPT CVV TIMEOUT
P337VERIFY ACCOUNT PIN TIMEOUT
P338CREDIT PIN TIMEOUT
P339SWIPE INSERT TAP KEY TIMEOUT
P340MANUAL ENTRY PROMPT TIMEOUT
P341SALE GENERIC TIMEOUT
P342CASH GENERIC TIMEOUT
P344SALE ADD TIP PERCENTAGE SELECT PRESET TIMEOUT
πŸ†•

  Q-Prefix Return Codes

The following table lists all return codes that begin with the letter Q.

CodeDescriptionDetailsMerchant's Action Plan
Q0Invalid transaction dateThe transaction date sent by the banking module as part of the transaction request does not follow the acquirer's criteria.Retry the transaction. If the problem persists, contact PayFacto's customer service.
Q7Merchant's amount limit reachedThe transaction's amount is greater than the acquirer's limit.Split the transaction into smaller portions.
Q9Unknown errorAn error different from those mentioned has occurred.Retry the transaction. If the problem persists, contact the acquirer.
πŸ†•

  T-Prefix Return Codes

The following table lists all return codes that begin with the letter T. These codes relate to the HPOS module.

CodeDescriptionDetailsMerchant's Action Plan
T0Transaction already in progress for requested terminalThe terminal is busy. A transaction is in progress.Wait a few moments and retry. If the problem persists, contact PayFacto's customer service.
T1HPOS internal errorGeneral error in the HPOS module.If the problem persists, contact PayFacto's customer service.
T2Payment application received a format errorThe format of the message sent to the payment server was incorrect. It may be due to the format of the payment server's date.Retry the transaction. If the problem persists, contact PayFacto's customer service.
T3Terminal number not found on payment server to which transaction was sentThe POS terminal number sent to the payment server is not set up on the server.Retry the transaction. If the problem persists, contact PayFacto's customer service.
T4Wrong API version
πŸ†•

  Z-Prefix Return Codes

The following table lists all return codes that begin with the letter Z. These codes relate to telecommunication and network link issues with the acquirer.

CodeDescriptionDetailsMerchant's Action Plan
Z0Prolongation – time passed for the TPV
Z1Acquirer's response timed outThis code is usually due to a communication problem or to the acquirer's response timing out.Retry the transaction. If the problem persists, contact PayFacto's customer service.
Z2Acquirer unavailable. Connection between payment solution and/or acquirer's two host sites is severedThe TCP/IP reports that the opening of a socket with the acquirer's primary and secondary host systems has failed.Retry the transaction. If the problem persists, contact PayFacto's customer service.
Z3Server problems
Z4Transaction's PIN pad interaction timed outPIN pad interaction timed out. The client has not entered the necessary information within the allotted time.Retry the transaction. If the problem persists, contact PayFacto's customer service.
Z5No dial tone
Z6Invalid phone number
Z7Failed modem connection
Z8Occupied line
Z9Redialling on the line
ZAConnection between payment solution and acquirer is severedLink problem.Retry the transaction. If the problem persists, contact PayFacto's customer service.
ZBProtocol: maximum number of send attempts reachedThe acquirer's host system has answered, but there are problems sending the transaction.Retry the transaction. If the problem persists, contact PayFacto's customer service.
ZCProtocol: timed outThe acquirer's host system has answered, but there are timeout problems when communicating.Retry the transaction. If the problem persists, contact PayFacto's customer service.
ZDConnection 3201 between payment server and acquirer was severed while sending a transaction (poll code down or link down)The payment solution cannot see the poll code, or link 3201 is severed.Retry the transaction. If the problem persists, contact PayFacto's customer service.
ZECommunication driver internal errorGeneral communication error. The payment server's 3201 driver may not be operational.Retry the transaction. If the problem persists, contact PayFacto's customer service.
ZFConnection disabled
ZGNo response for code DATAPAC
ZHNo response for the PROF command
ZIAcquirer's primary host site unavailable. Connections between payment solution and acquirer are severedThe TCP/IP driver reports that the opening of a socket with the acquirer's primary host system has failed.Retry the transaction. If the problem persists, contact PayFacto's customer service.
ZJAcquirer's secondary host site unavailable. Connections between payment solution and secondary acquirer are severedThe TCP/IP driver reports that the opening of a socket with the acquirer's secondary host system has failed.Retry the transaction. If the problem persists, contact PayFacto's customer service.