Skip to main content

Documentation

Refund Errors

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.