CodePay Response Codes
Here are some common CodePay response codes and their descriptions:
| Code | Message | Description |
|---|---|---|
| ET001 | Data decryption exception | The gateway could not decrypt the request payload (card/PIN block or other encrypted field). This usually means the terminal's encryption keys are out of sync or expired. Re-run the sign-in/key-exchange step to obtain fresh data/MAC keys, then retry the transaction. |
| ET002 | The reversal transaction does not exist | The transaction number or merchant order number is incorrect |
| ET003 | The transaction does not exist | The transaction number or merchant order number is incorrect |
| ET004 | Confirmation time exceeded | The transaction confirmation step (e.g. signature capture) was submitted after the processor's confirmation window closed. The original authorization should be treated as void; start a new transaction rather than retrying the confirmation. |
| ET006 | GAC verification failed | The issuer indicates that the transaction should not proceed. Insufficient funds, expired card, suspected fraud, etc. This is a terminal decline — do not retry the same card; ask the cardholder to use a different card or contact their bank. |
| ET007 | No pending transactions | The requested action (tip adjustment, void, or completion) targets a transaction that has no open/pending state on the processor — it may already be finalized, expired, or was never created. Confirm the transaction status with Query order before retrying. |
| ET008 | Reversal not allowed, the transaction was settled | The transaction has already been included in a settlement batch, so it can no longer be voided/reversed. Use the Refund API instead. |
| ET009 | Tip adjustment not allowed, the transaction was settled | The transaction has already been included in a settlement batch, so its tip can no longer be adjusted. Tip adjustments must happen before batch close. |
| CT001 | Debit cards do not support manual transactions | The card was manually keyed in (not swiped/dipped/tapped) and was identified as a debit card. Debit network rules do not allow keyed-in entry; ask the cardholder to swipe, dip, or tap instead. |
| CF004 | Debit PINLess transaction do not support cashback | A debit PINless (signature-based, no PIN entry) transaction was submitted with a cashback amount. Cashback requires PIN debit; remove the cashback amount or have the cardholder enter their PIN. |
| CF008 | Authorized completed transactions do not support void, please use the refund function | Fiserv does not support void authorized completed transaction |
| CF009 | The transaction does not support tip adjustment | The tip adjustment feature was not enabled before the transaction was processed |
| E07301 | The RSA public key is not set for the app | CodePay Gateway has not received/stored an RSA public key for this app_id, so the key-exchange step during sign-in fails. Upload the app's public key via PayPilot/Copilot before making API calls. |
| E07302 | App status not available | The Payment App ID exists but is not currently in an active/usable state (e.g. pending review, suspended). Check the app status in PayPilot/Copilot or contact the CodePay admin. |
| E07303 | The API is not authorized or does not exist | The requested API method is not enabled for this app/merchant, or the method name is incorrect. Verify the method name and that the API has been granted to your Payment App ID. |
| E02406 | Application configuration parameters are missing. Contact the administrator | The CodePay register app settings have not been configured on Copilot yet |
| E07402 | Merchant status is abnormal | The merchant account is not in a normal operating state (e.g. under review, disabled, or suspended). Contact the CodePay admin to check the merchant's status. |
| E07102 | The merchant did not open the application | The CodePay register app settings have not been configured on Copilot yet |
| E07103 | Store does not exist | The store_id/store identifier supplied in the request does not match any store configured for this merchant. Verify the store was created and the ID is correct. |
| E07104 | Payment app does not exist | The payment app registered in CodePay Gateway, Please refer to the Payment gateway integration guide |
| E07105 | The app has been disabled | The payment app id registered in CodePay Gateway, Please refer to the Payment gateway integration guide |
| E07106 | The terminal device does not exist | The terminal is not bound/registered on CodePay Gateway (binding may have been removed or never completed). Re-bind the device: on the terminal, sign out and sign back in to re-register the terminal_sn with the merchant/app_id. |
| E07114 | This payment method has not been activated | The payment method used in the request (e.g. a specific card brand or wallet) has not been enabled for this merchant/store. Enable the payment method in PayPilot/Copilot, or use a supported method. |
| E07115 | Merchant order number and transaction number cannot be empty at the same time | The request must include at least one of merchant_order_no or transaction_no so CodePay Gateway can identify the transaction; both fields were empty. |
| E07504 | [merchant_no] does not match [terminal_sn] | |
| E04103 | Merchant does not exist | The merchant_no supplied does not match any merchant configured on CodePay Gateway. Verify the merchant number. |
| E04105 | Store or Terminal does not exist | The store or terminal identifier supplied does not match any record for this merchant. Verify the store/terminal was created and IDs are correct. |
| E04106 | Merchant has not opened the payment application | The merchant has not enabled/activated the payment application used in this request. Enable the application for the merchant in PayPilot/Copilot before processing transactions. |
| E04107 | Merchant does not sign the acquiring contract | |
| E04108 | No acquiring product found in current payment method and payment scenario | The combination of payment method (e.g. card brand) and payment scenario (e.g. card-present vs. e-commerce) requested has no matching acquiring product configured for this merchant. Confirm the merchant's acquiring contract covers this combination. |
| E04110 | Transaction number is invalid | The transaction_no supplied does not match the expected format or does not correspond to any known transaction. Verify the value returned from the original Create Order call. |
| E04111 | Merchant order number is invalid | The merchant_order_no supplied does not match the expected format (e.g. length, allowed characters). Check the value against the API parameter rules. |
| E04112 | Merchant order number repeat | A transaction with this merchant_order_no already exists. Order numbers must be unique per merchant; generate a new one for each new transaction attempt. |
| E04114 | The payment channel is not available | The acquiring/processing channel configured for this transaction is temporarily unavailable. Retry after a short delay; if it persists, contact CodePay support. |
| E04115 | The merchant is frozen | The merchant account has been frozen (e.g. for risk or compliance reasons) and cannot process transactions. Contact the CodePay admin to resolve the merchant's status. |
| E04117 | The payment channel does not support the current transaction | The selected payment channel does not support this transaction type (e.g. refund, pre-auth) for this merchant. Confirm which transaction types are supported by the merchant's acquiring contract. |
| E04118 | The store does not support the payment scenario transaction | The store is not configured to accept transactions in the requested payment scenario (e.g. card-present vs. online). Update the store's configuration or use a supported scenario. |
| E04126 | Refund amount exceeds the limit | The requested refund amount is greater than what is allowed (e.g. exceeds the original transaction amount or a configured refund cap). Reduce the refund amount or check the merchant's refund limit configuration. |
| E04128 | Not supported Pre authorization completion | Pre-authorization completion is not enabled/supported for this merchant, payment method, or transaction type. Confirm pre-auth completion is part of the merchant's acquiring contract. |
| E04129 | Pre-authorization completion amount exceeds the limit | The completion amount requested is greater than what is allowed relative to the original pre-authorization (commonly capped at the original amount plus an allowed tolerance). Reduce the completion amount. |
| E04130 | No more than $X.XX amount refunds per transaction | The refund amount requested exceeds the maximum allowed per transaction for this merchant. Check the merchant's configured refund cap. |
| E04131 | Transaction number cannot be duplicate | A transaction with this transaction_no has already been processed. Do not resubmit the same transaction number; if unsure of the original result, use Query order instead of retrying. |
| E04132 | Partial refund is not allowed for this transaction | This transaction (or the merchant's configuration) only supports a full refund of the original amount, not a partial amount. Submit a refund for the full transaction amount. |
| E04153 | Transaction failed, MID/TID does not match the merchant acquiring contract configuration | |
| E04154 | Non-credit card payment, no surcharge allowed | A surcharge was included on a non-credit-card payment method (e.g. debit or PINless debit). Surcharging is only permitted on credit card transactions; remove the surcharge for other payment methods. |
| E04155 | The transaction does not support incremental authorization | Incremental authorization was requested on a transaction type or payment method that does not support it. Confirm incremental authorization is supported for this scenario before requesting it. |