Configure Narvar returns workflow to accept and track return shipments

Steps

1. Obtain your Narvar Account ID and Auth token from Admin > Company > API credentials in the Narvar portal; Narvar uses HTTP Basic authentication with the Account ID as the username and Auth token as the password.
2. Push order data to Narvar via the Order API, which requires order, order_items, shipment, billing, customer, and promotions fields; this baseline data is needed before returns can be initiated.
3. When a customer initiates a return through the Narvar Returns portal, Narvar creates a return record and triggers a return event that your integration can receive via the configured webhook endpoint.
4. Configure the webhook destination URL in the Narvar admin; Narvar posts JSON payloads containing the return ID, order reference, line items, return reason codes, and requested resolution (refund, exchange).
5. Update your OMS with the return details on webhook receipt; generate a prepaid return label via your carrier API and pass the tracking number back to Narvar so the portal shows return shipment status.
6. Poll or receive webhook events for return shipment status updates (in-transit, delivered to warehouse) to trigger inspection workflows and process refunds or exchanges in your system.