Magento2 Integration

Setting Up the Integration

Prerequisites

Before setting up the integration, ensure you have:

• Admin access to your Magento2 store
• A Cybership account with appropriate permissions
• The Cybership callback and identity URLs (contact support for these)

Creating the Integration in Magento2

1. Access Magento Admin Panel

   • Sign in to your Magento2 admin panel
   • Navigate to System → Extensions → Integrations

2. Create New Integration

   • Click Add New Integration
   • Fill in the integration details:
     • Name: Give your integration a descriptive name (e.g., "Cybership Integration")
     • Contact Email: Enter a valid contact email address
     • Callback URL: Enter the Cybership callback URL (contact support for this endpoint)
     • Identity Link URL: Enter the Cybership identity URL (contact support for this endpoint)

3. Configure API Permissions

   • In the left panel, select API
   • Set Resource Access to either:
     • Custom: Select the permissions required for the integration

   For custom access, select these minimum required permissions:

   Permission Category	Permission
   Sales → Operations	Shipments
   Sales → Operations	Orders
   Catalog	Full catalog access
   Stores → Inventory	Inventory management
   Stores → Settings	All Stores
   Stores → Settings	Order Status

4. Save and Activate

   • Click Save to create the integration
   • Find your new integration in the list and click Activate
   • When prompted, click Allow to grant access
   • You'll be redirected to Cybership to complete the connection

How Synchronization Works

Use the shop's sync actions to import orders and products and inspect the results. Orders in Magento's Holded or Fraud states receive corresponding holds in Cybership; review the source status before releasing work.

Simple and configurable products link to warehouse products. Bundle and grouped products rely on their components. Check component links and source allocation when inventory is missing.

Inventory uses Magento Multi-Source Inventory mappings. Confirm warehouse/source names and assignments before enabling sync. For ship together bundles, keep the components together in the intended warehouse; review Magento's shipping configuration before spreading components across sources.

Shipment and Tracking

Cybership creates the Magento shipment and adds tracking when fulfillment is completed. Verify shipment details first: reverting a Cybership fulfillment does not cancel the existing Magento shipment or replace its tracking.

If an order remains Processing after shipment, check whether its Magento invoice has been created. Shipment and invoicing are separate requirements for completing the order.

Troubleshooting

• Authorization failure: Finish the entire Activate/Reauthorize flow. Starting it again replaces tokens, so an abandoned flow can invalidate the connection.
• Missing inventory: Check product/component links, source mapping, and bundle shipping settings.
• Order held: Resolve the source hold or fraud review, then sync and check the resulting state.
• Callback or identity URL missing: Obtain the correct URLs from Cybership support before activating the integration.

Avoid deleting a working integration merely to retry an incomplete authorization; inspect the error and existing connection first.