[]]], tags: ['Wallet'], requestBody: new OA\RequestBody( required: true, content: new OA\JsonContent( required: ['amount'], properties: [ new OA\Property(property: 'amount', type: 'integer', example: 500000), ] ) ), responses: [ new OA\Response( response: 201, description: 'Deposit initiated successfully', content: new OA\JsonContent( properties: [ new OA\Property(property: 'message', type: 'string', example: 'درخواست شارژ کیف پول ثبت شد.'), new OA\Property( property: 'data', properties: [ new OA\Property(property: 'deposit', ref: '#/components/schemas/WalletDeposit'), new OA\Property(property: 'payment_url', type: 'string'), ], type: 'object' ), ] ) ), new OA\Response(response: 401, description: 'Unauthenticated'), new OA\Response(response: 422, description: 'Validation error'), ] )] public function store(InitiateDepositRequest $request): JsonResponse { $result = $this->walletDepositService->initiate($request->user(), $request->validated('amount')); return $this->success('درخواست شارژ کیف پول ثبت شد.', [ 'deposit' => new WalletDepositResource($result['deposit']), 'payment_url' => $result['payment_url'], ], 201); } #[OA\Get( path: '/wallet/deposits/{deposit}/callback', description: 'Public callback the payment gateway redirects to after a payment attempt', summary: 'Wallet deposit callback', tags: ['Wallet'], parameters: [ new OA\Parameter(name: 'deposit', description: 'Deposit id', in: 'path', required: true, schema: new OA\Schema(type: 'integer')), ], responses: [ new OA\Response(response: 302, description: 'Redirects to the frontend wallet page with a status query param'), ] )] public function callback(WalletDeposit $deposit, Request $request): RedirectResponse { $success = $this->walletDepositService->handleCallback($deposit, $request->query()); return redirect()->away( rtrim((string) config('app.frontend_url'), '/').'/wallet?status='.($success ? 'success' : 'failed') ); } }