Skip to main content

Child Orders

Child orders are a concept within Two's system that emerges when an original order is partially fulfilled.

What is a child order?​

Whenever an order is partially fulfilled, two children are created: one representing the fulfilled portion, and the other the remaining part. The original order retains a record of these children.

The diagram below illustrates the subdivision of an original order into its fulfilled and remaining children.

Parent Child Order Structure Diagram

Dealing with child Orders​

  • A child order serves solely for facilitating partial fulfillments. To identify a child order, look for a root_order_id that differs from the order's own id.
  • Merchants typically do not need to concern themselves with child orders directly; Two provides information about them primarily through invoices.
  • Child orders do not impact a buyer's credit limit; only the root order (i.e., the original order) does.

Refunding a Partially Fulfilled Order​

To issue a refund (full or partial) for an order that has child orders, you should always use the original order ID.

To issue a refund, use the POST /v1/order/:order_id/refunds endpoint. You will specify the amount and line items for which the refund is being issued in the request body.

When a refund is processed, it is associated with the original order, so there is no need to track the child order ID for which you are issuing a refund.

To create a valid credit note, ensure that the line item and refund amount are accurately matched, and the values are corrected if necessary. This applies to all order-related operations.