The "Online auto-refund for cancelled orders" feature helps streamline store operations. Once enabled, if a store or customer cancels an order paid through SHOPLINE Payments, the system will automatically issue an online refund.
This article will cover the following:
1. How to enable the feature
Step 1
In the SHOPLINE Admin, go to [Settings] > [Order Settings]. Switch on the "Online auto-refund for cancelled orders" toggle.
Step 2
Click Update at the bottom of the page to enable the feature.
After the feature is enabled, the system will automatically process refunds when the following actions occur and the order meets the required conditions:
- When the merchant updates a single order status to "Cancelled" in the Admin.
- When the merchant updates multiple order statuses to "Cancelled" in the Admin. For details, please refer to 2. Bulk order refund.
- When the merchant updates an order status to "Cancelled" via the "Update Order Status" or "Cancel Order" API.
- When the customer cancels an order directly on the storefront. For details, please refer to Cancel Order By Customer | Order Management.
*Notes:
- This feature is only available to merchants who have integrated SHOPLINE Payments and whose accounts are active.
- Supported payment methods: Credit Card, Apple Pay, JKOPay, zingala, AFTEE, and designated credit card categories.
- For Hong Kong, in addition to the above, the following are also supported: Alipay (HK), WeChat Pay, Google Pay, and FPS.
- Unsupported payment method: Bank Transfer.
- Unsupported order types: merged orders and child order created after order splitting.
- Employees must have the "Refund" permission to manually process refunds. However, once this feature is enabled, if an employee without this permission changes an order status to "Cancelled", the system will still automatically process the online refund for that order.
2. Bulk order refund
Go to [Order Management] > [Orders] and select multiple orders at once. After selection, click the "Bulk Actions" drop-down menu to choose Update Status > Order Status > Cancelled. After clicking Update, the selected orders will be cancelled and the system will automatically process online refunds.
Go to [Reports & Analytics] > [Bulk Action Progress] to view the results of automatic refunds. If there are failed refunds, you can download the failure report to check the failed order numbers.
*Note: The overview and failure report only include supported payment methods. Orders paid with unsupported methods (e.g., Bank Transfer) will not be included in the overview or the failure report.
For example: In the screenshot above, two orders were selected and set to "Cancelled". One order was paid by credit card and the other by bank transfer. In the "Bulk Online Order Refund" task, only the successful refund (credit card payment) is counted, while the bank transfer order is not included.
3. Refund logic
i. Refund activities logs
If a refund is successfully initiated, the order activities logs will show "Refunding", "Refunded", or "Partially Refunded".
If a refund request fails, the order activities logs will show "Failed to initiate order online refund".
*Note: This log does not necessarily mean the refund itself has failed. An order may show "Updated Order Payment As Refunding" but still encounter an actual refund failure later. In such cases, the refund failure will be displayed in the payment information.
ii. Refund Amount
-
When the system processes an automatic online refund, it will refund the remaining balance of the order in full.
If no refund has been made for the order, the refund amount = the full order amount.
If a partial refund has already been made, the refund amount = order amount – amount already refunded.
The refund amount is not affected by any changes to the order amount made after payment. Even if the merchant edits the order to adjust the order amount after the customer has paid, the refund will still be calculated based on the original order amount at the time of payment.
If a parent order is cancelled after the order has been split, the system will initiate the refund based on the original total amount of the parent order, rather than its remaining balance.
iii. Multi-attribute products order refund logic
When an order contains multi-attribute products, if you request a refund for one of the orders, all orders under the same cart number will show the payment status "Refunding", "Refunded", or "Partially Refunded". However, the actual refund amount will only cover the order you selected.
For example:
- There are three orders: A, B, and C. When Order A is set to Cancelled, the payment status for Orders A, B, and C change to "Refunding", and once the process is completed, they will show "Partially Refunded".
The actual refund amount will only be the order amount of Order A (TWD 3).
For other situations, please refer to the following examples:
| Situation | Orders | Action | Result |
| Multi-attribute products |
Cart contains:
|
Cancel Orders A & B | The system automatically processes online refunds for Orders A & B. Payment status for Orders A, B, and C changes to Refunding / Partially Refunded. Refund amount = TWD 3. |
| Partial Refund |
Cart contains:
|
Cancel Order A | The system automatically processes an online refund for Order A. Payment status for Orders A & B changes to Refunding / Partially Refunded. Refund amount = TWD 1. |
| Over-refund |
Cart contains:
|
Cancel Order B | Since the refunded amount already exceeds the order amount, the system will not process any additional refunds. |
Read more
- Cancel Order By Customer | Order Management
- Multi-Attribute Products Order Checkout
- Refund | SHOPLINE Payments (HK)
- Refunds | SHOPLINE Payments (Singapore)
- 信用卡退刷流程|SHOPLINE Payments (台灣) (Available in Traditional Chinese only)

Comments