Checkout

Prod Env

https://v1.dev.bukalombok.com

POST

/v1/customer/orders/checkout

API Documentation - Create Order

Overview

API untuk membuat order baru dengan sistem shipping terintegrasi.

Endpoint

POST /v1/orders

Description: Membuat order baru dari cart items dengan perhitungan shipping otomatis

Authentication: Bearer Token (JWT)

Request

Headers:

Body Parameters:

{
  "addressId": "address-123",
  "cartItemIds": ["cart-item-1", "cart-item-2"],
  "services": {
    "serviceId": "shipping-service-123",
    "selectedSlotId": "slot-456"
  },
  "notes": "Catatan untuk penjual"
}

Parameters Details:

Parameter	Type	Required	Description
`addressId`	string	✅	ID alamat pengiriman
`cartItemIds`	string[]	✅	Array ID cart items
`services.serviceId`	string	✅	ID layanan shipping
`services.selectedSlotId`	string	✅	ID slot pengiriman
`notes`	string	❌	Catatan opsional

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/json

Examples

Responses

🟢201Created

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://v1.dev.bukalombok.com/v1/customer/orders/checkout' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "addressId": "f7bf8197-bf65-4237-a383-6fc940f95682",
  "cartItemIds": [
    "7bc7ba13-dfa3-4d41-88fe-4fd1351ae330"
  ],
  "services": {
    "serviceId": "6ebaffd2-24be-48ca-acf0-260313894bdd",
    "selectedSlotId": "72461f50-35d8-4bd7-bd5a-ac43246ef42f"
  },
  "notes": "MOHON DIKIRIM CEPAAAT",
  "paymentMethod": {
    "type": "VIRTUAL_ACCOUNT",
    "channelCode": "BRI"
  }
}'

Response Example

{
    "meta": {
        "success": true,
        "status": 201,
        "message": "Order berhasil dibuat. Silakan lanjutkan pembayaran."
    },
    "data": {
        "orderId": "730aec63-7937-4c39-b7b4-218ee3fb76ed",
        "orderNumber": "ORD-TOKOSE-251022-DD8ADE8D",
        "subtotal": "18990000",
        "totalFees": "759600",
        "shippingFee": "184616",
        "totalPrice": "19934216",
        "feeBreakdown": {
            "subtotal": "18990000",
            "fees": [
                {
                    "feeName": "Insurance Fee",
                    "unit": "PERCENTAGE",
                    "rate": 2.5,
                    "amount": 474750
                },
                {
                    "feeName": "Admin Fee",
                    "unit": "PERCENTAGE",
                    "rate": 1.5,
                    "amount": 284850
                }
            ],
            "totalFees": "759600",
            "shippingFee": "184616",
            "grandTotal": "19934216"
        },
        "shippingBreakdown": {
            "totalFee": 184616,
            "totalWeight": "1200g",
            "pricingTier": "Express",
            "vendorCount": 1,
            "vendors": [
                {
                    "vendorName": "Toko Sembako Makmur",
                    "distance": "10.25km",
                    "weight": "1200g",
                    "customerFee": 184616,
                    "actualCost": 129232
                }
            ]
        },
        "payment": {
            "paymentUrl": "https://checkout-staging.xendit.co/web/68f8b447f61f908e0ff0097f",
            "expiresAt": "2025-10-23T10:39:03.415Z",
            "status": "PENDING"
        }
    }
}

Modified at 2025-12-29 12:25:22

Get Single Order

Cancel Order

Checkout

API Documentation - Create Order#

Overview#

Endpoint#

POST /v1/orders#

Request#

Headers:#

Body Parameters:#

Parameters Details:#

Request

Responses

API Documentation - Create Order

Overview

Endpoint

POST /v1/orders

Request

Headers:

Body Parameters:

Parameters Details: