PHPackages                             shopthru/module-connector - 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. shopthru/module-connector

ActiveMagento2-module[API Development](/categories/api)

shopthru/module-connector
=========================

Shopthru connector for Magento

v1.3-beta5(11mo ago)0785[2 PRs](https://github.com/Shopthru/magento-connector-module/pulls)OSL-3.0PHPPHP &gt;=8.1.0CI failing

Since Jun 19Pushed 1mo ago3 watchersCompare

[ Source](https://github.com/Shopthru/magento-connector-module)[ Packagist](https://packagist.org/packages/shopthru/module-connector)[ RSS](/packages/shopthru-module-connector/feed)WikiDiscussions main Synced yesterday

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

Shopthru Connector for Magento 2
================================

[](#shopthru-connector-for-magento-2)

Overview
--------

[](#overview)

The Shopthru Connector module enables your Magento 2 store to seamlessly integrate with the Shopthru marketplace. This integration allows Shopthru to retrieve your product information and send orders directly to your Magento store, so you can process them alongside your regular orders.

With this connector installed, your products can be sold on the Shopthru marketplace while all order processing, fulfillment, customer communication, and inventory management remains in your familiar Magento admin interface.

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

[](#requirements)

- Magento 2.4.x or higher
- PHP 8.1 or higher
- A Shopthru marketplace account

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

[](#installation)

### Via Composer (Recommended)

[](#via-composer-recommended)

`Composer install is currently not supported.`

1. Open a terminal and navigate to your Magento installation directory
2. Run the following commands:

```
composer require shopthru/module-connector
bin/magento module:enable Shopthru_Connector
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy
bin/magento cache:clean
```

### Manual Installation

[](#manual-installation)

1. Download the module files
2. Create a directory structure in your Magento installation: `app/code/Shopthru/Connector/`
3. Extract the module files to this directory
4. Open a terminal and navigate to your Magento installation directory
5. Run the following commands:

```
bin/magento module:enable Shopthru_Connector
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy
bin/magento cache:clean
```

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

[](#configuration)

After installation, you'll need to configure the module:

1. Log in to your Magento Admin panel
2. Go to **Stores &gt; Configuration &gt; Shopthru &gt; Shopthru Settings**
3. Configure the following options:

### General Configuration

[](#general-configuration)

- **Trigger customer email on import**: When enabled, customers will receive order confirmation emails for orders imported from Shopthru (Default: Yes)
- **Decrement stock on import**: When enabled, product stock will be automatically reduced when orders are imported (Default: Yes)
- **Validate stock is available**: When enabled, the connector will check for available stock before importing an order (Default: No)
- **Link to customer if email matches customer record**: When enabled, orders will be linked to existing customer accounts if the email address matches (Default: No)
- **Automatically invoice orders**: When enabled, orders will be automatically invoiced upon import (Default: Yes)
- **Order status for new orders**: Sets the default status for newly imported orders (Default: Processing)
- **Action for cancelled orders**: Determines the action to take when an order cancellation is received from Shopthru. The options are:
- - Update order status (default): Changes the Magento order's status to the one specified in the "Order status for cancelled orders" setting.
- - Delete order: Completely removes the order from Magento.
- **Order status for cancelled orders**: Sets the status to apply to a Magento order when it is cancelled by Shopthru and the cancellation action is set to "Update order status".
- **Intercept admin API calls**: Enables the experimental feature to enhance the native Magento V1/orders/create API endpoint for Shopthru imports. See the "Experimental: Native API Order Import" section for more details.

Developer Testing
-----------------

[](#developer-testing)

The import process can be tested using the Magento CLI:

```
shopthru:test-order-create
```

Shopthru Payment Method
-----------------------

[](#shopthru-payment-method)

The module installs a special "Shopthru" payment method that is used only for imported orders. This payment method is not visible to customers in your store's checkout but allows proper processing of Shopthru orders.

Viewing Import Logs
-------------------

[](#viewing-import-logs)

The module keeps detailed logs of all orders imported from Shopthru, allowing you to track the progress and troubleshoot any issues:

1. Log in to your Magento Admin panel
2. Go to **Sales &gt; Shopthru &gt; Import Logs**
3. Here you'll see a list of all import attempts with status information

Alternatively, you can view the import logs when viewing an order created from a Shopthru import. The import log will be displayed in the order view page.

The log view provides the following information:

- **Import ID**: Unique identifier for the import attempt
- **Shopthru Order ID**: Original order ID from Shopthru
- **Publisher Ref**: Reference code for the Shopthru publisher
- **Publisher Name**: Name of the Shopthru publisher
- **Status**: Current status of the import (Pending, Success, or Failed)
- **Magento Order #**: The corresponding Magento order number (for successful imports)
- **Imported At**: Date and time when the import was completed
- **Created At**: Date and time when the import was initiated
- **Failed Reason**: If the import failed, displays the reason for failure

You can click on an individual log entry to view detailed information about the import process, including a step-by-step record of events that occurred during the import.

### Clearing Failed Import Logs

[](#clearing-failed-import-logs)

To clear all failed import logs, you can use the following command in the Magento CLI:

```
shopthru:clear-failed-import-logs
```

Experimental: Native API Order Import
-------------------------------------

[](#experimental-native-api-order-import)

Module includes an experimental plugin that enhances the out-of-the-box POST /V1/orders/create endpoint. When activated, this plugin adds critical e-commerce functionalities that are missing from the native API call, such as stock management and post-order processing.

#### Activation:

[](#activation)

To use this feature, you must:

Enable "Intercept admin API calls" in the module's admin configuration.

Include the parameter shopthru\_order=1 in your V1/orders/create API request.

#### Functionality:

[](#functionality)

- Pre-Validation: Checks product stock availability before creating the order.
- Data Completion: Fills in missing order data, such as setting the customer as a guest if they don't exist.
- Post-Creation Processing: After the order is saved, it can automatically:
- - Decrement product stock.
- - Generate and capture an invoice.
- - Send the order confirmation email to the customer.

URL params can be used to override the default admin configuration for a single API call by passing a st\_flags object in your request with boolean values (e.g., "st\_flags": {"decrement\_stock": false, "auto\_invoice": true}).

Support
-------

[](#support)

If you encounter any issues with the Shopthru Connector, please contact your Shopthru account representative or submit a support ticket through your Shopthru account portal.

###  Health Score

35

—

LowBetter than 77% of packages

Maintenance72

Regular maintenance activity

Popularity16

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity37

Early-stage or recently created project

 Bus Factor1

Top contributor holds 61.1% 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 ~8 days

Total

4

Last Release

353d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/e42fe007fbee1aac15dcbed8d32d00ea3528022ca2d5f24a5ddab1719bc698b7?d=identicon)[mark@shopthru.com](/maintainers/mark@shopthru.com)

---

Top Contributors

[![markwallman](https://avatars.githubusercontent.com/u/1089655?v=4)](https://github.com/markwallman "markwallman (33 commits)")[![convenient](https://avatars.githubusercontent.com/u/600190?v=4)](https://github.com/convenient "convenient (21 commits)")

### Embed Badge

![Health badge](/badges/shopthru-module-connector/health.svg)

```
[![Health](https://phpackages.com/badges/shopthru-module-connector/health.svg)](https://phpackages.com/packages/shopthru-module-connector)
```

###  Alternatives

[smile/elasticsuite

Magento 2 merchandising and search engine built on ElasticSearch

8064.7M49](/packages/smile-elasticsuite)[mollie/magento2

Mollie Payment Module for Magento 2

1131.9M16](/packages/mollie-magento2)[graycore/magento2-cors

A Magento 2 module that enables CORS on the GraphQL and REST Apis

102597.4k](/packages/graycore-magento2-cors)[magmodules/magento2-channable

Channable integration for Magento 2

311.5M](/packages/magmodules-magento2-channable)[elgentos/module-prismicio

Magento 2 - Prismic.io integration

39119.0k3](/packages/elgentos-module-prismicio)[zepgram/module-rest

Technical module to industrialize API REST call with dependency injection pattern using Guzzle library

1328.7k](/packages/zepgram-module-rest)

PHPackages © 2026

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