The Sync Refunds button fetches the latest refund requests from TikTok Shop and updates them in your Magento system.
- You want the most recent refund requests
- A customer initiates a new return or refund on TikTok
- You have processed refunds manually inside the TikTok Seller Center
- Your refund data looks outdated
Best practice: Click Sync Refunds regularly to keep financial records accurate.
Refund Page Grid
Each row represents a single refund request created on TikTok Shop. Below is a complete explanation of each column:
- Marketplace Refund ID: The unique refund request ID generated by TikTok Shop.
- Marketplace Order ID: The original TikTok Shop order ID associated with the refund. This helps match refunds to specific orders.
- Account ID: Displays the TikTok Shop account under which the order was placed.
- Type: Indicates the type of request:
- Refund – refund without product return
- Return & Refund – returned product with a refund
- Status: Shows the internal refund state inside your Magento system.
- Requested: The customer has submitted a refund request on TikTok, and it is newly created but not yet reviewed.
- Pending: The refund request is under review or awaiting further action (seller, courier, or TikTok decision).
- Accepted: The refund request has been approved and is waiting for final processing or payout settlement.
- Refund: The refund has been successfully processed and completed.
- Rejected: The refund request has been declined based on the seller's or TikTok’s decision.
- Marketplace Status: Shows TikTok’s real-time refund decision.
- Reason: Displays the customer’s reason for requesting the refund
- Created At: The date and time when the refund request was raised on TikTok.
- Updated At: The last time the refund status was updated by TikTok.
- Refund Data: Click the icon to view detailed refund information
- Actions: Allows you to take manual action on the refund:
- Completed: Marks the refund as successfully processed
- Reject: Declines the refund request when the terms are not met
Filters
Use filters to find refunds quickly by:
- Created At
- Updated At
- Marketplace Refund ID
- Marketplace Order ID
- Account ID
- Status
This is especially helpful during:
- Monthly reconciliation
- Audit checks
- Support investigations
Best Practices
- Sync refunds daily
- Monitor Pending refunds carefully
- Match Marketplace Status before taking manual action
- Use the Refund Data view for audit verification
- Export refund reports for finance reconciliation