Files
sam-api/app/Http/Controllers/Api/V1/PaymentController.php
hskwon 45780ea351 feat: 구독/결제 API 확장 (Plan, Subscription, Payment)
- Plan/Subscription/Payment 모델에 상태 상수, 스코프, 헬퍼 메서드 추가
- PlanService, SubscriptionService, PaymentService 생성
- PlanController, SubscriptionController, PaymentController 생성
- FormRequest 9개 생성 (Plan 3개, Subscription 3개, Payment 3개)
- Swagger 문서 3개 생성 (PlanApi, SubscriptionApi, PaymentApi)
- API 라우트 22개 등록 (Plan 7개, Subscription 8개, Payment 7개)
- Pint 코드 스타일 정리
2025-12-18 16:20:29 +09:00

89 lines
2.4 KiB
PHP

<?php
namespace App\Http\Controllers\Api\V1;
use App\Http\Controllers\Controller;
use App\Http\Requests\V1\Payment\PaymentActionRequest;
use App\Http\Requests\V1\Payment\PaymentIndexRequest;
use App\Http\Requests\V1\Payment\PaymentStoreRequest;
use App\Http\Response\ApiResponse;
use App\Services\PaymentService;
use Illuminate\Http\JsonResponse;
class PaymentController extends Controller
{
public function __construct(
private readonly PaymentService $paymentService
) {}
/**
* 결제 목록
*/
public function index(PaymentIndexRequest $request): JsonResponse
{
$result = $this->paymentService->index($request->validated());
return ApiResponse::handle('message.fetched', $result);
}
/**
* 결제 요약 통계
*/
public function summary(PaymentIndexRequest $request): JsonResponse
{
$result = $this->paymentService->summary($request->validated());
return ApiResponse::handle('message.fetched', $result);
}
/**
* 결제 상세
*/
public function show(int $id): JsonResponse
{
$result = $this->paymentService->show($id);
return ApiResponse::handle('message.fetched', $result);
}
/**
* 결제 등록 (수동)
*/
public function store(PaymentStoreRequest $request): JsonResponse
{
$result = $this->paymentService->store($request->validated());
return ApiResponse::handle('message.created', $result, 201);
}
/**
* 결제 완료 처리
*/
public function complete(PaymentActionRequest $request, int $id): JsonResponse
{
$result = $this->paymentService->complete($id, $request->validated()['transaction_id'] ?? null);
return ApiResponse::handle('message.payment.completed', $result);
}
/**
* 결제 취소
*/
public function cancel(PaymentActionRequest $request, int $id): JsonResponse
{
$result = $this->paymentService->cancel($id, $request->validated()['reason'] ?? null);
return ApiResponse::handle('message.payment.cancelled', $result);
}
/**
* 환불 처리
*/
public function refund(PaymentActionRequest $request, int $id): JsonResponse
{
$result = $this->paymentService->refund($id, $request->validated()['reason'] ?? null);
return ApiResponse::handle('message.payment.refunded', $result);
}
}