Payments and returns

Payments and returns extensions render inside the payment status and return status cards on the Order status page. These cards appear alongside Shopify's native payment and return UI so customers see your extension content in direct context with their order's financial and return details.

Anchor to Use casesUse cases

• Payment reminders: Display notices about outstanding balances, payment terms, or upcoming due dates for orders with pending payments.
• Cost breakdowns: Show supplementary payment information such as installment details, loyalty point usage, or custom surcharges.
• Return status updates: Provide customers with additional context about their return, such as estimated refund timelines or return shipping instructions.
• Return processing details: Display app-specific return information, such as restocking status, exchange options, or return policy reminders.
• Order-specific messaging: Surface contextual messages related to payment or return activity on an order.

Anchor to Payments and returns targetsPayments and returns targets

Payments and returns targets render inside the payment status and return status cards on the Order status page. They're useful for adding contextual information about payments and returns tied to an order.

Anchor to Payment details (render after) ,[object Object]Payment details (render after) target

customer-account.order-status.payment-details.render-after

Renders after the payment details in the payment status card on the Order status page.

Use this target to display payment reminders, cost summaries, or supplementary payment information for an order. This target gives you access to the Order API and the Cart Lines API.

Anchor to Return details (render after) ,[object Object]Return details (render after) target

customer-account.order-status.return-details.render-after

Renders after the return details in the return status card on the Order status page. This card only appears when a return has been requested. A separate instance of this extension is rendered for each return.

Use this target to display return processing updates, refund estimates, or supplementary return information for a specific return. This target provides shopify.returnId to identify the current return, and also gives you access to the Order API and the Cart Lines API.