siewwp/laravel-service-consumer

laravel server-to-server service consumer with HMAC authentication

Laravel hmac http

Server-to-server service consuming with hmac authentication., _(*1)

Installation

composer require siewwp/laravel-service-consumer:dev-master

Usage

Binding your key

Your should bind your app id and secret at your ServiceProvider., _(*2)

Refer to Hmac http client for more information., _(*3)

Refer to Laravel Container for more information., _(*4)

Handling webhook notification

If the service host is notifying event using webhook, you may define your webhook handler in your controller and extend to the webhook controller like so:, _(*5)

<?php

namespace App\Http\Controllers;

use Siewwp\LaravelServiceConsumer\Http\Controllers\Webhook;
use App\Http\Controllers\Controller;

class InvoiceController extends Controller
{
    public function handleInvoicePaid($payload) {
        // ...
    }
}

Or you can use the Siewwp\LaravelServiceConsumer\HandleWebhook trait in your controller, _(*6)

<?php

namespace App\Http\Controllers;

use App\Http\Controllers\Controller;
use Siewwp\LaravelServiceConsumer\HandleWebhook;

class InvoiceController extends Controller
{
    use HandleWebhook;

    public function handleInvoicePaid($payload) {
        // ...
    }
}

The name of the webhook method should be 'handle' + 'CamelCase' of the type of event notification. In the example above, is to handle InvoicePaid type event., _(*7)

Refer to laravel-service-host for more information., _(*8)

After that, you may register the webhook controller it on RouteServiceProvider.php file., _(*9)

<?php
    // ...
    public function boot()
    {
        // ...
        Route::post(
            'tenant/webhook',
            '\App\Http\Controllers\InvoiceController@handleWebhook'
        );
    }
    ...

You can also register it on your web routes but you may need to exclude CSRF middleware, _(*10)

TO DO

TESTING, _(*11)