Seller confirms that buyer identity was verified at delivery

PATCH

/orders/v4/orders/:purchaseOrderId/regulatedInfo

Parity with Amazon SP-API Orders v0 updateVerificationStatus. The seller calls this after delivering a regulated-item order to record whether the buyer’s identity / age was verified at the doorstep. An APPROVED status releases the order for settlement; REJECTED requires a rejectionReason and triggers downstream return-processing.

Gated by the CCM-managed orders.features.regulatedInfoEnabled kill-switch (live-refreshable, parity with the cancel kill-switch).

Parity with Amazon SP-API Orders v0 `updateVerificationStatus`. The seller calls this after delivering a regulated-item order to record whether the buyer's identity / age was verified at the doorstep. An APPROVED status releases the order for settlement; REJECTED requires a `rejectionReason` and triggers downstream return-processing. Gated by the CCM-managed `orders.features.regulatedInfoEnabled` kill-switch (live-refreshable, parity with the cancel kill-switch).

Authentication

AuthorizationBearer

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

Path parameters

purchaseOrderIdstringRequired

Walmart Purchase Order ID

Request

This endpoint expects an object.

verificationStatusenumRequired

Outcome of the doorstep / pickup identity verification.

rejectionReasonenumOptional

Reason the verification was rejected. Required when verificationStatus=REJECTED; ignored otherwise. Mirrors Amazon SP-API’s enumerated rejection reasons.

Response

Success

purchaseOrderIdstringOptional

verificationStatusenumOptional

updatedAtdatetimeOptional

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