HandToHuman CLI reference All commands
DocsCLImarket order-bonus

Public command

market order-bonus

Release the performance bonus an accepted order earned.

Exact invocation
handtohuman market order-bonus <ORDER_ID>
01

Inputs and options

<ORDER_ID>

An accepted order belonging to a campaign that prices a bonus.

02

Output and state effect

Result

Computes the earned amount from the recorded measurement at the campaign’s rate per thousand, caps it at the campaign’s cap and at the remaining budget, splits it 85 percent to the supplier and 15 percent to the platform, and charges it to the buyer. Returns the measurement it used alongside the three money fields.

Serialization

Prints the bonus record as pretty-printed JSON.

Refusals

  • An order outside a campaign refuses with order <id> is not part of a campaign; a campaign with no rate refuses with campaign <id> prices no performance bonus.
  • No recorded measurement refuses with order <id> carries no measurement: record one with order-measure first.
  • A second release refuses with order <id> has already been paid its bonus.
  • A measurement that earns nothing at the campaign rate is refused rather than paid as zero.