commerce

POST `/v1/carts/{cartId}/checkout`

Check out a cart — place and charge an order.

ການພິສູດຕົວຕົນ

ສົ່ງລະຫັດ API ເປັນ bearer token. ລະຫັດຕ້ອງມີສິດ billing.payment.manage; ລະຫັດທີ່ບໍ່ມີສິດດັ່ງກ່າວຈະຖືກປະຕິເສດດ້ວຍລະຫັດ 403, ບໍ່ແມ່ນ 404.

ຈຸດເຊື່ອມຕໍ່ນີ້ບໍ່ໄດ້ຮັບ ID ອົງກອນ. ລະຫັດຂອງທ່ານໄດ້ລະບຸອົງກອນທີ່ມັນຂຶ້ນກັບແລ້ວ, ແລະ ຄໍາຕອບແມ່ນຖືກຈໍາກັດຂອບເຂດໄວ້ສໍາລັບອົງກອນນັ້ນ.

ລອງໃຊ້ເບິ່ງ

ປ່ຽນແທນທຸກຢ່າງທີ່ຢູ່ໃນວົງເລັບມຸມດ້ວຍຄ່າຂອງທ່ານເອງ, ແລະ ປ່ຽນແທນຕົວແທນບ່ອນວ່າງຄີດ້ວຍຄີຈາກແຜງຄວບຄຸມຂອງທ່ານ.

curl -X POST https://api.zinndigital.com/v1/carts/{cartId}/checkout \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{  }'

ເຂົ້າສູ່ລະບົບແລ້ວບໍ? ໂຄງສົນທະນາ API ໃນໜ້າັດສະຫຼອງຂອງທ່ານຈະຕື່ມຂໍ້ມູນລະຫັດອົງກອນຕົວຈິງ ແລະ ລະຫັດລັບສ່ວນຕົວຂອງທ່ານໂດຍອັດຕະໂນມັດ, ແລະ ປະຕິບັດການຮ້ອງຂໍຜ່ານ API ຕົວຈິງ ເພື່ອໃຫ້ທ່ານສາມາດເຫັນຜົນຕອບຮັບທີ່ແທ້ຈິງໄດ້. ເປີດຈຸດສິ້ນສຸດນີ້ໃນຄອນໂສລ API

ລາຍລະອຽດ

Converts the cart to an immutable order: re-prices every line, re-verifies each domain availability token (a stale/taken one is a 409, with no charge), computes tax, places the order and charges it wallet-first. Fulfilment (provisioning/registration) then runs asynchronously as a Temporal workflow — this call never blocks on it (§2.9); poll the order status or the resource it produces. An Idempotency-Key header is required: a retried checkout returns the same order and never charges twice. Requires billing.payment.manage.

ພາຣາມິເຕີ

ຊື່	ປະເພດ	ຕ້ອງການ	ສິ່ງທີ່ມັນເປັນ
`cartId (path)`	`Uuid`	ແມ່ນແລ້ວ	The cart's id.
`Idempotency-Key (header)`	`string`	ບໍ່	Client-generated key that makes an unsafe request replay-safe: the server stores the first response and returns it verbatim for repeats.

ເນື້ອຫາຂອງຄຳຮ້ອງ

ຊື່	ປະເພດ	ຕ້ອງການ	ສິ່ງທີ່ມັນເປັນ
`billing_country`	`object`	ບໍ່	ISO 3166-1 alpha-2 country for the tax jurisdiction.
`availability_tokens`	`object`	ບໍ່	`domain_name` → the availability token issued by the domain search endpoint. Required for every `domain_register` line; each is re-verified at checkout and a stale one is a `409`.
`gateway`	`object`	ບໍ່	The payment rail the customer chose at checkout — one of the codes `getPaymentOptions` returned for this organization and currency. Omit it and the order is charged wallet-first…
`expected_total_minor`	`object`	ບໍ່	The order total the checkout page displayed to the customer, in minor units. Send it and checkout refuses with `422` when the basket no longer comes to that figure; omit it…

ຖືກໂຈະ

ຊື່	ປະເພດ	ຕ້ອງການ	ສິ່ງທີ່ມັນເປັນ
`id`	`Uuid`	ແມ່ນແລ້ວ	UUIDv7 identifier — sortable by creation time (docs/02 §8).
`org_id`	`Uuid`	ແມ່ນແລ້ວ	UUIDv7 identifier — sortable by creation time (docs/02 §8).
`human_ref`	`string`	ແມ່ນແລ້ວ	Human-friendly order reference.
`status`	`OrderStatus`	ແມ່ນແລ້ວ	An order's lifecycle state (docs/31 §4.3).
`currency`	`CurrencyCode`	ແມ່ນແລ້ວ	ISO 4217 currency code (money is minor units + this code — CLAUDE.md §2.8).
`subtotal_minor`	`integer`	ແມ່ນແລ້ວ	—
`tax_minor`	`integer`	ແມ່ນແລ້ວ	—
`discount_minor`	`integer`	ແມ່ນແລ້ວ	—
`total_minor`	`integer`	ແມ່ນແລ້ວ	—
`billing_country`	`object`	ບໍ່	—
`placed_at`	`object`	ບໍ່	—
`created_at`	`string`	ແມ່ນແລ້ວ	—
`updated_at`	`string`	ບໍ່	—
`lines`	`OrderLine[]`	ແມ່ນແລ້ວ	—
`payments`	`Payment[]`	ແມ່ນແລ້ວ	—

ຂໍ້ຜິດພາດທີ່ຈຸດເຊື່ອມຕໍ່ນີ້ສາມາດສົ່ງຄືນໄດ້

401 · 403 · 404 · 409 · 422 · 429

POST /v1/carts/{cartId}/checkout