{
"schemaVersion": "2026-08-29",
"id": "<string>",
"type": "return.status.changed",
"occurredAt": "2023-11-07T05:31:56Z",
"publishedAt": "2023-11-07T05:31:56Z",
"organizationId": "<string>",
"resourceVersion": 2,
"source": {
"marketplace": "<string>",
"accountId": "<string>",
"providerEventId": "<string>",
"providerEventType": "<string>"
},
"subject": {
"type": "return",
"id": "<string>",
"externalId": "<string>",
"externalNumber": null
},
"data": {
"return": {
"id": "<string>",
"orderId": "<string>",
"marketplace": "<string>",
"accountId": "<string>",
"externalReturnId": "<string>",
"externalOrderId": "<string>",
"marketplaceStatus": "<string>",
"country": "<string>",
"currency": "<string>",
"refundAmount": {
"amount": "<string>",
"currency": "<string>"
},
"itemCount": 1,
"quantity": 1,
"items": [
{
"id": "<string>",
"productId": "<string>",
"externalReturnItemId": "<string>",
"marketplaceItemId": "<string>",
"marketplaceVariantId": "<string>",
"sku": "<string>",
"sellerSku": "<string>",
"shopSku": "<string>",
"name": "<string>",
"status": "<string>",
"quantity": 1,
"refundAmount": {
"amount": "<string>",
"currency": "<string>"
}
}
],
"sourceCreatedAt": "2023-11-07T05:31:56Z",
"sourceUpdatedAt": "2023-11-07T05:31:56Z",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
},
"marketplacePreviousStatus": "<string>",
"marketplaceStatus": "<string>",
"changedFields": [
"<string>"
]
}
}Returns
Return status changed
Reference for the return.status.changed webhook.
WEBHOOK
returnStatusChanged
{
"schemaVersion": "2026-08-29",
"id": "<string>",
"type": "return.status.changed",
"occurredAt": "2023-11-07T05:31:56Z",
"publishedAt": "2023-11-07T05:31:56Z",
"organizationId": "<string>",
"resourceVersion": 2,
"source": {
"marketplace": "<string>",
"accountId": "<string>",
"providerEventId": "<string>",
"providerEventType": "<string>"
},
"subject": {
"type": "return",
"id": "<string>",
"externalId": "<string>",
"externalNumber": null
},
"data": {
"return": {
"id": "<string>",
"orderId": "<string>",
"marketplace": "<string>",
"accountId": "<string>",
"externalReturnId": "<string>",
"externalOrderId": "<string>",
"marketplaceStatus": "<string>",
"country": "<string>",
"currency": "<string>",
"refundAmount": {
"amount": "<string>",
"currency": "<string>"
},
"itemCount": 1,
"quantity": 1,
"items": [
{
"id": "<string>",
"productId": "<string>",
"externalReturnItemId": "<string>",
"marketplaceItemId": "<string>",
"marketplaceVariantId": "<string>",
"sku": "<string>",
"sellerSku": "<string>",
"shopSku": "<string>",
"name": "<string>",
"status": "<string>",
"quantity": 1,
"refundAmount": {
"amount": "<string>",
"currency": "<string>"
}
}
],
"sourceCreatedAt": "2023-11-07T05:31:56Z",
"sourceUpdatedAt": "2023-11-07T05:31:56Z",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
},
"marketplacePreviousStatus": "<string>",
"marketplaceStatus": "<string>",
"changedFields": [
"<string>"
]
}
}See Return webhooks for lifecycle semantics, status
normalization, pull reconciliation, and a complete payload example.
Headers
Stable event id and recipient idempotency key.
Hex HMAC-SHA256 over timestamp.rawBody.
Body
application/json
Allowed value:
"2026-08-29"Allowed value:
"return.status.changed"Required range:
x >= 1Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Response
Event durably accepted.