SureCart – Checkout Confirmed Payload

Tech Articles | May 16, 2025 | Automation, Bubble, Coding, SureCart, Wordpress

In this really short article to accompany a video, I will briefly discuss surecart/checkout_confirmed as an action hook and the payload it can deliver.

This is the main fired hook in Surecart for a purchase, as it is fired every time there is a purchase in the article and the video. We are going to do two things:

Output the checkout payload to our error log
Look through the payload to see if we can match a Price ID

From here, you could add membership levels, trigger a webhook or any number of different solutions.

You can read more about action hooks here in the documentation

Lets log our payload

This is easy, we want to call a function when surecart/checkout_confirmed is triggered and dumps it to our error log.

// Use the correct hook name:
add_action( 'surecart/checkout_confirmed', 'sc_log_checkout_and_check_price', 10, 1 );

function sc_log_checkout_and_check_price( $checkout_payload ) {
    // 1) Log the full payload
    if ( defined( 'WP_DEBUG' ) && WP_DEBUG ) {
        error_log( 'SureCart Checkout Payload: ' . print_r( $checkout_payload, true ) );
    }
}

PHP

This will give us a payload in our error log

That is a full payload, and in that payload, you will see in bold and underlined price] => 5fd6a72e-83de-48dd-95ef-f704124d2b74 This is actually our price ID, and this is what we now want to target.

Lets put it all together

So now we need to look fr our price, id match it and if its there output a message and do the same if its not from here we can expand and add if its there or not there actions such as triggering our webhooks.

<?php
add_action( 'surecart/checkout_confirmed', 'sc_log_checkout_and_check_price', 10, 1 );

function sc_log_checkout_and_check_price( $checkout_payload ) {
    // 1) Log the full payload
    if ( defined( 'WP_DEBUG' ) && WP_DEBUG ) {
        error_log( 'SureCart Checkout Payload: ' . print_r( $checkout_payload, true ) );
    }

    // 2) Set your target Price ID
    $target_price_id = '';

    // 3) Pull out the purchases list:
    $found = false;
    if ( isset( $checkout_payload->purchases )
      && isset( $checkout_payload->purchases->data )
      && is_array( $checkout_payload->purchases->data )
    ) {
        foreach ( $checkout_payload->purchases->data as $purchase ) {
            // Each $purchase is a SureCart\Models\Purchase object
            // It has a 'price' attribute containing the purchased price ID
            if ( isset( $purchase->price )
              && $purchase->price === $target_price_id
            ) {
                $found = true;
                break;
            }
        }
    }

    // 4) Log the result
    if ( $found ) {
        error_log( "Price ID {$target_price_id} was successfully purchased." );
    } else {
        error_log( "Price ID {$target_price_id} was NOT purchased in this checkout." );
    }
}

PHP

when that runs we get the following if we purchase the correct product

Support the Author

Appoligies for any spelling and grammer issue. As a dyslexic i need to rely on tools for this they like me are not perfect but I do try my best