Skip to main content
POST
/
orders
Create order
curl --request POST \
  --url https://staging.api.commercengine.io/api/v1/{store_id}/storefront/orders \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "cart_id": "<string>",
  "payment_method": {
    "payment_provider_slug": "<string>",
    "integration_type": "<string>",
    "gateway_reference_id": "<string>",
    "return_url": "<string>",
    "action": "paymentPage"
  }
}
'
{
  "message": "<string>",
  "success": true,
  "content": {
    "order": {
      "applied_promotions": [
        {
          "promotion_id": "<string>",
          "promotion_type": "discount",
          "savings": 123,
          "product_id": "<string>",
          "variant_id": "<string>",
          "product_name": "<string>",
          "variant_name": "<string>",
          "applied_sequence": 123,
          "scope": "<string>"
        }
      ],
      "applied_coupons": [
        {
          "coupon_id": "<string>",
          "coupon_type": "discount",
          "savings": 123,
          "product_id": "<string>",
          "variant_id": "<string>",
          "product_name": "<string>",
          "variant_name": "<string>"
        }
      ],
      "order_number": "<string>",
      "order_date": "2023-11-07T05:31:56Z",
      "status": "draft",
      "payment_status": "pending",
      "payment_success_date": "<string>",
      "customer_note": "<string>",
      "is_promotion_applied": true,
      "promotion_discount_amount": 123,
      "promotion_discount_percent": 123,
      "is_coupon_applied": true,
      "coupon_code": "<string>",
      "coupon_discount_amount": 123,
      "coupon_discount_percent": 123,
      "promotion_savings": 1,
      "coupon_savings": 1,
      "other_savings": 1,
      "total_savings": 1,
      "on_subscription": true,
      "subtotal": 123,
      "item_total_tax": 123,
      "subtotal_including_tax": 123,
      "shipping_estimated_cost": 1,
      "shipping_discount_amount": 1,
      "shipping_amount": 123,
      "shipping_tax_rate": 1,
      "shipping_tax_amount": 1,
      "shipping_amount_including_tax": 1,
      "fulfillment_preference": {
        "fulfillment_type": "<string>",
        "pickup_location_id": "<string>",
        "preference_type": "user",
        "pickup_location_name": "<string>"
      },
      "estimated_delivery_days": 123,
      "handling_charge_excluding_tax": 1,
      "handling_charge_tax_amount": 1,
      "handling_charge_including_tax": 1,
      "total_tax": 123,
      "grand_total": 123,
      "loyalty_points_earned": 1,
      "loyalty_points_redeemed": 1,
      "credit_balance_used": 123,
      "to_be_paid": 123,
      "order_items_count": 123,
      "order_items": [
        {
          "product_id": "<string>",
          "product_name": "<string>",
          "product_image_url": "<string>",
          "product_type": "physical",
          "sku": "<string>",
          "slug": "<string>",
          "variant_id": "<string>",
          "variant_name": "<string>",
          "backorder": true,
          "on_promotion": true,
          "on_subscription": true,
          "subscription_plan": "<string>",
          "subscription_interval": 123,
          "subscription_frequency": "<string>",
          "quantity": 1,
          "free_quantity": 1,
          "is_free_item": true,
          "price_including_tax": true,
          "selling_price": 1,
          "listing_price": 1,
          "selling_price_excluding_tax": 1,
          "promotion_discount_amount": 1,
          "coupon_discount_amount": 1,
          "tax_type": "GST",
          "tax_rate": 1,
          "tax_amount": 1,
          "handling_charge_excluding_tax": 1,
          "handling_charge_tax_rate": 1,
          "handling_charge_including_tax": 1,
          "associated_options": {
            "background_color": {
              "name": "Background Color",
              "value": {
                "name": "Blue",
                "hexcode": "#0000FF"
              },
              "type": "color"
            },
            "size": {
              "name": "Size",
              "value": "Large",
              "type": "single-select"
            }
          },
          "attributes": [
            {
              "id": "<string>",
              "name": "<string>",
              "key": "<string>",
              "type": "color",
              "value": [
                {
                  "name": "<string>",
                  "hexcode": "<string>"
                }
              ]
            }
          ]
        }
      ],
      "billing_address": {
        "first_name": "<string>",
        "last_name": "<string>",
        "country_code": "<string>",
        "phone": "<string>",
        "email": "<string>",
        "address_line1": "<string>",
        "address_line2": "<string>",
        "landmark": "<string>",
        "pincode": "<string>",
        "city": "<string>",
        "state": "<string>",
        "country": "<string>",
        "tax_identification_number": "<string>",
        "business_name": "<string>",
        "is_phone_verified": true,
        "is_email_verified": true,
        "id": "<string>"
      },
      "shipping_address": {
        "first_name": "<string>",
        "last_name": "<string>",
        "country_code": "<string>",
        "phone": "<string>",
        "email": "<string>",
        "address_line1": "<string>",
        "address_line2": "<string>",
        "landmark": "<string>",
        "pincode": "<string>",
        "city": "<string>",
        "state": "<string>",
        "country": "<string>",
        "tax_identification_number": "<string>",
        "business_name": "<string>",
        "is_phone_verified": true,
        "is_email_verified": true,
        "id": "<string>"
      },
      "currency": {
        "name": "<string>",
        "code": "<string>",
        "symbol": "<string>"
      },
      "metadata": {},
      "is_cancellation_allowed": true,
      "cancellation_refund_details": {
        "loyalty_point": 123,
        "refundable_amount": 123,
        "cancellation_charges": 123,
        "cancellation_charges_reason": "<string>",
        "payment_mode": "original-payment-mode"
      },
      "feedback": "<string>"
    },
    "payment_required": true,
    "payment_info": {
      "id": "<string>",
      "status": "<string>",
      "order_id": "<string>",
      "payment_links": {
        "web": "<string>",
        "expiry": "<string>"
      },
      "sdk_payload": {
        "requestId": "<string>",
        "service": "<string>",
        "payload": {
          "clientId": "<string>",
          "merchantId": "<string>",
          "clientAuthToken": "<string>",
          "clientAuthTokenExpiry": "<string>",
          "environment": "<string>",
          "orderId": "<string>",
          "amount": "<string>",
          "action": "<string>",
          "customerId": "<string>",
          "firstName": "<string>",
          "lastName": "<string>",
          "returnUrl": "<string>",
          "customerPhone": "<string>",
          "customerEmail": "<string>",
          "currency": "<string>",
          "description": "<string>",
          "options.createMandate": "<unknown>",
          "mandate.maxAmount": "<string>",
          "mandate.start_date ": "<string>",
          "mandate.end_date ": "<string>",
          "mandate.frequency": "<unknown>",
          "mandate.rule_value ": "1-7"
        }
      },
      "order_expiry": "2023-11-07T05:31:56Z"
    }
  }
}

Authorizations

Authorization
string
header
required

Access token

Body

application/json

Request body

cart_id
string
required
payment_method
JusPayHyperCheckout · object
  • JusPayHyperCheckout
  • JusPayNewCard
  • JusPaySavedCardToken
  • JuspayNetBanking
  • JuspayUpiCollect
  • JuspayUpiIntent

Response

OK

message
string
required
success
boolean
required
content
object
required