Back

Laravel

The Laravel Shop integration displays customer and order data from a custom Laravel backend directly in the armincx inbox widget. Agents can view orders and trigger actions without leaving the conversation.

When to use this

This integration is suitable for shops that run on a custom Laravel backend rather than a native platform like Shopify. Armincx connects to the shop system via a REST API using Bearer token authentication.

Prerequisites

  • Your backend team has implemented the required API endpoints (GET /customers, GET /orders, and optionally POST /orders/{id}/cancel and POST /orders/{id}/refund)

  • An API token has been created on your side and shared with the armincx team

  • The integration has been configured by armincx and is active in the inbox widget

What the widget shows

Once the integration is active, the inbox widget displays the following when viewing a contact:

Customer lookup

  • Search by email address or phone number

Order details per order

  • Order number and status

  • Line items (product name, variant, quantity)

  • Fulfillment status and tracking URL (if available)

  • Direct link to the order in your admin panel (optional)

Available actions

If write endpoints have been implemented, agents can trigger the following directly from the widget:

  • Cancel order – with optional refund and restock flags

  • Issue refund – without cancelling the order

Notes

  • This integration requires custom API endpoint development on your side.

  • Read access (customer and order data) and write actions (cancel, refund) can be implemented independently — you can start with read-only and add write actions later.

  • Each action includes agent metadata (name and email) so activity can be tracked in your backend.

  • If your system does not track fulfillment status labels, a tracking URL alone is sufficient — armincx will display it as-is.

  • The API rate limit is 120 calls per minute by default.

Was this article helpful?