Updated order attributes for your Centra store

We’ve made some changes to the way Harper writes order attributes in your Centra store. This document explains what’s new, what’s changing, and what your team needs to do before 1 June 2026.

The attribute schema has been updated to align with the new structure and to provide richer, more consistent order-level data. A new dedicated payments attribute has been introduced so Finance teams can track reconciliation state independently of order status.

Do you need to take action?

This is some text inside of a div block.

● Now

New attributes are already being written to orders, running alongside the old ones

● Before 1 June 2026

Update any reports or workflows that reference the old attributes

● 1 June 2026

Old attributes deprecated. New attributes only from this point.

New attributes, live now

The new attribute structure

Harper writes custom attributes directly to orders in Centra. The schema has been updated to be cleaner and more structured, with a new dedicated payments attribute for finance visibility.

Core attributes

Written to every Harper order.

This is some text inside of a div block.

true / false — Identifies the order as a Harper order. Unchanged.

This is some text inside of a div block.

harper_try │ harper_concierge — Service type. Unchanged.

This is some text inside of a div block.

new │ cancelled │ in_trial │ trial_ended — Overall order state. Now limited to four values.

This is some text inside of a div block.

New. Finance/reconciliation state — customer_awaiting_items │ in_fitting_room │ hold_warehouse_refund_due │ hold_pending_harper │ available │ reconcilable

This is some text inside of a div block.

string — Harper checkout ID. Unchanged.

This is some text inside of a div block.

JSON array — Per-item statuses.

New optional attributes

These attributes appear where applicable and provide additional order context.

This is some text inside of a div block.

true / (absent) — True when items are being returned but not yet received at the warehouse.

This is some text inside of a div block.

e.g. 2026.03.18/14:30 — Scheduled appointment date and time for Concierge orders (format: YYYY.MM.DD/HH:MM).

This is some text inside of a div block.

true / (absent) — True when the order is in payment recovery. Previously a value on harper_status.

This is some text inside of a div block.

true / (absent) — True when the order has been written off. Previously a value on harper_status.

This is some text inside of a div block.

comma-separated string — Lists any loyalty reward types applied to the order.

Old attributes, retiring 1 June 2026

Attributes your team may need to update

If anyone in your team is using the attributes below in reports, dashboards, or finance workflows, those references will need updating before 1 June 2026.

Both old and new attributes are currently running in parallel to give you time to make the switch.

This is some text inside of a div block.

Now: harper_dispute = true

This is some text inside of a div block.

Now: harper_reimburse = true

This is some text inside of a div block.

Now: harper_payments_status = reconcilable

This is some text inside of a div block.

Now: harper_status = in_trial

This is some text inside of a div block.

Now: harper_status = trial_ended

This is some text inside of a div block.

Now: harper_status = trial_ended + harper_payments_status = reconcilable

If you need to pass these changes to a developer or analyst to update your integration, we’re happy to help make that process as smooth as possible.

Reach out to your Harper account manager or contact: support@harperconcierge.com

harper.

Centra partner brief · Order attribute changes · Deadline 1 June 2026