ShopPlatform.Payments.TossPaymentGateway 클래스 참조

더 자세히 ...

ShopPlatform.Payments.TossPaymentGateway에 대한 상속 다이어그램 :

ShopPlatform.Payments.TossPaymentGateway에 대한 협력 다이어그램:

Public 멤버 함수
	TossPaymentGateway (HttpClient http, ShopPaymentConfig config, PaymentKeyProtector protector)
Task< PaymentStartResult >	StartAsync (string orderNo, decimal amount, string customerName)
async Task< PaymentConfirmResult >	ConfirmAsync (string paymentKey, string orderId, int amount)

Private 속성
readonly HttpClient	_http
readonly ShopPaymentConfig	_config
readonly PaymentKeyProtector	_protector

정적 Private 속성
const string	ApiBase = "https://api.tosspayments.com/v1"

상세한 설명

토스페이먼츠 V2 구현. 테넌트별 키 사용.

TossPaymentGateway.cs 파일의 17 번째 라인에서 정의되었습니다.

생성자 & 소멸자 문서화

TossPaymentGateway()

ShopPlatform.Payments.TossPaymentGateway.TossPaymentGateway ( HttpClient http, ShopPaymentConfig config, PaymentKeyProtector protector )

inline

지정한 설정으로 TossPaymentGateway 클래스의 새 인스턴스를 초기화합니다.

매개변수

http	http에 사용할 HttpClient 값입니다.
config	config에 사용할 ShopPaymentConfig 값입니다.
protector	protector에 사용할 PaymentKeyProtector 값입니다.

TossPaymentGateway.cs 파일의 89 번째 라인에서 정의되었습니다.

    {
        _http = http;
        _config = config;
        _protector = protector;
    }

다음을 참조함 : _config, _http, _protector.

멤버 함수 문서화

ConfirmAsync()

async Task< PaymentConfirmResult > ShopPlatform.Payments.TossPaymentGateway.ConfirmAsync ( string paymentKey, string orderId, int amount )

inline

Confirm Async 작업을 수행합니다.

매개변수

paymentKey	payment Key에 사용할 string 값입니다.
orderId	order Id에 사용할 string 값입니다.
amount	amount에 사용할 int 값입니다.

반환값

Confirm Async 작업에서 생성한 Task<PaymentConfirmResult> 결과입니다.

ShopPlatform.Payments.IPaymentGateway를 구현.

TossPaymentGateway.cs 파일의 189 번째 라인에서 정의되었습니다.

    {
        var secretKey = _protector.Unprotect(_config.TossSecretKeyEncrypted);
        if (string.IsNullOrEmpty(secretKey))
            return new PaymentConfirmResult { Succeeded = false, Error = "결제 키가 설정되지 않았습니다." };
 
        var encoded = Convert.ToBase64String(Encoding.UTF8.GetBytes($"{secretKey}:"));
        var req = new HttpRequestMessage(HttpMethod.Post, $"{ApiBase}/payments/confirm");
        req.Headers.Authorization = new AuthenticationHeaderValue("Basic", encoded);
        req.Content = new StringContent(
            JsonSerializer.Serialize(new { paymentKey, orderId, amount }),
            Encoding.UTF8, "application/json");
 
        var resp = await _http.SendAsync(req);
        var body = await resp.Content.ReadAsStringAsync();
 
        if (!resp.IsSuccessStatusCode)
            return new PaymentConfirmResult { Succeeded = false, Error = body };
 
        using var doc = JsonDocument.Parse(body);
        var txId = doc.RootElement.TryGetProperty("paymentKey", out var pk) ? pk.GetString() : null;
        return new PaymentConfirmResult { Succeeded = true, TransactionId = txId };
    }

다음을 참조함 : _config, _http, _protector.

StartAsync()

Task< PaymentStartResult > ShopPlatform.Payments.TossPaymentGateway.StartAsync ( string orderNo, decimal amount, string customerName )

inline

Start Async 작업을 수행합니다.

매개변수

orderNo	order No에 사용할 string 값입니다.
amount	amount에 사용할 decimal 값입니다.
customerName	customer Name에 사용할 string 값입니다.

반환값

Start Async 작업에서 생성한 Task<PaymentStartResult> 결과입니다.

ShopPlatform.Payments.IPaymentGateway를 구현.

TossPaymentGateway.cs 파일의 136 번째 라인에서 정의되었습니다.

    {
        return Task.FromResult(new PaymentStartResult
        {
            OrderId = orderNo,
            OrderNo = orderNo,
            Amount = amount,
            ClientKey = _config.TossClientKey,
            SuccessUrl = _config.SuccessReturnUrl,
            FailUrl = _config.FailReturnUrl
        });
    }

다음을 참조함 : _config.

멤버 데이터 문서화

_config

readonly ShopPaymentConfig ShopPlatform.Payments.TossPaymentGateway._config

private

config 값을 보관합니다.

TossPaymentGateway.cs 파일의 46 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : ConfirmAsync(), StartAsync(), TossPaymentGateway().

_http

readonly HttpClient ShopPlatform.Payments.TossPaymentGateway._http

private

http 값을 보관합니다.

TossPaymentGateway.cs 파일의 37 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : ConfirmAsync(), TossPaymentGateway().

_protector

readonly PaymentKeyProtector ShopPlatform.Payments.TossPaymentGateway._protector

private

protector 값을 보관합니다.

TossPaymentGateway.cs 파일의 55 번째 라인에서 정의되었습니다.

다음에 의해서 참조됨 : ConfirmAsync(), TossPaymentGateway().

ApiBase

const string ShopPlatform.Payments.TossPaymentGateway.ApiBase = "https://api.tosspayments.com/v1"

staticprivate

Api Base 값을 보관합니다.

TossPaymentGateway.cs 파일의 27 번째 라인에서 정의되었습니다.

---

이 클래스에 대한 문서화 페이지는 다음의 파일로부터 생성되었습니다.:

• TossPaymentGateway.cs