PHPackages                             dropday-io/laravel - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. dropday-io/laravel

ActiveLibrary[API Development](/categories/api)

dropday-io/laravel
==================

Laravel integration for Dropday dropshipping fulfillment.

v1.0.0(1mo ago)00MITPHPPHP ^8.1

Since May 6Pushed 1mo agoCompare

[ Source](https://github.com/dropday-io/laravel)[ Packagist](https://packagist.org/packages/dropday-io/laravel)[ Docs](https://github.com/dropday-io/laravel)[ RSS](/packages/dropday-io-laravel/feed)WikiDiscussions main Synced 1w ago

READMEChangelog (1)Dependencies (4)Versions (2)Used By (0)

Dropday for Laravel
===================

[](#dropday-for-laravel)

[![Latest Version on Packagist](https://camo.githubusercontent.com/56497afa163dcfad068e57c1346357ea4f93818f3f25b9334332c307d4d3501b/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f64726f706461792d696f2f6c61726176656c2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/dropday-io/laravel)[![License](https://camo.githubusercontent.com/688ff3d2bde8609aa047b58b6982167e9ff9f4222cdaabfa96c659488d302c42/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f64726f706461792d696f2f6c61726176656c2e7376673f7374796c653d666c61742d737175617265)](LICENSE)

Official Laravel package for the [Dropday](https://dropday.io) API — [GitHub](https://github.com/dropday-io/laravel) · [API docs](https://docs.dropday.io)

Send orders to dropshipping suppliers and track fulfillment status from your Laravel application.

**Dropday** is an order automation platform that connects your store to dropshipping suppliers. You push an order through the API; Dropday routes it to the right supplier, handles the fulfillment flow, and keeps you updated on the status.

Requirements
------------

[](#requirements)

- PHP 8.1+
- Laravel 10, 11, or 12

Installation
------------

[](#installation)

```
composer require dropday-io/laravel
```

The service provider and `Dropday` facade are registered automatically via Laravel's package auto-discovery.

Publish the config file:

```
php artisan vendor:publish --provider="Dropday\Dropday\DropdayServiceProvider"
```

Configuration
-------------

[](#configuration)

Add your credentials to `.env`:

```
DROPDAY_API_KEY=your-api-key
DROPDAY_ACCOUNT_ID=your-account-id
```

Both values are available in your [Dropday account settings](https://dropday.io). If you don't have an account yet, [sign up at dropday.io](https://dropday.io).

The config also exposes `DROPDAY_BASE_URL` if you need to point at a staging endpoint.

Usage
-----

[](#usage)

You can use the facade or dependency injection.

### Facade

[](#facade)

```
use Dropday\Dropday\Facades\Dropday;

$order = Dropday::createOrder([
    'external_id' => 'your-internal-order-id',
    'shipping_address' => [
        'first_name' => 'Jane',
        'last_name'  => 'Doe',
        'address1'   => '123 Main St',
        'city'       => 'Amsterdam',
        'country'    => 'NL',
        'postcode'   => '1234AB',
    ],
    'products' => [
        ['sku' => 'PROD-001', 'quantity' => 1],
    ],
]);
```

### Dependency injection

[](#dependency-injection)

```
use Dropday\Dropday\Dropday;

class OrderController extends Controller
{
    public function __construct(protected Dropday $dropday) {}

    public function store(Request $request): JsonResponse
    {
        $result = $this->dropday->createOrder($request->validated());

        return response()->json($result);
    }
}
```

Available methods
-----------------

[](#available-methods)

```
// Submit a new order for fulfillment
Dropday::createOrder(array $data): array

// List orders, optionally filtered
Dropday::getOrders(array $filters = []): array

// Retrieve a single order by its Dropday reference ID
Dropday::getOrder(string $reference): array
```

**Filter keys for `getOrders`:** `statuses`, `per_page`, `page`, `date_from`, `date_to`, `external_id`, `source`.

**Duplicate orders:** if you submit an order with an `external_id` that already exists, Dropday returns HTTP 200 with `"Order already exists"` in the `message` key rather than an error.

For full request/response shapes, see the [Dropday API docs](https://docs.dropday.io).

Test mode
---------

[](#test-mode)

Pass `"test" => true` in any order payload during development. Dropday will process the order through the full validation flow but skip actual supplier routing.

```
Dropday::createOrder([
    'external_id' => 'test-order-001',
    'test'        => true,
    // ...
]);
```

Error handling
--------------

[](#error-handling)

SituationBehaviourValidation failure (422)Throws `Dropday\Dropday\Exceptions\DropdayException`Any other HTTP errorThrows `Illuminate\Http\Client\RequestException`Duplicate `external_id`Returns 200; check `$result['message']````
use Dropday\Dropday\Exceptions\DropdayException;
use Illuminate\Http\Client\RequestException;

try {
    $order = Dropday::createOrder($data);
} catch (DropdayException $e) {
    // HTTP 422 — validation error
} catch (RequestException $e) {
    // Network or server error
}
```

Testing
-------

[](#testing)

Use Laravel's `Http::fake()` to mock Dropday responses without hitting the real API:

```
use Illuminate\Support\Facades\Http;

Http::fake([
    '*/orders' => Http::response(['id' => 'ORD-1', 'status' => 'pending'], 200),
]);

$result = Dropday::createOrder(['external_id' => 'test-1', 'test' => true]);

expect($result['status'])->toBe('pending');
```

Get started with Dropday
------------------------

[](#get-started-with-dropday)

1. [Create a Dropday account](https://dropday.io)
2. Copy your API key and account ID from the account settings
3. Add them to your `.env` and start sending orders

Browse the full [API reference](https://docs.dropday.io) for available fields, order statuses, and webhook events.

Changelog
---------

[](#changelog)

See [CHANGELOG.md](CHANGELOG.md) for a full history of changes.

License
-------

[](#license)

MIT

###  Health Score

37

—

LowBetter than 81% of packages

Maintenance93

Actively maintained with recent releases

Popularity0

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity42

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 50% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

34d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/582704b9d892865e0183da7a739eb4fefec7fd99f26185ef8ec0e3421e8317da?d=identicon)[muyncky](/maintainers/muyncky)

![](https://www.gravatar.com/avatar/19f2a0805559ae5d0be007e428fe29f03f063d3f7c34519ff3ec4030e1882d0b?d=identicon)[dropday-io](/maintainers/dropday-io)

---

Top Contributors

[![dropday-io](https://avatars.githubusercontent.com/u/75685814?v=4)](https://github.com/dropday-io "dropday-io (1 commits)")[![muyncky](https://avatars.githubusercontent.com/u/17008327?v=4)](https://github.com/muyncky "muyncky (1 commits)")

---

Tags

apilaravelecommercefulfillmentDropshippingdropday

###  Code Quality

TestsPest

### Embed Badge

![Health badge](/badges/dropday-io-laravel/health.svg)

```
[![Health](https://phpackages.com/badges/dropday-io-laravel/health.svg)](https://phpackages.com/packages/dropday-io-laravel)
```

###  Alternatives

[psalm/plugin-laravel

Psalm plugin for Laravel

3325.1M337](/packages/psalm-plugin-laravel)[defstudio/telegraph

A laravel facade to interact with Telegram Bots

815320.5k3](/packages/defstudio-telegraph)[resend/resend-laravel

Resend for Laravel

1212.2M8](/packages/resend-resend-laravel)[essa/api-tool-kit

set of tools to build an api with laravel

53286.5k](/packages/essa-api-tool-kit)[api-platform/laravel

API Platform support for Laravel

59156.3k10](/packages/api-platform-laravel)[simplestats-io/laravel-client

Analytics for Laravel. Track visitors, registrations, and payments. Discover which channels actually drive revenue, not just traffic. Server-side, GDPR compliant, ad-blocker proof.

5019.3k](/packages/simplestats-io-laravel-client)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
