Create an unpaid order

No account needed — the delivery email is the only identity. Requires an Idempotency-Key header (8-128 chars of [A-Za-z0-9_-:.]); replaying the same key returns the same order instead of creating a second one.

post/api/public/create-order

Request

  • Base URL: https://kodshop.cloud
  • URL: https://kodshop.cloud/api/public/create-order
  • Auth: none required

Headers

Idempotency-Keystring required

Request body

emailstring email required

Where the code / eSIM QR is delivered

product_type'giftcard' | 'topup' | 'esim' | 'phone_rental' | 'phone_rental_renew' required
product_idinteger

product_type=giftcard|topup: id from listProducts

item_idinteger

product_type=giftcard|topup: chosen denomination (items[i].id)

quantityinteger

Units of item_id. Optional — omitting it buys 1, including on the many voucher products whose fields[] declares quantity required. Send it only to buy several copies of one denomination; fields[] carries the allowed min/max.

account_numberstring

Top-ups: recipient account, when the product's fields require it

amountnumber

Variable-amount top-ups only

extraobject

Product-specific inputs that have no dedicated field. Any entry in the product's fields[] whose code is not quantity / account_number / amount goes here, keyed by that code — e.g. game top-ups that need {"zone_id": "1234"} or {"server_id": "eu"}.

bundle_namestring

product_type=esim

country_codestring

product_type=esim / phone_rental

Response

Order created

order_idstring
access_tokenstring

Pass as ?token= to getOrder

pricenumber

Amount due, in currency

currencystring
price_rubnumber

Legacy alias of price

statusstring
productobject

Example response

{
  "currency": "RUB"
}

Changes

No recorded changes to this operation across all 1 revision of this API.