PHPackages                             yemenifree/pick-service-api - 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. yemenifree/pick-service-api

ActiveLibrary

yemenifree/pick-service-api
===========================

This API client for pick.sa service. It is an \*\*unofficial\*\*

0.0.4(8y ago)010PHP

Since Nov 27Pushed 8y ago1 watchersCompare

[ Source](https://github.com/salkhwlani/pick-service-api)[ Packagist](https://packagist.org/packages/yemenifree/pick-service-api)[ RSS](/packages/yemenifree-pick-service-api/feed)WikiDiscussions master Synced today

READMEChangelogDependencies (3)Versions (5)Used By (0)

Pick.sa API client for PHP.
===========================

[](#picksa-api-client-for-php)

[![Software License](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE.md)[![Build Status](https://camo.githubusercontent.com/408aa0def95748529f919232ce6af607dd8cf37986897c0c970e3296e423ddab/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f79656d656e69667265652f7069636b2d736572766963652d6170692f6261646765732f6275696c642e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/yemenifree/pick-service-api/build-status/maste)[![Quality Score](https://camo.githubusercontent.com/9d19d4d56c18ee9085bbea2ce9a250be4a714fe2d16607f0baf33e4afa1d884f/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f79656d656e69667265652f7069636b2d736572766963652d6170692f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/yemenifree/pick-service-api/code-structure)

####  This is a community project and not an official one

[](#-this-is-a-community-project-and-not-an-official-one-)

> This API client for [pick.sa](https://pick.sa) service. It is an **unofficial**

Requirements & Installation
-------------------------------

[](#requirements--installation)

> Requires PHP 7.0+

Via Composer

```
$ composer require yemenifree/pick-service-api
```

Getting Started
---------------

[](#getting-started)

Setup api service.

```
$service = new PickService('Live Token');
```

You can enable sandbox env via pass true in second parameter.

```
$sandBoxService = new PickService('Sandbox Token', true);
```

Create new request.
-------------------

[](#create-new-request)

You can create new request simply via

```
$result = $service->request('service', 'action', ...$arg);
```

Check response
--------------

[](#check-response)

To check result of response use `isSeccess()` method.

```
// check if request seccess.
if (!$result->isSuccess()) {
    // there are error
    $error = $result->json();
}

// All right.
$invoice = $result->json();
```

Orders.
-------

[](#orders)

### create Order

[](#create-order)

```
// create Order
$order = new Order();
// set up order info.
$order->setItems(Order::ITEM_HOUSEHOLD)
    ->setPrice(200)
    ->setPickupTime(Carbon::now()->addDays(1))
    ->setPaymentType(Order::PAYMENT_PRE_PAID)
    ->setPickupLocation(24.697168165551115, 46.70957565307617)
    ->setReceiverName('Salah Alkhwlani')
    ->setReceiverPhone('966500484350');

// send create request.
$result = $service->request('orders', 'create', $order);

// check if request seccess.
if (!$result->isSuccess()) {
    $error = $result->json();
}

// All right.
$invoice = $result->json();
```

### Delete Order.

[](#delete-order)

```
$orderID = 1;
$result = $service->request('orders', 'delete', $orderID);
```

### View Order.

[](#view-order)

```
$orderID = 1;
$result = $service->request('orders', 'view', $orderID);
```

### Search in orders.

[](#search-in-orders)

```
$query = 'keyword';
$order = '';
$result = $service->request('orders', 'search', $query, $order);
```

### Edit Order.

[](#edit-order)

```
$orderID = 1;
$orderModel = new Order();
// set up new order info.
$orderModel->setItems(Order::ITEM_HOUSEHOLD)
    ->setPrice(210)
    ->setPickupTime(Carbon::now()->addDays(1))
    ->setPaymentType(Order::PAYMENT_PRE_PAID)
    ->setPickupLocation(24.697168165551115, 46.70957565307617)
    ->setReceiverName('Salah Alkhwlani')
    ->setReceiverPhone('966500484350');

$result = $service->request('orders', 'edit', $orderID, $orderModel);
```

### Cancel order.

[](#cancel-order)

```
$result = $service->request('orders', 'cancel', $orderID,$orderModel);
```

TODO
----

[](#todo)

- Implement other services.
- Add service provider & config for Laravel.
- Write test unit.

Change log
----------

[](#change-log)

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING](CONTRIBUTING.md) for details.

Security
--------

[](#security)

If you discover any security related issues, please email  instead of using the issue tracker.

Credits
-------

[](#credits)

- [Salah Alkhwlani](https://github.com/yemenifree)
- [All Contributors](../../contributors)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

24

—

LowBetter than 32% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity5

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity56

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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

Every ~0 days

Total

4

Last Release

3086d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/60036767b6c53b6c4266f7b46348b93b505cf278203df5d7c06d5f7661d1fcc3?d=identicon)[salahalkhwlani](/maintainers/salahalkhwlani)

---

Top Contributors

[![salkhwlani](https://avatars.githubusercontent.com/u/10876587?v=4)](https://github.com/salkhwlani "salkhwlani (18 commits)")

---

Tags

opencartpicksawoocommerce

### Embed Badge

![Health badge](/badges/yemenifree-pick-service-api/health.svg)

```
[![Health](https://phpackages.com/badges/yemenifree-pick-service-api/health.svg)](https://phpackages.com/packages/yemenifree-pick-service-api)
```

###  Alternatives

[tymon/jwt-auth

JSON Web Token Authentication for Laravel and Lumen

11.5k49.1M350](/packages/tymon-jwt-auth)[bagisto/bagisto

Bagisto Laravel E-Commerce

26.2k161.6k7](/packages/bagisto-bagisto)[spatie/laravel-sitemap

Create and generate sitemaps with ease

2.6k14.6M107](/packages/spatie-laravel-sitemap)[statamic/cms

The Statamic CMS Core Package

4.8k3.2M720](/packages/statamic-cms)[team-reflex/discord-php

An unofficial API to interact with the voice and text service Discord.

1.1k379.4k24](/packages/team-reflex-discord-php)[temporal/sdk

Temporal SDK

4002.2M18](/packages/temporal-sdk)

PHPackages © 2026

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