Webhook routy

Pribalená webhook routa je predvolene vypnutá a zapne ju len výslovná hodnota on: nenastavený prepínač (chýba v čiastočne publikovanom poli routes, je null, prázdny alebo premenná env nie je nastavená) ju nechá vypnutú — do verzie 1.1.8 ju takýto prepínač načítal. Po zapnutí balík zaregistruje POST {prefix}/webhooks/{provider} (názov routy purchases.webhooks), ktorá overí, uloží, spustí udalosti a vráti 204 No Content:

PURCHASES_ROUTES_ENABLED=true
PURCHASES_ROUTES_PREFIX=purchases

• 204 — overené a uložené (alebo zaradené do fronty), prípadne len zaznamenané do auditu — informatívna notifikácia, RTDN z Google pre inú aplikáciu.
• 400 — overenie podpisu alebo prístupových údajov zlyhalo, push z Google nebol autentifikovaný, požiadavka od Apple neniesla signedPayload ako reťazec alebo RTDN z Google uviedla token . či ..
• 404 — pod týmto identifikátorom nie je zaregistrovaný žiadny poskytovateľ.
• 500 — čítanie z obchodu počas overenia zlyhalo (čítanie predplatného Google s akoukoľvek chybou okrem 410, vyhľadanie v Invoice Payments API v Stripe) alebo obchod nebol dostupný. Obchod notifikáciu doručí znova.

Serverové notifikácie každého obchodu nasmerujte na jeho URL:

POST https://your-app.test/purchases/webhooks/apple
POST https://your-app.test/purchases/webhooks/google
POST https://your-app.test/purchases/webhooks/stripe

Routa prijíma len podpísané udalosti obchodov. Nákupný token Google alebo presmerovanie zo Stripe od klienta overte vo vlastnej route cez callback() — pozrite Callbacky z klienta.

Úprava routy

Routu tvarujú routes.prefix a routes.middleware; predvolená skupina api nemá CSRF kontrolu. Ak chcete plnú kontrolu, publikujte súbor rout tagom purchases-routes alebo volajte Purchases::handle() z vlastného controllera — pozrite sekciu Fasáda Purchases:

// config/purchases.php
'routes' => [
    'enabled' => env('PURCHASES_ROUTES_ENABLED', false),
    'prefix' => env('PURCHASES_ROUTES_PREFIX', 'purchases'),
    'middleware' => ['api'],
],