Supported Couriers

Courier code is sent through the service field inside each package. Examples:

• gosend
• grab_express
• borzo

Use the courier code and service_type returned by the pricing/check tariff endpoint.

v6.2 Highlights

• KA Credit payment support through payment_method: "credit"
• PIN validation through pin when using KA Credit
• Nested recipient data through packages[].destination
• Vehicle selection through vehicle
• Insurance type support through insurance_type
• Multi-item package support through items

Important KA Credit Note

When using payment_method: "credit", ensure the KA Credit balance is at least equal to the shipping_cost of the package. If the balance is insufficient, the request may be rejected before courier booking is created.

Authentication

All requests must include a bearer token.

Authorization: Bearer <token>
Content-Type: application/json

Order Flow

sequenceDiagram
participant c as Client
participant kaj as KiriminAja
participant cr as Instant Courier

c->>kaj: Create Instant Package
Note over c,kaj: payment_method: "credit" requires PIN and sufficient balance
kaj->>kaj: Validate sender, destination, payment, PIN, and package
kaj->>kaj: Validate service, service_type, vehicle, and shipping_cost
kaj->>cr: Create instant courier booking
cr-->>kaj: Booking result / tracking data
kaj-->>c: Response order result

Flow Summary

1. Client sends pickup information and package list.
2. KiriminAja validates sender address and pickup coordinate.
3. If payment_method is credit, KiriminAja validates pin and KA Credit balance.
4. KiriminAja validates destination object, instant courier service, vehicle type, and shipping cost.
5. KiriminAja creates an instant booking with the selected courier.
6. Client receives the order creation result.

Request Payload

Top-Level Payload: Pickup / Sender Details

Package Object

Destination Object

Items Object

Request Body Example

{
  "address": "House of KKK",
  "phone": "628126870021",
  "latitude": -6.229512799999999,
  "longitude": 106.9059138,
  "name": "House of kk",
  "zipcode": "13430",
  "payment_method": "credit",
  "pin": "123456",
  "packages": [
    {
      "order_id": "ADDI-1000000041",
      "destination": {
        "name": "John Doe",
        "phone": "081234567890",
        "latitude": -6.2088,
        "longitude": 106.8456,
        "address": "Jl. Sudirman No. 123, Jakarta Pusat",
        "address_note": "Gedung A Lantai 5"
      },
      "insurance_type": "basic",
      "shipping_cost": 30500,
      "service": "gosend",
      "service_type": "instant",
      "package_type_id": 7,
      "vehicle": "motor",
      "items": [
        {
          "name": "Smartphone",
          "description": "Samsung Galaxy S24 Ultra",
          "price": 5000000,
          "weight": 750
        }
      ]
    }
  ]
}