Skip to content

aerni/snipcart-webhooks

master
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
src
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Laravel Snipcart Webhooks

This package makes it super easy to setup and work with Snipcart webhooks in your Laravel application.

Installation

Install the package using Composer.

composer require aerni/snipcart-webhooks

Set your Snipcart Live Secret and Test Secret in your .env. You can find them in your Snipcart Dashboard.

SNIPCART_LIVE_SECRET=********************************
SNIPCART_TEST_SECRET=********************************

You may also publish the config of the package.

php artisan vendor:publish --provider="Aerni\SnipcartWebhooks\SnipcartWebhooksServiceProvider"

The following config will be published to config/snipcart-webhooks.php.

return [

    /*
    |--------------------------------------------------------------------------
    | Snipcart API Keys
    |--------------------------------------------------------------------------
    |
    | Your secret Snipcart API Keys for the Live and Test Environment.
    |
    */

    'live_secret' => env('SNIPCART_LIVE_SECRET'),
    'test_secret' => env('SNIPCART_TEST_SECRET'),

    /*
    |--------------------------------------------------------------------------
    | Test Mode
    |--------------------------------------------------------------------------
    |
    | Set this to 'false' to authenticate using the 'live_secret'.
    | You probably want to do this in production only.
    |
    */

    'test_mode' => env('SNIPCART_TEST_MODE', true),

];

Basic Usage

  1. Register a webhook receiving route
  2. Create Event Listeners or Subscribers to listen for Snipcart Events.

Routing

Go to your Snipcart Dashboard and configure the URL where you want to receive the webhook requests. Register that route in routes/web.php using the provided Route::snipcart macro.

Route::snipcart('webhook-receiving-url');

This will register a POST route to a controller provided by this package. The route will be registered without the VerifyCsrfToken middleware, because Snipcart has no way of getting a csrf-token.

Events & Listeners

Each incoming Snipcart webhook request will trigger its corresponding Laravel Event. Create and register one or more Event Listeners or Subscribers and do your magic.

Overview

Laravel Events Snipcart Events
OrderCompleted order.completed
OrderStatusChanged order.status.changed
OrderPaymentStatusChanged order.paymentStatus.changed
OrderTrackingNumberChanged order.trackingNumber.changed
OrderRefundCreated order.refund.created
OrderNotificationCreated order.notification.created
SubscriptionCreated subscription.created
SubscriptionCancelled subscription.cancelled
SubscriptionPaused subscription.paused
SubscriptionResumed subscription.resumed
SubscriptionInvoiceCreated subscription.invoice.created
InvalidSignature

OrderCompleted

Aerni\SnipcartWebhooks\Events\OrderCompleted

Dispatched whenever a new order is completed.

public function handle(OrderCompleted $payload)
{
    $payload;
}

OrderStatusChanged

Aerni\SnipcartWebhooks\Events\OrderStatusChanged

Dispatched whenever the status of an order changes.

public function handle(OrderStatusChanged $payload)
{
    $payload;
}

OrderPaymentStatusChanged

Aerni\SnipcartWebhooks\Events\OrderPaymentStatusChanged

Dispatched whenever the payment status of an order changes.

public function handle(OrderPaymentStatusChanged $payload)
{
    $payload;
}

OrderTrackingNumberChanged

Aerni\SnipcartWebhooks\Events\OrderTrackingNumberChanged

Dispatched whenever the tracking number of an order changes.

public function handle(OrderTrackingNumberChanged $payload)
{
    $payload;
}

OrderRefundCreated

Aerni\SnipcartWebhooks\Events\OrderRefundCreated

Dispatched whenever an order is refunded.

public function handle(OrderRefundCreated $payload)
{
    $payload;
}

OrderNotificationCreated

Aerni\SnipcartWebhooks\Events\OrderNotificationCreated

Dispatched whenever a notification is added to an order.

public function handle(OrderNotificationCreated $payload)
{
    $payload;
}

SubscriptionCreated

Aerni\SnipcartWebhooks\Events\SubscriptionCreated

Dispatched whenever a new subscription is created.

public function handle(SubscriptionCreated $payload)
{
    $payload;
}

SubscriptionCancelled

Aerni\SnipcartWebhooks\Events\SubscriptionCancelled

Dispatched whenever a subscription is cancelled.

public function handle(SubscriptionCancelled $payload)
{
    $payload;
}

SubscriptionPaused

Aerni\SnipcartWebhooks\Events\SubscriptionPaused

Dispatched whenever a subscription is paused.

public function handle(SubscriptionPaused $payload)
{
    $payload;
}

SubscriptionResumed

Aerni\SnipcartWebhooks\Events\SubscriptionResumed

Dispatched whenever a subscription is resumed.

public function handle(SubscriptionResumed $payload)
{
    $payload;
}

SubscriptionInvoiceCreated

Aerni\SnipcartWebhooks\Events\SubscriptionInvoiceCreated

Dispatched whenever a new invoice is added to an existing subscription.

public function handle(SubscriptionInvoiceCreated $payload)
{
    $payload;
}

InvalidSignature

Aerni\SnipcartWebhooks\Events\InvalidSignature

Dispatched whenever the signature of the webhook request is invalid.

public function handle(InvalidSignature $request)
{
    $request;
}

Tests

Run the tests like this:

vendor/bin/phpunit

About

The easy way to setup and work with Snipcart webhooks in your Laravel application.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages