Refund Errors
The following error codes and messages appear in REST responses when an error prevents completion of the request.
Error Code | Description |
|---|---|
ERROR_ADDING_REFUND | The request tried to create a refund, but the payment was not found. The request was rejected. Corrective action: Use the ID of a valid payment that is in 'closed' status. |
ERROR_CREATE_PARTIAL_REFUND_NOT_READY | The request tried to create a partial refund of a card payment, but this service is temporarily unavailable. The request was rejected. Corrective action: Try again after 24 hours. If the issue persists, contact Rapyd Client Support. |
ERROR_CREATE_REFUND | The request tried to create a refund against a payment, but the operation failed. Corrective action: Verify that the payment exists and is not closed, and check all input parameters. |
ERROR_CREATE_REFUND_CURRENCY_NOT_VALID | The request tried to create a refund, but the currency was not recognized. The request was rejected. Corrective action: Set 'currency' to the value of 'merchant_requested_currency' or 'currency_code' from the response to 'Create Payment'. |
ERROR_CREATE_REFUND_DUPLICATE_EWALLET | The request tried to refund a split payment, but the same wallet was specified more than once. The request was rejected. Corrective action: In the 'ewallets' array, specify each wallet only one time. |
ERROR_CREATE_REFUND_EWALLET_ALREADY_FULLY_REFUNDED | The request tried to create a refund of a payment, but the payment was already fully refunded. The request was rejected. Corrective action: None. To transfer money to the payer, use 'Create Payout' or 'Transfer Funds Between Wallets'. |
ERROR_CREATE_REFUND_EWALLET_NOT_FOUND_IN_PAYMENT | The request tried to refund a payment, but the wallet was not found in the payment. The request was rejected. Corrective action: In the 'ewallets' array, specify wallets that appear in the payment. |
ERROR_CREATE_REFUND_EWALLETS_INCONSISTENCY | The request tried to refund a split payment, but the refund split was not defined correctly. The request was rejected. Corrective action: In the 'ewallets' array, specify the 'amount' field for all wallets or the 'percent' field for all wallets. |
ERROR_CREATE_REFUND_INVALID_EWALLETS_AMOUNT | The request tried to create a refund, but the amount from one wallet was not valid. The request was rejected. Corrective action: In the 'ewallets' array, set the 'amount' field for all wallets to a positive decimal number. |
ERROR_CREATE_REFUND_INVALID_EWALLETS_PERCENTAGE | The request tried to create a refund, but the percentage from one wallet was not valid. The request was rejected. Corrective action: In the 'ewallets' array, set the 'percentage' field for all wallets to a decimal number between 0 and 100. |
ERROR_CREATE_REFUND_MISSING_EWALLET_ID | The request tried to refund a payment, but the ID of one of the wallets was missing. The request was rejected. Corrective action: In the 'ewallet' field, provide the ID of the wallet that the refund will be taken from. |
ERROR_CREATE_REFUND_PAYMENT_NOT_REFUNDABLE | The request tried to create a refund, but the payment method does not allow this operation. The request was rejected. Corrective action: Send the funds to the payer using ‘Create Payout’ or ‘Transfer Funds Between Wallets’, or contact Client Support. |
ERROR_GET_EWALLET_NOT_ENOUGH_FUNDS | The request tried to create a refund of a payment to one or more wallets, but one of the wallets did not have enough funds to complete the refund. The request was rejected. Corrective action: Fund the wallet with 'Create Payment' or transfer funds from another wallet using 'Transfer Funds Between Wallets'. |
ERROR_PREVIOUS_REFUND_WAS_NOT_PROPORTIONATE | The request tried to create a refund to two or more wallets, but the previous refund was not proportionate and the current request did not specifically state the amount to return to each wallet. The request was rejected. Corrective action: Specify an 'ewallets' array. For each 'ewallet', specify the 'amount' that it will receive from the refund. |
ERROR_REFUND_AMOUNT_EXCEEDS_PAYMENT_AMOUNT | The request tried to create a refund of payment that was collected to one or more wallets, but the amount of all refunds against this payment exceeded the amount of the payment. The request was rejected. Corrective action: None. Determine why an attempt was made to refund more money than was collected originally. |
ERROR_REFUND_REQUEST_FOR_PAYMENT_IN_DISPUTE | A refund request for a payment that is already in dispute was rejected. Corrective action: None. |
ERROR_UPDATE_REFUND | The request tried to update a refund, but the refund was not found, or the operation failed. The request was rejected. Corrective action: Check all input fields, and verify that the refund exists and was not already closed. |
INVALID_REFUND | The request attempted an operation that requires a refund, but the refund was not found. The request was rejected. Corrective action: Use the ID of a valid refund. |
INVALID_REFUND_STATUS | The request tried to complete a refund, but the refund was already completed and closed. The request was rejected. Corrective action: Determine why multiple attempts were made to complete the same refund. |
INVALID_REFUND_TOKEN | The request tried to update a refund, but the refund was not found. The request was rejected. Corrective action: Use the ID of a valid refund. |
PAYMENT_NOT_COMPLETED | The request tried to create a refund, but the payment object on which the refund is based is not in 'closed' status. The request was rejected. Corrective action: Wait until the payment is closed, and then create the refund. |