CentraHarper uses custom attributes in Centra to update the status of orders throughout the try-before-you-buy lifecycle. This document explains the full attribute schema, what each value means, and how your team can use them for reporting and operations.
Harper custom attributes appear on individual orders in your Centra admin under the Custom Attributes panel. They are also available via the Centra API and can be used for filtering, reporting, and integration purposes.
All Harper attributes use the prefix harper_ for easy identification.
Attributes are grouped by function: service identification, order status, and payment status.
HARPER order
The harper_order attribute identifies the order as a Harper order.
HARPER checkout id
The harper_checkout_id attribute contains the id from Harper's checkout.
<123456>HARPER Service TYPE
The harper_type attribute identifies the service used.
Concierge appointment information
A harper_appointment_date attribute holds information on the date and time of the upcoming Concierge appointment.
Example: 27/02/26/14:00
harper Order status
Relavent for both Concierge and Try services.
The harper_status attribute contains the following values, updated throughout the order lifecycle.
Order placed, not yet received or appointment pending
Try order received by customer — trial period active
All items returned or purchased
Order cancelled
addITIONAL BOOLEAN FIELDS
The additional boolean fields add additional context for some exceptions to the standard order lifecycle.
True when the order has items that are in the process of being returned and not yet received.
True when the order is in the 90 day in resolution period.
True when the order is confirmed as unrecovered (reimbursed state).
harper payments status
The harper_payments_status attribute gives finance teams a direct view of the financial position of each order, including a clear flag when an order is ready to reconcile.
Order placed, not yet received by customer.
Customer has received order and trial is active.
Part of order purchased and awaiting warehouse to process the remainder.
All items purchased or processed and order ready to reconcile.
Exception values
Applied when payment is paused to avoid incorrectly charging a customer.
Returns received at warehouse but not yet processed.
Order placed on hold by Harper (usually due to request from customer service).
Examples
A Harper Try order currently in trial:
A completed Harper Try order ready to reconcile:
A Concierge order awaiting warehouse processing after appointment: