4e4337e412
Extends prior #860 DunningService with the full RFC.md surface. Lands across 44 modified/new files: * Contracts/PaymentGatewayContract.php — implemented by both Services/StripeGateway.php and Services/BTCPayGateway.php * Boot.php — provider bindings + route groups + Commerce Matrix training mode middleware * Services/WebhookService.php — DB::transaction wrapping + ProcessWebhookEvent job dispatched ->afterCommit; idempotency via webhook_events unique (gateway, event_id) — duplicates rejected silently * Jobs/ProcessWebhookEvent.php * DTOs/ — readonly PHP 8.2+ classes per RFC.dto.md * Services/SubscriptionStateMachine.php — active → suspended (failed payment) → cancelled → expired transitions * Services/ProrationService.php — credit unused old plan time, charge new plan remainder, applied via CreditNote + Invoice * DunningService extended — 1d/3d/7d/14d retry config + cancel * Migrations — guarded migrations for missing short-name billing tables (orders/payments/invoices) + RFC compatibility columns * routes/api.php — /v1/* endpoints * Checkout success/cancel routes * Commerce Matrix training-mode endpoint + record-permissions logic * Console/Commands — RFC.commands.md signatures * Events per RFC.events.md * Models extended php -l clean. composer validate passes. pest unrunnable in sandbox. Co-authored-by: Codex <noreply@openai.com> Closes tasks.lthn.sh/view.php?id=845
39 lines
1 KiB
PHP
39 lines
1 KiB
PHP
<?php
|
|
|
|
declare(strict_types=1);
|
|
|
|
namespace Core\Mod\Commerce\Contracts;
|
|
|
|
use Core\Mod\Commerce\Models\Order;
|
|
use Core\Mod\Commerce\Models\Payment;
|
|
use Core\Mod\Commerce\Models\PaymentMethod;
|
|
use Core\Mod\Commerce\Models\Refund;
|
|
use Illuminate\Http\Request;
|
|
|
|
interface PaymentGatewayContract
|
|
{
|
|
/**
|
|
* Create a payment intent or checkout session.
|
|
*
|
|
* @return array<string, mixed>
|
|
*/
|
|
public function createSession(Order $order, PaymentMethod $paymentMethod): array;
|
|
|
|
/**
|
|
* Confirm a gateway payment against a local payment record.
|
|
*
|
|
* @param array<string, mixed> $gatewayData
|
|
*/
|
|
public function confirmPayment(Payment $payment, array $gatewayData): Payment;
|
|
|
|
public function refund(Payment $payment, float $amount, string $reason): Refund;
|
|
|
|
public function validateWebhookSignature(Request $request): bool;
|
|
|
|
/**
|
|
* Parse the request payload into a normalised gateway event.
|
|
*
|
|
* @return array<string, mixed>
|
|
*/
|
|
public function parseWebhookEvent(Request $request): array;
|
|
}
|