Integrating an Ecommerce

The host application sends catalog data and consumes signals. Final price application stays outside this package.

Route::post('/webhooks/price-intel', function (Request $request) {
    abort_unless(WebhookSigner::verify(
        $request->getContent(),
        config('services.pi.secret'),
        $request->header(WebhookSigner::HEADER, '')
    ), 401);

    match ($request->input('event')) {
        'price.dropped', 'undercut.detected' => MarginOS::reevaluate($request->input('data')),
        default => null,
    };
});

Common Flow

1. Issue an API key.
2. Bulk upsert products by external_id.
3. Create monitoring targets by country.
4. Let discovery find URLs or pass given_urls.
5. Review borderline matches.
6. Process signed webhook deliveries.