Commerce
placeApprovedOrder
Place Approved Order
Place an order the user has ALREADY approved, by driving their own machine through the merchant's checkout in a session opened for this order alone.
Arguments
agentLabelstringoptionalHow you were named to the user on their approval card. It has to match, or the approval will not be spent. Defaults to Ora.cancellationUrlstringoptionalThe merchant's own page for cancelling an order, so the user can be sent there if they change their mind after it is placed.historyUrlstringoptionalThe merchant's own order list, used to check what actually happened if the checkout is interrupted. Without it an interrupted order can only be reported as unknown.machineIdstringoptionalWhich of the user's machines runs the checkout (machineId from listMachines). Omit to let it pick a healthy one; whichever it lands on is then pinned for the whole order.planobject[]requiredThe checkout, in order: one open, then the clicks and fills, then exactly one submit. Pinned on the first call, so a later call cannot change it.purchaseIdstringrequiredThe same purchase id you reserved the spend against and asked for approval with. One purchase, one approval, one order.
Returns
Each call does ONE step and returns what happened, so call it again until state stops changing.
Ask for it
The Cloud routes these requests to this verb.
- go ahead and order it
- place that order
- finish the checkout
- buy it now that I have approved it
Pair it with
The verbs that finish the job.