Download the PHP package blissjaspis/laravel-rajaongkir-komerce without Composer

Laravel RajaOngkir From Komerce

This package provides a simple and easy-to-use Laravel wrapper for the RajaOngkir Komerce API. It supports two methods of address lookup: hierarchical step-by-step selection and direct search with autocomplete functionality.

Requirements

Installation

You can install the package via composer:

You must publish the configuration file with:

Or using the provider:

Add the following to your .env file:

Set RAJAONGKIR_FAKE=true in local development to stub all API responses without calling Komerce.

The package is auto-discovered via Laravel's package discovery. No manual registration is required.

Usage

There are two ways to use Rajaongkir-Komerce:

1. Step-by-step method. This was the old method before Komerce acquired Rajaongkir and changed the API.
2. Direct Search. This is the latest method used by Komerce after they acquired Rajaongkir.

For existing users whose data is still using the old method, you can continue using method 1.

This package supports 2 ways to access RajaOngkir data:

1. Step-by-step location lookup (province -> city -> district -> subdistrict)
2. Direct search and shipping cost lookup (search by keyword, then calculate cost)

You can call the API through the facade or Laravel's service container:

API methods return a RajaOngkirResponse object with meta, data, status(), and successful(). Use getListCourier() when you need the static courier list (hardcoded from Komerce documentation — no API endpoint).

RajaOngkir is registered as a singleton in the service container, so the facade and app() resolve the same instance.

Error handling

Failed HTTP requests and API error responses throw BlissJaspis\RajaOngkir\Exceptions\RajaOngkirException:

Choosing Between Methods

Use Method 1 (Step-by-step) if:

• You have existing user data stored in the hierarchical format
• You prefer structured location selection with multiple dropdowns
• You're migrating from the old Rajaongkir API structure

Use Method 2 (Direct Search) if:

• You're building a new application
• You want a better user experience with search/autocomplete
• You want to simplify your frontend code and reduce API calls
• You want to provide international shipping options

Method 2 is recommended for new implementations as it provides a more modern and user-friendly approach.

Method 1: Step-by-Step Location Lookup

Use this method when users select addresses hierarchically.

1. Finding Provinces

2. Finding Cities

3. Finding Districts

4. Finding Subdistricts

Method 2: Direct Search and Cost Lookup

Use this method when users type destination keywords directly, then you calculate shipping.

1. Searching Domestic Destinations

2. Searching International Destinations

3. Calculating Domestic Shipping Cost

4. Calculating International Shipping Cost

5. Tracking Waybill

Other Useful Methods

getListCourier() returns a static list of supported courier codes and display names (not an API call):

API Reference

For comprehensive API documentation including:

• Complete method signatures with parameter types
• Detailed response structures
• Error handling examples
• Testing examples
• Best practices
• Migration guides
• Troubleshooting

Please see API-REFERENCE.md for detailed technical documentation optimized for developers and AI assistants.

Testing & Quality

This package uses GitHub Actions for continuous integration: lint runs once, then tests run across PHP 8.2–8.5 and Laravel 11–13.

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

For contribution guidelines and local development setup, see CONTRIBUTING.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

• Bliss Jaspis
• All Contributors

License

The MIT License (MIT). Please see License File for more information.