---
title: SureCart &amp; Shipping label now possible
date: 2025-05-04T07:02:00Z
modified: 2025-05-04T19:58:51Z
permalink: "https://techarticles.co.uk/surecart-shipping-label-now-possible/"
type: post
status: publish
excerpt: ""
wpid: 4828
categories:
  - Automation
  - Coding
  - Plugins
  - SureCart
  - Wordpress
timestamp: 2025-05-04T19:58:51Z
tags:
  - Automation
  - Coding
  - Plugins
  - SureCart
  - Wordpress
---

There have been some stellar improvements to [SureCart](https://ta0.uk/surecart) recently, and one of those is that now included in the payload are all the details you need to begin to automate shipping. The quantities and weights are now passed within the payload correctly, and finally give you enough details to begin looking at automation.

While I haven’t currently got a use case for a physical SureCart store, I did want to look at how this could be automated and the data feed into my automator of choice, [FlowMattic](https://ta0.uk/flowmattic), and this is what I was able to achieve quite simply and easily.

Now Flowmattic is capable of doing this with its own native integration, but I’d need to filter the details, so I decided to build a small script to grab the details on checkout confirmed and add an action hook for flowmattic to listen to.

```
<span class="line"></span>
<span class="line"><span style="color: #6A737D">// 1) Hook into SureCart checkout confirmed</span></span>
<span class="line"><span style="color: #B392F0">add_action</span><span style="color: #E1E4E8">( </span><span style="color: #9ECBFF">'surecart/checkout_confirmed'</span><span style="color: #E1E4E8">, </span><span style="color: #9ECBFF">'sc_send_flowmattic_payload'</span><span style="color: #E1E4E8">, </span><span style="color: #79B8FF">10</span><span style="color: #E1E4E8">, </span><span style="color: #79B8FF">1</span><span style="color: #E1E4E8"> );</span></span>
<span class="line"></span>
<span class="line"><span style="color: #F97583">function</span><span style="color: #E1E4E8"> </span><span style="color: #B392F0">sc_send_flowmattic_payload</span><span style="color: #E1E4E8">( </span><span style="color: #79B8FF">\SureCart\Models\Checkout</span><span style="color: #E1E4E8"> $checkout ) {</span></span>
<span class="line"><span style="color: #E1E4E8">    </span><span style="color: #6A737D">// 2) Extract customer</span></span>
<span class="line"><span style="color: #E1E4E8">    $customer_name  </span><span style="color: #F97583">=</span><span style="color: #E1E4E8"> </span><span style="color: #79B8FF">trim</span><span style="color: #E1E4E8">( $checkout</span><span style="color: #F97583">-></span><span style="color: #E1E4E8">first_name </span><span style="color: #F97583">.</span><span style="color: #E1E4E8"> </span><span style="color: #9ECBFF">' '</span><span style="color: #E1E4E8"> </span><span style="color: #F97583">.</span><span style="color: #E1E4E8"> $checkout</span><span style="color: #F97583">-></span><span style="color: #E1E4E8">last_name );</span></span>
<span class="line"><span style="color: #E1E4E8">    $customer_email </span><span style="color: #F97583">=</span><span style="color: #E1E4E8"> $checkout</span><span style="color: #F97583">-></span><span style="color: #E1E4E8">email;</span></span>
<span class="line"><span style="color: #E1E4E8">    $customer_phone </span><span style="color: #F97583">=</span><span style="color: #E1E4E8"> $checkout</span><span style="color: #F97583">-></span><span style="color: #E1E4E8">phone;</span></span>
<span class="line"></span>
<span class="line"><span style="color: #E1E4E8">    </span><span style="color: #6A737D">// 3) Extract shipping address (may be null)</span></span>
<span class="line"><span style="color: #E1E4E8">    $sa </span><span style="color: #F97583">=</span><span style="color: #E1E4E8"> $checkout</span><span style="color: #F97583">-></span><span style="color: #E1E4E8">shipping_address </span><span style="color: #F97583">?:</span><span style="color: #E1E4E8"> </span><span style="color: #F97583">new</span><span style="color: #E1E4E8"> </span><span style="color: #79B8FF">stdClass</span><span style="color: #E1E4E8">();</span></span>
<span class="line"></span>
<span class="line"><span style="color: #E1E4E8">    </span><span style="color: #6A737D">// 4) Build items loop</span></span>
<span class="line"><span style="color: #E1E4E8">    $items </span><span style="color: #F97583">=</span><span style="color: #E1E4E8"> [];</span></span>
<span class="line"><span style="color: #E1E4E8">    </span><span style="color: #F97583">foreach</span><span style="color: #E1E4E8"> ( $checkout</span><span style="color: #F97583">-></span><span style="color: #E1E4E8">line_items</span><span style="color: #F97583">-></span><span style="color: #E1E4E8">data </span><span style="color: #F97583">as</span><span style="color: #E1E4E8"> $item ) {</span></span>
<span class="line"><span style="color: #E1E4E8">        $unfulfilled  </span><span style="color: #F97583">=</span><span style="color: #E1E4E8"> $item</span><span style="color: #F97583">-></span><span style="color: #E1E4E8">quantity </span><span style="color: #F97583">-</span><span style="color: #E1E4E8"> $item</span><span style="color: #F97583">-></span><span style="color: #E1E4E8">fulfilled_quantity;</span></span>
<span class="line"><span style="color: #E1E4E8">        $weight_unit  </span><span style="color: #F97583">=</span><span style="color: #E1E4E8"> $item</span><span style="color: #F97583">-></span><span style="color: #E1E4E8">price</span><span style="color: #F97583">-></span><span style="color: #E1E4E8">product</span><span style="color: #F97583">-></span><span style="color: #E1E4E8">weight_unit </span><span style="color: #F97583">??</span><span style="color: #E1E4E8"> </span><span style="color: #9ECBFF">''</span><span style="color: #E1E4E8">;</span></span>
<span class="line"><span style="color: #E1E4E8">        $items[] </span><span style="color: #F97583">=</span><span style="color: #E1E4E8"> [</span></span>
<span class="line"><span style="color: #E1E4E8">            </span><span style="color: #9ECBFF">'title'</span><span style="color: #E1E4E8">           </span><span style="color: #F97583">=></span><span style="color: #E1E4E8"> $item</span><span style="color: #F97583">-></span><span style="color: #E1E4E8">price</span><span style="color: #F97583">-></span><span style="color: #E1E4E8">product</span><span style="color: #F97583">-></span><span style="color: #E1E4E8">name,</span></span>
<span class="line"><span style="color: #E1E4E8">            </span><span style="color: #9ECBFF">'options'</span><span style="color: #E1E4E8">         </span><span style="color: #F97583">=></span><span style="color: #E1E4E8"> $item</span><span style="color: #F97583">-></span><span style="color: #E1E4E8">variant_option_names </span><span style="color: #F97583">?:</span><span style="color: #E1E4E8"> [],</span></span>
<span class="line"><span style="color: #E1E4E8">            </span><span style="color: #9ECBFF">'sku'</span><span style="color: #E1E4E8">             </span><span style="color: #F97583">=></span><span style="color: #E1E4E8"> $item</span><span style="color: #F97583">-></span><span style="color: #E1E4E8">price</span><span style="color: #F97583">-></span><span style="color: #E1E4E8">product</span><span style="color: #F97583">-></span><span style="color: #E1E4E8">sku </span><span style="color: #F97583">??</span><span style="color: #E1E4E8"> </span><span style="color: #9ECBFF">''</span><span style="color: #E1E4E8">,</span></span>
<span class="line"><span style="color: #E1E4E8">            </span><span style="color: #9ECBFF">'unfulfilled_qty'</span><span style="color: #E1E4E8"> </span><span style="color: #F97583">=></span><span style="color: #E1E4E8"> $unfulfilled,</span></span>
<span class="line"><span style="color: #E1E4E8">            </span><span style="color: #9ECBFF">'weight'</span><span style="color: #E1E4E8">          </span><span style="color: #F97583">=></span><span style="color: #E1E4E8"> $item</span><span style="color: #F97583">-></span><span style="color: #E1E4E8">unit_g_weight,</span></span>
<span class="line"><span style="color: #E1E4E8">            </span><span style="color: #9ECBFF">'weight_unit'</span><span style="color: #E1E4E8">     </span><span style="color: #F97583">=></span><span style="color: #E1E4E8"> $weight_unit,</span></span>
<span class="line"><span style="color: #E1E4E8">            </span><span style="color: #9ECBFF">'amount'</span><span style="color: #E1E4E8">          </span><span style="color: #F97583">=></span><span style="color: #E1E4E8"> $item</span><span style="color: #F97583">-></span><span style="color: #E1E4E8">total_amount,</span></span>
<span class="line"><span style="color: #E1E4E8">        ];</span></span>
<span class="line"><span style="color: #E1E4E8">    }</span></span>
<span class="line"></span>
<span class="line"><span style="color: #E1E4E8">    </span><span style="color: #6A737D">// 5) Order-level data</span></span>
<span class="line"><span style="color: #E1E4E8">    $shipping_method    </span><span style="color: #F97583">=</span><span style="color: #E1E4E8"> $checkout</span><span style="color: #F97583">-></span><span style="color: #E1E4E8">selected_shipping_choice;</span></span>
<span class="line"><span style="color: #E1E4E8">    $shipping_amount    </span><span style="color: #F97583">=</span><span style="color: #E1E4E8"> $checkout</span><span style="color: #F97583">-></span><span style="color: #E1E4E8">shipping_amount;</span></span>
<span class="line"><span style="color: #E1E4E8">    $order_total_amount </span><span style="color: #F97583">=</span><span style="color: #E1E4E8"> $checkout</span><span style="color: #F97583">-></span><span style="color: #E1E4E8">total_amount;</span></span>
<span class="line"><span style="color: #E1E4E8">    $order_currency     </span><span style="color: #F97583">=</span><span style="color: #E1E4E8"> $checkout</span><span style="color: #F97583">-></span><span style="color: #E1E4E8">currency;</span></span>
<span class="line"></span>
<span class="line"><span style="color: #E1E4E8">    </span><span style="color: #6A737D">// 6) Assemble payload, include custom_id for Flowmattic metadata</span></span>
<span class="line"><span style="color: #E1E4E8">    $payload </span><span style="color: #F97583">=</span><span style="color: #E1E4E8"> [</span></span>
<span class="line"><span style="color: #E1E4E8">        </span><span style="color: #9ECBFF">'custom_id'</span><span style="color: #E1E4E8">        </span><span style="color: #F97583">=></span><span style="color: #E1E4E8"> $checkout</span><span style="color: #F97583">-></span><span style="color: #E1E4E8">id,          </span><span style="color: #6A737D">// unique identifier</span></span>
<span class="line"><span style="color: #E1E4E8">        </span><span style="color: #9ECBFF">'name'</span><span style="color: #E1E4E8">             </span><span style="color: #F97583">=></span><span style="color: #E1E4E8"> $customer_name,</span></span>
<span class="line"><span style="color: #E1E4E8">        </span><span style="color: #9ECBFF">'email'</span><span style="color: #E1E4E8">            </span><span style="color: #F97583">=></span><span style="color: #E1E4E8"> $customer_email,</span></span>
<span class="line"><span style="color: #E1E4E8">        </span><span style="color: #9ECBFF">'phone'</span><span style="color: #E1E4E8">            </span><span style="color: #F97583">=></span><span style="color: #E1E4E8"> $customer_phone,</span></span>
<span class="line"><span style="color: #E1E4E8">        </span><span style="color: #9ECBFF">'street_line_1'</span><span style="color: #E1E4E8">    </span><span style="color: #F97583">=></span><span style="color: #E1E4E8"> $sa</span><span style="color: #F97583">-></span><span style="color: #E1E4E8">line_1    </span><span style="color: #F97583">??</span><span style="color: #E1E4E8"> </span><span style="color: #9ECBFF">''</span><span style="color: #E1E4E8">,</span></span>
<span class="line"><span style="color: #E1E4E8">        </span><span style="color: #9ECBFF">'street_line_2'</span><span style="color: #E1E4E8">    </span><span style="color: #F97583">=></span><span style="color: #E1E4E8"> $sa</span><span style="color: #F97583">-></span><span style="color: #E1E4E8">line_2    </span><span style="color: #F97583">??</span><span style="color: #E1E4E8"> </span><span style="color: #9ECBFF">''</span><span style="color: #E1E4E8">,</span></span>
<span class="line"><span style="color: #E1E4E8">        </span><span style="color: #9ECBFF">'city'</span><span style="color: #E1E4E8">             </span><span style="color: #F97583">=></span><span style="color: #E1E4E8"> $sa</span><span style="color: #F97583">-></span><span style="color: #E1E4E8">city      </span><span style="color: #F97583">??</span><span style="color: #E1E4E8"> </span><span style="color: #9ECBFF">''</span><span style="color: #E1E4E8">,</span></span>
<span class="line"><span style="color: #E1E4E8">        </span><span style="color: #9ECBFF">'state'</span><span style="color: #E1E4E8">            </span><span style="color: #F97583">=></span><span style="color: #E1E4E8"> $sa</span><span style="color: #F97583">-></span><span style="color: #E1E4E8">state     </span><span style="color: #F97583">??</span><span style="color: #E1E4E8"> </span><span style="color: #9ECBFF">''</span><span style="color: #E1E4E8">,</span></span>
<span class="line"><span style="color: #E1E4E8">        </span><span style="color: #9ECBFF">'postal_code'</span><span style="color: #E1E4E8">      </span><span style="color: #F97583">=></span><span style="color: #E1E4E8"> $sa</span><span style="color: #F97583">-></span><span style="color: #E1E4E8">postal_code </span><span style="color: #F97583">??</span><span style="color: #E1E4E8"> </span><span style="color: #9ECBFF">''</span><span style="color: #E1E4E8">,</span></span>
<span class="line"><span style="color: #E1E4E8">        </span><span style="color: #9ECBFF">'country'</span><span style="color: #E1E4E8">          </span><span style="color: #F97583">=></span><span style="color: #E1E4E8"> $sa</span><span style="color: #F97583">-></span><span style="color: #E1E4E8">country   </span><span style="color: #F97583">??</span><span style="color: #E1E4E8"> </span><span style="color: #9ECBFF">''</span><span style="color: #E1E4E8">,</span></span>
<span class="line"><span style="color: #E1E4E8">        </span><span style="color: #9ECBFF">'items'</span><span style="color: #E1E4E8">            </span><span style="color: #F97583">=></span><span style="color: #E1E4E8"> $items,</span></span>
<span class="line"><span style="color: #E1E4E8">        </span><span style="color: #9ECBFF">'shipping_method'</span><span style="color: #E1E4E8">  </span><span style="color: #F97583">=></span><span style="color: #E1E4E8"> $shipping_method,</span></span>
<span class="line"><span style="color: #E1E4E8">        </span><span style="color: #9ECBFF">'shipping_amount'</span><span style="color: #E1E4E8">  </span><span style="color: #F97583">=></span><span style="color: #E1E4E8"> $shipping_amount,</span></span>
<span class="line"><span style="color: #E1E4E8">        </span><span style="color: #9ECBFF">'total_amount'</span><span style="color: #E1E4E8">     </span><span style="color: #F97583">=></span><span style="color: #E1E4E8"> $order_total_amount,</span></span>
<span class="line"><span style="color: #E1E4E8">        </span><span style="color: #9ECBFF">'currency'</span><span style="color: #E1E4E8">         </span><span style="color: #F97583">=></span><span style="color: #E1E4E8"> $order_currency,</span></span>
<span class="line"><span style="color: #E1E4E8">    ];</span></span>
<span class="line"></span>
<span class="line"><span style="color: #E1E4E8">    </span><span style="color: #6A737D">// 7) Fire a custom action for Flowmattic to catch</span></span>
<span class="line"><span style="color: #E1E4E8">    </span><span style="color: #B392F0">do_action</span><span style="color: #E1E4E8">( </span><span style="color: #9ECBFF">'flowmattic_surecart_checkout_confirmed'</span><span style="color: #E1E4E8">, $payload );</span></span>
<span class="line"><span style="color: #E1E4E8">}</span></span>
<span class="line"></span>
```PHP

Using this script, we get a nice product list and receive data in FlowMattic as shown below

![Interface capturing shipping details with fields like name, email, address, and order specifics.](https://techarticles.co.uk/wp-content/uploads/2025/05/SureCart-Flowmattic-Capture-Shipping-Details.png)

With the outgoing API module, it is now totally possible to generate shipping labels for sales made in SureCart using FlowMattic