(65) RMA Status Update

Use this webhook to track the package-level lifecycle for the RMA object generated from approved items in the Aftersales Request.

1. Trigger scenario

The RMA Status Update webhook is triggered in the following scenarios:

RMA is created

The RMA package is delivered and is pending the seller to review items to make a refund decision.

The RMA items review and refund decision is completed.

Note: The RMA is automatically created once the Aftersales Request has been approved. The RMA decision is considered the second-review stage of the Aftersales journey.

2. Data business parameters

Properties	Type	Example	Description
shop_id	String	7494049642642441621	TikTok Shop identifier associated with the event.
timestamp	Int	1732526400	The time when this webhook was triggered, represented by Unix timestamp.
tts_notification_id	String	7327112393057371910	Unique notification identifier for deduplication and tracing.
type	Int	65	Numeric webhook event type.
data	Object
└ rma_id	String	576486316948490002	Unique identifier of the RMA.
└ aftersales_request_id	String	576486316948490001	Parent aftersales request identifier.
└ return_role	String	BUYER	Role that initiated the return flow. Possible enumerations: * BUYER * SELLER
└ rma_status	String		Current RMA status. Possible enumerations: * RMA_CREATED = The RMA has been created * PENDING_PACKAGE_REVIEW = The return package has been delivered and is pending seller package review. The seller has 2 business days SLA to respond with a refund review/decision. * PACKAGE_REVIEW_COMPLETED = The package review lifecycle is complete.
└ rma_request_create_time	Int	1627587600	Creation time of the RMA in Unix seconds.
└ rma_request_update_time	Int	1644412885	Last update time of the RMA in Unix seconds.

Event example

JSONWord Wrap

{
"type": 65,
"tts_notification_id": "1111111113",
"shop_id": "1234567890",
"timestamp": 1644412889,
"data": {
"rma_id": "576486316948490002",
"aftersales_request_id": "576486316948490001",
"return_role": "BUYER",
"rma_status": "RMA_CREATED",
"rma_create_time": 1627587601,
"rma_update_time": 1644412889
}
}