When performing a void on a transaction, the Payment Gateway API returns a code (ProviderReturnCode) and a message (ProviderReturnMessage) indicating the result of the operation. In most cases, these values are also the same as those returned in ReturnCode and ReturnMessage.
The values listed below correspond to the return codes when Cielo is the provider/acquirer of the transaction.
Refer to the full list of possible values, their descriptions, and the recommended actions below.
| RETURN CODE | DESCRIPTION | RECOMMENDED ACTION |
|---|---|---|
| 0 | Void approved successfully. | No action required. |
| 3 | Transaction not found. | Validate the provided transaction data and try again. |
| 5 | Posting error. | Check the transaction status before submitting a new request. |
| 9 | Full void request approved successfully. | No action required. |
| 10 | Void not processed. A pending request with the same information already exists. | Wait for the pending request to be processed. |
| 17 | A full or partial void/dispute already exists for this sale. | Review the transaction history. |
| 40 | Void period expired. | A transaction cannot be voided after the allowed period. |
| 41 | Current status does not allow a void. | Check the transaction status. |
| 42 | A void/dispute already exists for this sale. | Review the transaction history. |
| 43 | Insufficient balance in the schedule. | Check the balance in the schedule. |
| 51 | Void amount exceeds the original sale amount. | Verify the submitted amount. |
| 52 | Original sale not found. | Validate the transaction data. |
| 53 | The product does not support voids. | Review the product rules. |
| 54 | Void not processed. | Contact support. |
| 55 | Insufficient sale balance. | Check the remaining balance of the sale. |
| 56 | Insufficient merchant balance. | Check the financial schedule and available balance. |
| 57 | Processing failure. | Try again after a few minutes. |
| 58 | Card differs from the one used in the sale. Also verify the card brand and CardType. | Verify the card number, card brand, and CardType. |
| 60 | CardType differs from the one used in the sale. | Verify the CardType. |
| 72 | Insufficient balance in the schedule to void the sale. | Contact support. |
| 76 | The merchant does not have sufficient balance for the void. | Check the merchant's financial schedule. |
| 77 | Original sale not found for void processing. | Verify the original sale data. |
| 97 | System unavailable. | Wait for service restoration and try again. |
| 98 | Timeout. | Try again. |
| 99 | Processing failure. | Try again. |
| 100 | Original sale not found for void processing. This occurs when a partial void is requested before the transaction is settled. | Wait until the sale is settled and try again. |
| 101 | Void not completed because the card brand's allowed period has expired. | A transaction cannot be voided after the card brand's deadline. |
| 102 | Requested void amount exceeds the original transaction amount. | Verify the original transaction amount. |
| 103 | Registration restriction. Void not allowed. | Contact support. |
| 104 | Registration restriction. Void not allowed. | Contact support. |
| 105 | Registration restriction. Void not allowed. | Contact support. |
| 106 | Registration restriction. Void not allowed. | Contact support. |
| 107 | Registration restriction. Void not allowed. | Contact support. |
| 108 | Merchant number not found. | Verify the submitted merchant number. |
| 116 | Void request not found. | Review the void request history. |
| 117 | Error calling the Clearing service. | Try again after a few minutes. |
| 120 | The sale product does not support voids. | Review the product rules. |
| 121 | Posting error. MCCs 3000 or 30001 do not allow voids for open installment transactions. | Contact support. |
| 130 | The card brand does not allow the void. A void or chargeback has already been completed for this transaction. | Review the transaction history. |
| 160 | CardType differs from the one used in the sale. | Correct the submitted CardType and try again. |
| 206 | Void not processed. No sale was found with the submitted amount. | Verify the transaction data. |
| 209 | Void not processed. No sale was found with the submitted product. | Verify the transaction data. |
| 215 | Void not processed. No sale was found with the submitted card brand. | Verify the transaction data. |
| 217 | Void not processed. More than one sale was found with the submitted data. | Verify the transaction data. |
| 221 | Void not processed. No sale was found with the submitted void amount. | Verify the transaction data. |
| 223 | Void not processed. A pending request with the same information already exists. | Wait for the existing request to be completed. |
| 340 | The transaction is temporarily blocked for new void requests. It will be available again after midnight. | Try again the next day. |
| 475 | The transaction void was not completed successfully. | Check the sale status and try again. |
| 476 | Void not completed. A void for this sale is currently being processed. | Wait for processing to be completed. |
| 477 | Void not completed. | Check the status and try again. |
| 504 | Request timeout. | Try again. |
| 576 | Primary pre-authorization not found. | Verify the transaction data. |
| 9016 | Reversed. | Review the transaction history. |
| BP900 | Operation failed. We recommend checking the transaction status before submitting a new request. | Check the transaction status and try again after 5 minutes. |
| BP903 | Void failed. | Try again. |
| AA | Timeout during void processing. | Try again. |
To track the result of refund requests in the transaction query, see Refund status list.