Charge amount in USD cents (at least 100, i.e. $1.00). The API validates
the upper bound (BCK.ORDER.0001); a deployment may enforce a lower
per-order cap (BCK.ORDER.0003).
OptionalbuyerOpaque merchant-supplied buyer reference, e.g. the merchant's own order id (max 255 chars).
OptionalcaptureStripe capture mode. Phase 1 supports 'automatic' only (the default).
OptionalcurrencyISO currency, lower-cased. Phase 1 is USD-only; defaults to 'usd'.
OptionaldescriptionHuman-readable description of the charge (max 1024 chars).
OptionalidempotencyIdempotency key (max 255 chars). A retry with the same key returns the
original Order unchanged (and its clientSecret while the Order is still
payable); the other fields of the retry are ignored, not merged. A retry
with a different amountMinor or currency is refused with BCK.ORDER.0007.
OptionallineCart line items — merchant-defined structure, recorded verbatim (keys are not transformed), opaque to the API.
OptionalmetadataMerchant-defined metadata, recorded verbatim (keys are not transformed), opaque to the API.
OptionalpaymentPayment Service Provider that settles the Order. Phase 1 implements 'stripe' only (the default).
Body of
POST /api/v1/orders(RegisterOrderDto). The authenticated merchant key sets the price; the seller's Stripe Connect account is resolved server-side and is deliberately NOT part of this contract.