📋 General Information
- Scope: PrestaShop Payments, refunds from the PrestaShop Payments account balance.
- Roles: L1, L2.
- Sensitive actions? Yes
- Intervention limit: Escalate to N2 (squad) if the balance is sufficient and the refund still fails.
- Procedure owner: .L2
- Problem and resolution summary: A refund is deducted from the PrestaShop Payments account balance. The fee charged on the original order is retained and is not refunded. There is no fee on the refund itself. There is no automatic backup funding source (bank account), and a negative balance is not enabled by default: if the balance does not cover the amount, the refund fails.
🛠️ Processing Procedure
-
Diagnose the problem:
- The refund fails even though the order has been paid.
- Compare the available PrestaShop Payments account balance (the module overview or PayPal portal) with the amount to be refunded.
- Common case: a recent store, the balance has already been paid out to the bank account, or previous refunds (fees from the original orders are not returned).
- Confirm the diagnosis: Agent: confirm that the balance is less than the amount to be refunded.
- Fund the balance: Merchant: add funds to their PrestaShop Payments account (at least the difference), then retry the refund.
- Prevent recurrence: Merchant: maintain a minimum balance using the automatic payout settings for the PrestaShop Payments account.
- Escalate if needed: If the balance is sufficient and the refund still fails: escalate to N2 (squad).
Response to the merchant
Refunds are deducted from your PrestaShop Payments account balance. The current balance does not cover the amount to be refunded, which is why the operation failed. Add at least the difference to your PrestaShop Payments account, then retry the refund. Going forward, we recommend keeping a minimum balance, which can be configured in the automatic payout settings for your PrestaShop Payments account. The fee charged on the original order is retained and is not refunded. No fee is applied to the refund.
⚠️ Never promise that the fee from the original order will be returned: it is retained. There is also no fee on the refund.
❓ To confirm: exact path for adding funds (from the bank / from the main PayPal account); error message displayed by the module (improvement planned).