Seller performance report

Use this webhook to receive a weekly KPI rollup across Walmart performance standards. Use it to trend performance, coach sellers, and plan follow ups.

Event type

• Use the SELLER_PERFORMANCE_NOTIFICATIONS event
• Route by payload.notificationType= REPORT

Who this is for
Analytics, account health, and partner success teams, and approved Solution Providers who monitor KPI trends.

How it works

1. Walmart aggregates KPI results for the weekly window.
2. Walmart posts a SELLER_PERFORMANCE_NOTIFICATIONS delivery with notificationType="REPORT" to your callback URL with KPI values, status versus the standard, and trend direction.
3. Your service verifies the signature, stores the event, and updates dashboards and alerts.
4. Your service returns 2xx after a durable write.

Timing

Sent weekly on Mondays at 5:00 AM PT.

Before you begin

• A Walmart Marketplace account and API credentials
• A public HTTPS callback URL
• Request signature verification in your receiver (refer to Security and authenticity)

Delivery payload

Delivery format

Webhook requests include a payload object with event-specific fields. Use the following schema to validate and parse the payload, then return a 2xx response after a durable write.

Payload schema

{ "source": { "eventType": "SELLER_PERFORMANCE_NOTIFICATIONS", "eventTime": "2019-02-21T01:01:08.000Z", "eventId": "03d34580-61d4-11ea-9e23-cd38810ff7cd" }, "payload": { "partnerId":"123456789", "lastRefreshTs": "2025-09-10 12:52:36 UTC", "moreInfoLink": "https://marketplacelearn.walmart.com/guides/Policies%20&%20standards/Performance/Seller-performance-standards?locale=en-US", "supportedLanguages": ["en-US"], "notificationType": "REPORT", "enNotification" : { "summary" : "Here is the summary of your Walmart performance, the scores are current as of Sun Jul 27", "message" : "To download order details use the following api links:", "metrics": [ { "kpi": "On-time delivery", "score": 75.8, "overallTrend" : "GREEN_UP", "performanceStandard": "90% or above", "performanceRiskLevel" : "Monitor", "duration" : "30 days", "developerPortalApiLink" : "https://developer.walmart.com/us-marketplace/reference/getotdordersreport" }, { "kpi": "Valid tracking", "score": 75.8, "overallTrend" : "GREEN_UP", "performanceStandard": "99% or above", "performanceRiskLevel" : "Monitor", "duration" : "30 days", "developerPortalApiLink" : "https://developer.walmart.com/us-marketplace/reference/getvtrordersreport" }, { "kpi": "Seller response", "score": 75.8, "overallTrend" : "GREEN_UP", "performanceStandard": "95% or above", "performanceRiskLevel" : "Monitor", "duration" : "30 days", "developerPortalApiLink" : "https://developer.walmart.com/us-marketplace/reference/getsrrordersreport" }, { "kpi": "Refunds", "score": 2.8, "overallTrend" : "GREEN_DOWN", "performanceStandard": "6% or below", "performanceRiskLevel" : "Monitor", "duration" : "30 days", "developerPortalApiLink" : "https://developer.walmart.com/us-marketplace/reference/getcancellationsordersreport" }, { "kpi": "Cancellations", "score": 5.8, "overallTrend" : "GREEN_DOWN", "performanceStandard": "2% or below", "performanceRiskLevel" : "Urgent", "duration" : "30 days", "developerPortalApiLink" : "https://developer.walmart.com/us-marketplace/reference/getrefundsordersreport" } ] } }
}

Field notes

• lastRefreshTs shows the timestamp when report values were last calculated (format example: YYYY-MM-DD HH:mm:ss UTC).
• moreInfoLink points sellers to policy and standards details.
• supportedLanguages lists locales available for notification blocks.
• enNotification contains the English notification text and an array of KPI metrics. For other locales, a similarly named block may be provided in future versions.
• Each entry in metrics[] includes the KPI identifier (kpi), the numeric score, the standard threshold, a direction (relative to the standard), an overallTrend, a riskLevel, and a duration string describing the evaluation window.

Trend values for overallTrend

The overallTrend response indicates how a metric changed compared to the prior evaluation period (ending the day before the current report). It encodes both direction and whether the change is good or bad, based on how that metric is evaluated. The UP / DOWN suffix reflects whether the metric value increased or decreased; the GREEN / RED prefix reflects whether that directional change is considered positive or negative for that metric.

Risk levels (by KPI)

Each KPI in enNotification.metrics[] includes a performanceRiskLevel to indicate urgency relative to the standard.

Notes: performanceRiskLevel is per KPI and independent of overallTrend. A KPI can be Good and still show RED_UP or RED_DOWN if it’s above the standard but declining.

Handle the event

1. Verify the request signature.
2. Confirm the event targets a seller you manage.
3. Store the payload and deduplicate by eventId.
4. Update dashboards and alerts from enNotification.metrics[].
5. Return 2xx after you finish the write.

Errors and retries

• Walmart retries on non 2xx with backoff.
• Repeated failures can mark your endpoint as broken and trigger email notices to your contacts.
• Monitor delivery logs and fix broken endpoints before you reenable them. Refer to Troubleshooting and delivery health.

Test in sandbox

Use the Notifications APIs to send a test delivery to your endpoint. Start with the sample payload and adjust KPI values to validate your flows.
How-to: Test in sandbox
API reference: Test notification

Next steps

• Set up your webhook endpoint: Set up your Performance webhook endpoint
• Subscribe or update endpoints: Subscribe to an event notification
• Implement verification: Security and authenticity
• Validate in sandbox: Test in sandbox

Reference guide

• Get event types: Lists available performance events and versions.
• Create subscription: Registers your callback URL for a webhook endpoint that can receive REPORT notifications.
• Update subscription: Changes an existing subscription to route this event to a different endpoint or adjust the event set.
• Test notification: Triggers a sample delivery to your callback URL to validate signature checks and handling.

Related

• Performance webhook overview
• Event catalog
• Seller performance alarms