04강: HTTP 클라이언트 PG사 연동 & Context 트레이스 헬퍼

namespace App\Services\Payment;

use App\Contracts\PaymentGatewayContract;
use App\Contracts\PaymentResult;
use Illuminate\Support\Facades\Http;
use Illuminate\Support\Facades\Log;

class TossPaymentGateway implements PaymentGatewayContract
{
    public function __construct(
        protected string $apiKey,
        protected string $secretKey,
    ) {}

    public function charge(int $amount, array $orderData): PaymentResult
    {
        try {
            // 🚀 5초 타임아웃, 네트워크 실패 시 100ms 간격으로 최대 3회 자동 재시도!
            $response = Http::withBasicAuth($this->secretKey, '')
                ->timeout(5)
                ->retry(3, 100)
                ->withHeaders([
                    'X-JinyShop-Trace-Id' => \Illuminate\Support\Facades\Context::get('trace_id'),
                ])
                ->post('https://api.tosspayments.com/v1/payments/confirm', [
                    'paymentKey' => $orderData['payment_key'] ?? 'test_pk',
                    'orderId' => $orderData['order_id'] ?? 'ORD-' . time(),
                    'amount' => $amount,
                ]);

            if ($response->successful()) {
                $data = $response->json();
                return new PaymentResult(
                    success: true,
                    transactionId: $data['paymentKey'] ?? 'TX-'.time(),
                    amount: $amount
                );
            }

            // PG사에서 거절된 경우
            Log::warning('PG 결제 승인 거절: ' . $response->body());
            return new PaymentResult(
                success: false,
                transactionId: '',
                amount: $amount,
                errorMessage: $response->json('message') ?? '결제 승인이 거절되었습니다.'
            );
        } catch (\Throwable $e) {
            Log::error('PG사 네트워크 통신 장애: ' . $e->getMessage());
            return new PaymentResult(
                success: false,
                transactionId: '',
                amount: $amount,
                errorMessage: '결제 대행사 통신 연결 실패'
            );
        }
    }

    public function refund(string $transactionId, int $amount): bool
    {
        return true;
    }
}

use Illuminate\Support\Facades\Http;

// 1. 토스 API URL로 가는 요청을 가상 승인 응답으로 가로채기!
Http::fake([
    'https://api.tosspayments.com/*' => Http::response([
        'paymentKey' => 'REAL-LIKE-TOSS-KEY-999',
        'status' => 'DONE',
        'totalAmount' => 35000,
    ], 200),
]);

// 2. 게이트웨이 실행
$gateway = new App\Services\Payment\TossPaymentGateway('key', 'secret');
$result = $gateway->charge(35000, ['order_id' => 'ORD-123']);

echo "가상 통신 성공 여부: " . ($result->success ? '성공!' : '실패') . PHP_EOL;
echo "거래 키: " . $result->transactionId . PHP_EOL;

use Illuminate\Support\Facades\Context;
use Illuminate\Support\Str;

// 미들웨어나 요청 시작점에서 Context 부여
Context::add('trace_id', Str::uuid()->toString());
Context::add('user_id', auth()->id() ?? 'guest');

// 이후 Log::info()를 호출하면 Context 데이터가 로그에 자동으로 함께 기록됩니다!
Log::info('도서 결제 요청 시작');

<?php

if (! function_exists('currency_krw')) {
    function currency_krw(int|float $amount): string
    {
        return number_format($amount) . '원';
    }
}