Returns Lifecycle
Note: all returns with status that starts with canceled or success cannot be edited as these statuses are immutable.
| Status | Description |
|---|---|
pending.created | A return has just been created. |
pending.confirmed | The return pick up has been confirmed by the warehouse. |
pending.pickup | The warehouse has approved the return operation and will attempt to pick it up multiple times. They may communicate with the customer directly to schedule pick-up. |
canceled.rejected | The warehouse has refused the return operation. |
canceled.user | The user has canceled their request for a return through your UI. This can only happen if the status of the return is pending.created. |
canceled.pickup-failed | The last-mile operator failed to pick up the return package. |
canceled.inspection-failed | The package was received by the merchant but the warehouse rejected the return because the product doesn't match its description or its return reason. |
success.returned | The package was successfully returned and approved by the warehouse. |
Settlement & Reconciliation
For settlement purpose, a return is accounted as refunded only on the date it becomes success.returned.