{
"schemaVersion": "2026-08-29",
"id": "<string>",
"type": "settlement.updated",
"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": "order_settlement",
"id": "<string>",
"externalId": "<string>",
"externalNumber": "<string>"
},
"data": {
"settlement": {
"id": "<string>",
"orderId": "<string>",
"marketplace": "<string>",
"accountId": "<string>",
"externalOrderId": "<string>",
"externalOrderNumber": "<string>",
"currency": "<string>",
"grossSales": {
"amount": "<string>",
"currency": "<string>"
},
"refunds": {
"amount": "<string>",
"currency": "<string>"
},
"subsidies": {
"amount": "<string>",
"currency": "<string>"
},
"platformFees": {
"amount": "<string>",
"currency": "<string>"
},
"fulfillmentFees": {
"amount": "<string>",
"currency": "<string>"
},
"operatingFees": {
"amount": "<string>",
"currency": "<string>"
},
"marketplaceNet": {
"amount": "<string>",
"currency": "<string>"
},
"calculatedNet": {
"amount": "<string>",
"currency": "<string>"
},
"variance": {
"amount": "<string>",
"currency": "<string>"
},
"paymentReceived": {
"amount": {
"amount": "<string>",
"currency": "<string>"
},
"formulaId": "<string>",
"formulaVersion": "<string>"
},
"settlementReference": "<string>",
"payoutReference": "<string>",
"feeBreakdown": [
{
"feeType": "<string>",
"amount": {
"amount": "<string>",
"currency": "<string>"
}
}
],
"evidenceCounts": {
"estimated": 1,
"pending": 1,
"settled": 1,
"reversed": 1,
"voided": 1
},
"sourceOccurredAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
},
"changedFields": [
"<string>"
]
}
}Settlements
Settlement updated
Reference for the settlement.updated webhook.
WEBHOOK
settlementUpdated
{
"schemaVersion": "2026-08-29",
"id": "<string>",
"type": "settlement.updated",
"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": "order_settlement",
"id": "<string>",
"externalId": "<string>",
"externalNumber": "<string>"
},
"data": {
"settlement": {
"id": "<string>",
"orderId": "<string>",
"marketplace": "<string>",
"accountId": "<string>",
"externalOrderId": "<string>",
"externalOrderNumber": "<string>",
"currency": "<string>",
"grossSales": {
"amount": "<string>",
"currency": "<string>"
},
"refunds": {
"amount": "<string>",
"currency": "<string>"
},
"subsidies": {
"amount": "<string>",
"currency": "<string>"
},
"platformFees": {
"amount": "<string>",
"currency": "<string>"
},
"fulfillmentFees": {
"amount": "<string>",
"currency": "<string>"
},
"operatingFees": {
"amount": "<string>",
"currency": "<string>"
},
"marketplaceNet": {
"amount": "<string>",
"currency": "<string>"
},
"calculatedNet": {
"amount": "<string>",
"currency": "<string>"
},
"variance": {
"amount": "<string>",
"currency": "<string>"
},
"paymentReceived": {
"amount": {
"amount": "<string>",
"currency": "<string>"
},
"formulaId": "<string>",
"formulaVersion": "<string>"
},
"settlementReference": "<string>",
"payoutReference": "<string>",
"feeBreakdown": [
{
"feeType": "<string>",
"amount": {
"amount": "<string>",
"currency": "<string>"
}
}
],
"evidenceCounts": {
"estimated": 1,
"pending": 1,
"settled": 1,
"reversed": 1,
"voided": 1
},
"sourceOccurredAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
},
"changedFields": [
"<string>"
]
}
}See Settlement webhooks for lifecycle semantics,
idempotency, and a complete normalized example.
Headers
Allowed value:
"settlement.updated"Hex HMAC-SHA256 of {timestamp}.{rawBody} using the subscription secret.
Body
application/json
Allowed value:
"2026-08-29"Stable delivery event id.
Allowed value:
"settlement.updated"Required range:
x >= 1Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Response
2XX
Event accepted.