Issue a seller-initiated refund for one or more order lines

Walmart-specific write — no Amazon SP-API Orders v0 equivalent (Amazon refunds live in the Finance API). Mirrors gmp-orders-mono’s legacy /partner-api/{market}/v3/orders/{po}/refund contract, simplified for the v4 surface: a flat orderLines[] with per-line refund amount + reason instead of the legacy three-level nesting (orderLines → refunds → refundCharges).

Walmart-specific write — no Amazon SP-API Orders v0 equivalent (Amazon refunds live in the Finance API). Mirrors gmp-orders-mono's legacy `/partner-api/{market}/v3/orders/{po}/refund` contract, simplified for the v4 surface: a flat `orderLines[]` with per-line refund amount + reason instead of the legacy three-level nesting (`orderLines → refunds → refundCharges`).

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

purchaseOrderIdstringRequired

Request

This endpoint expects an object.

orderLineslist of objectsRequired

Response

Success

purchaseOrderIdstringOptional

refundIdstringOptional

Seller-visible refund handle, generated server-side. Stable for the lifetime of the refund; future GET endpoints will accept it as a path variable.

refundedAtdatetimeOptional

Errors

400

Bad Request Error

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error

503

Service Unavailable Error