STAGE 5 · Lv.24

결제 게이트웨이 설정

Stripe, PayPal, 토스페이먼츠, 카카오페이, NicePay 등 글로벌 및 한국 PG사 결제 시스템 설정과 테스트 모드 활용법을 상세히 배웁니다.

결제 게이트웨이의 개념과 작동 원리

결제 게이트웨이란 무엇인가

결제 게이트웨이(Payment Gateway)는 온라인 쇼핑몰에서 고객이 상품을 구매할 때 결제 정보를 안전하게 처리하고 금융 기관과 통신하는 핵심 중개 시스템입니다. 고객이 결제하기 버튼을 누르는 순간부터 결제가 승인되어 주문이 확정되기까지, 결제 게이트웨이는 카드 정보의 암호화, 금융 기관과의 통신, 승인 결과 반환 등 복잡한 일련의 과정을 밀리초 단위로 처리합니다.

한국에서는 이 역할을 PG(Payment Gateway)사가 수행합니다. 해외에서는 Stripe나 PayPal 같은 서비스가 결제 처리와 정산까지 직접 담당하지만, 한국에서는 신용카드사, 은행과의 직접 계약 대신 PG사를 통해 통합 결제를 처리하는 것이 일반적입니다. PG사는 여러 카드사 및 은행과의 계약을 대행하므로, 쇼핑몰 운영자는 하나의 PG사와 계약만으로 다양한 결제 수단을 제공할 수 있습니다.

WooCommerce에서 결제 게이트웨이는 플러그인 형태로 동작합니다. WooCommerce 자체에는 기본적으로 은행 송금(BACS), 수표 결제, 대금 상환(COD) 등 간단한 결제 방식만 내장되어 있으며, Stripe이나 PayPal, 한국 PG사 연동은 별도 플러그인을 설치하여 사용합니다. 각 결제 게이트웨이 플러그인은 WC_Payment_Gateway 클래스를 확장하여 구현되며, 결제 처리 로직, 관리자 설정 화면, 결제 폼 렌더링 등을 포함합니다.

결제 게이트웨이를 선택할 때 고려해야 할 핵심 요소는 수수료율, 정산 주기, 지원 결제 수단, 기술 지원 품질, API 문서화 수준, 테스트 환경 제공 여부, 그리고 보안 인증 수준입니다. 특히 한국 시장에서는 간편결제(카카오페이, 네이버페이, 삼성페이 등) 지원 여부가 전환율에 큰 영향을 미치므로 반드시 확인해야 합니다.

👤

고객
결제 요청

→

🛒

WooCommerce
주문 생성

→

🔒

PG사
결제 처리

→

🏢

카드사/은행
승인 요청

→

✅

결과 반환
주문 완료

💳

2.5~3.5%

한국 PG사 평균 수수료율

🕒

D+3~D+5

일반적인 정산 주기

📊

45%

신용카드 결제 비율

📱

30%+

간편결제 사용 비율

결제 게이트웨이의 기술적 작동 흐름

결제 처리의 기술적 흐름을 상세히 살펴보면, 먼저 고객이 결제 버튼을 클릭하면 WooCommerce가 주문 객체를 생성하고 결제 게이트웨이의 process_payment 메서드를 호출합니다. 이 메서드 내에서 PG사 API에 결제 요청을 보내는데, 이때 주문 금액, 상품 정보, 고객 정보 등이 암호화되어 전송됩니다.

PG사는 전달받은 정보를 기반으로 해당 카드사나 은행에 승인 요청을 보내고, 카드사는 한도 확인, 사기 탐지, 본인 인증(3D Secure) 등의 과정을 거쳐 승인 또는 거절 결과를 반환합니다. PG사는 이 결과를 다시 WooCommerce에 웹훅(Webhook) 또는 리턴 URL을 통해 전달하며, WooCommerce는 결과에 따라 주문 상태를 processing(처리 중) 또는 failed(실패)로 변경합니다.

이 전체 과정은 일반적으로 2-5초 이내에 완료되어야 합니다. 타임아웃이 발생하면 고객은 결제가 되었는지 알 수 없어 혼란을 겪게 되므로, 결제 게이트웨이의 응답 속도와 안정성은 매우 중요합니다. 또한 네트워크 장애 시를 대비한 재시도 로직과 중복 결제 방지 메커니즘도 필수적으로 갖추어야 합니다.

한국 PG사 전체 비교 분석

한국 주요 PG사 상세 비교

한국에서 WooCommerce 쇼핑몰을 운영한다면 국내 PG사와의 연동이 필수입니다. 각 PG사마다 수수료 구조, 지원 결제 수단, API 품질, 기술 지원 수준이 다르므로 사업 규모와 특성에 맞는 PG사를 선택해야 합니다. 2024년 기준으로 한국에서 가장 많이 사용되는 PG사는 토스페이먼츠, KG이니시스, 나이스페이먼츠(NicePay), KCP, 그리고 간편결제 전문인 카카오페이와 네이버페이입니다.

소규모 스타트업이나 개인 쇼핑몰이라면 초기 설정이 간편하고 개발자 친화적인 API를 제공하는 토스페이먼츠를 추천합니다. 거래 규모가 크고 안정성이 최우선이라면 KG이니시스나 나이스페이먼츠가 적합합니다. 간편결제 위주의 결제 경험을 제공하고 싶다면 카카오페이나 네이버페이를 주 결제 수단으로 배치하는 것이 좋습니다.

PG사	신용카드 수수료	간편결제 수수료	정산 주기	API 품질	WooCommerce 연동
토스페이먼츠	3.0~3.5%	3.0~3.3%	D+2 (익영업일)	최상 (RESTful)	공식 플러그인 제공
카카오페이	-	2.5~3.0%	D+3	상	PG사 통합 또는 직접 연동
네이버페이	-	2.0~3.5%	D+1~D+3	상	별도 플러그인 필요
나이스페이먼츠	2.5~3.3%	2.8~3.3%	D+3~D+5	중상	서드파티 플러그인
KG이니시스	2.5~3.5%	2.8~3.5%	D+3~D+5	중	서드파티 플러그인

토스페이먼츠 (Toss Payments) 상세 분석

토스페이먼츠는 토스(Toss) 생태계의 결제 인프라로, 한국 PG사 중 가장 현대적인 API 설계와 개발자 친화적인 문서화를 자랑합니다. RESTful API를 기반으로 하며, JSON 응답 포맷을 사용하여 프론트엔드 및 백엔드 개발자 모두가 쉽게 연동할 수 있습니다.

장점: 깔끔한 결제 UI(결제창 디자인이 현대적), 테스트 환경이 즉시 제공됨(가입 후 바로 테스트키 발급), 결제 연동 코드가 간결함, 샌드박스 환경에서 실제와 동일한 결제 시나리오 테스트 가능, 정산 주기가 빠름(D+2), 실시간 결제 현황 대시보드 제공, 서브몰(하위 가맹점) 기능 지원.

단점: 소규모 가맹점의 경우 수수료 협상 여지가 적음, 일부 특수 결제 수단(문화상품권, 도서상품권 등)의 지원이 제한적, 대형 엔터프라이즈 고객을 위한 맞춤형 지원이 KG이니시스나 나이스페이먼츠에 비해 부족할 수 있음.

지원 결제 수단: 신용카드, 체크카드, 계좌이체, 가상계좌, 휴대폰 결제, 카카오페이, 네이버페이, 삼성페이, PAYCO, 토스페이, 문화상품권, 해외 카드.

// 토스페이먼츠 결제 위젯 초기화 (프론트엔드 JavaScript)
const clientKey = 'test_ck_YOUR_CLIENT_KEY';
const customerKey = 'CUSTOMER_UNIQUE_ID';

// 토스페이먼츠 SDK 로드 후 결제 위젯 초기화
const paymentWidget = PaymentWidget(clientKey, customerKey);

// 결제 수단 위젯 렌더링
paymentWidget.renderPaymentMethods(
    '#payment-method',
    { value: orderAmount },
    { variantKey: 'DEFAULT' }
);

// 약관 동의 위젯 렌더링
paymentWidget.renderAgreement('#agreement', {
    variantKey: 'AGREEMENT'
});

// 결제 요청
async function requestPayment() {
    try {
        await paymentWidget.requestPayment({
            orderId: 'ORDER_' + Date.now(),
            orderName: '프리미엄 회원권 외 2건',
            successUrl: 'https://yourshop.com/payment/success',
            failUrl: 'https://yourshop.com/payment/fail',
            customerEmail: 'customer@example.com',
            customerName: '홍길동',
        });
    } catch (error) {
        console.error('결제 요청 실패:', error);
    }
}
    

// 토스페이먼츠 결제 승인 (백엔드 PHP - WooCommerce 연동)
function map_toss_confirm_payment($paymentKey, $orderId, $amount) {
    $secretKey = get_option('toss_secret_key');
    $encodedKey = base64_encode($secretKey . ':');

    $response = wp_remote_post(
        'https://api.tosspayments.com/v1/payments/confirm',
        [
            'headers' => [
                'Authorization' => 'Basic ' . $encodedKey,
                'Content-Type'  => 'application/json',
            ],
            'body' => wp_json_encode([
                'paymentKey' => $paymentKey,
                'orderId'    => $orderId,
                'amount'     => $amount,
            ]),
            'timeout' => 30,
        ]
    );

    if (is_wp_error($response)) {
        error_log('토스 결제 승인 실패: ' . $response->get_error_message());
        return false;
    }

    $body = json_decode(wp_remote_retrieve_body($response), true);
    $statusCode = wp_remote_retrieve_response_code($response);

    if ($statusCode === 200 && $body['status'] === 'DONE') {
        // 결제 성공 처리
        $order = wc_get_order($orderId);
        $order->payment_complete($paymentKey);
        $order->add_order_note(
            sprintf('토스페이먼츠 결제 완료 (결제키: %s, 금액: %s원)',
                $paymentKey, number_format($amount))
        );
        return true;
    }

    // 결제 실패 처리
    error_log('토스 결제 실패: ' . print_r($body, true));
    return false;
}
    

카카오페이 (KakaoPay) 상세 분석

카카오페이는 카카오톡 기반의 간편결제 서비스로, 한국 모바일 결제 시장에서 가장 높은 점유율을 차지하고 있습니다. 카카오톡의 방대한 사용자 기반(약 4,700만 명)을 바탕으로, 결제 시 카카오톡 앱으로 알림이 가고 비밀번호 또는 생체인증만으로 결제가 완료되는 간편한 UX를 제공합니다.

연동 방법 1 - PG사 통합 방식: 토스페이먼츠, 나이스페이먼츠 등의 PG사를 통해 카카오페이를 결제 수단 중 하나로 추가합니다. 별도 카카오페이 계약이 불필요하고, 기존 PG 수수료에 카카오페이 수수료가 포함됩니다. 대부분의 소규모 쇼핑몰에 권장되는 방식입니다.

연동 방법 2 - 직접 API 연동: 카카오페이 개발자센터(developers.kakao.com)에서 직접 API를 연동합니다. 정기결제, 단건결제, 구독 결제 등 더 다양한 기능을 사용할 수 있고, 수수료 직접 협상이 가능합니다. 하지만 별도 카카오페이 가맹점 계약이 필요하고, 개발 리소스가 더 많이 소요됩니다.

장점: 가장 높은 모바일 결제 전환율, 카카오톡 알림을 통한 자연스러운 결제 경험, 간편송금과 연계된 높은 사용률, 카카오페이 포인트 적립으로 재구매 유도.

단점: PC 환경에서는 QR 코드 스캔 필요(앱 전환), 해외 결제 미지원, 고액 결제 시 추가 인증 필요, PG사 통합 방식은 커스터마이징 제한.

네이버페이 (Naver Pay) 상세 분석

네이버페이는 네이버 생태계 기반의 간편결제 서비스로, 특히 네이버 쇼핑 연동과 포인트 적립 시스템이 강점입니다. 네이버 검색에서 유입된 고객에게 가장 익숙한 결제 수단이며, 네이버 멤버십과 연계한 추가 적립 혜택이 있어 고객 충성도를 높일 수 있습니다.

장점: 네이버 쇼핑 노출 시 네이버페이 결제 우선 표시, 네이버 포인트 적립으로 재구매 유도, 안정적인 결제 인프라, 반복 구매 고객에게 높은 편의성 제공, 정산 주기가 빠름(최소 D+1).

단점: 네이버 생태계 외부에서의 인지도 상대적 낮음, 직접 연동 시 네이버 쇼핑 센터 등록 필요, 수수료 구조가 복잡(기본 수수료 + 네이버페이 수수료), 디자인 커스터마이징 제한.

WooCommerce 연동 시 주의사항: 네이버페이는 네이버에서 제공하는 공식 SDK를 통해 연동해야 합니다. PG사를 통한 간접 연동도 가능하지만, 네이버 쇼핑 연동이나 포인트 적립 기능을 완전히 활용하려면 직접 연동이 필요합니다. 직접 연동 시에는 네이버 스마트스토어 센터에 쇼핑몰을 등록하고 검수를 받아야 합니다.

나이스페이먼츠 (NicePay) 상세 분석

나이스페이먼츠(구 NicePay)는 나이스그룹 계열의 PG사로, 한국에서 가장 오래된 PG사 중 하나입니다. 안정적인 서비스 품질과 다양한 결제 수단 지원이 특징이며, 특히 대형 쇼핑몰과 엔터프라이즈 고객에게 강점을 보입니다.

장점: 오랜 운영 경험으로 인한 높은 안정성, 다양한 특수 결제 수단 지원(문화상품권, 도서상품권, 해피머니 등), 맞춤형 수수료 협상 가능, 전담 기술 지원 제공, B2B 결제 솔루션 지원.

단점: API가 토스페이먼츠에 비해 레거시 스타일(XML/Form 기반이 일부 남아있음), 테스트 환경 설정이 다소 복잡, 소규모 가맹점에 대한 지원이 상대적으로 부족, 관리자 페이지 UI가 다소 구식.

KG이니시스 (KG Inicis) 상세 분석

KG이니시스는 한국에서 가장 많은 가맹점을 보유한 PG사로, 온라인 결제 시장의 오랜 강자입니다. 특히 대형 쇼핑몰, 항공사, 여행사 등에서 많이 사용되며, 높은 거래 처리 능력과 안정성을 자랑합니다.

장점: 국내 최다 가맹점 수, 높은 거래 처리 안정성, 다양한 결제 수단 지원, 글로벌 결제 지원(해외 카드 처리), 대형 기업 맞춤 솔루션.

단점: API 문서화가 토스페이먼츠에 비해 부족, 개발자 경험(DX)이 상대적으로 낮음, WooCommerce 공식 플러그인 미제공(서드파티 의존), 초기 설정과 심사 과정이 복잡, 소규모 가맹점 대응 속도가 느릴 수 있음.

비교 항목	토스페이먼츠	나이스페이먼츠	KG이니시스
API 스타일	RESTful JSON	REST + 일부 레거시	REST + 레거시 Form
테스트 환경	즉시 발급, 샌드박스	신청 후 발급	신청 후 발급
기술 문서	최상 (한/영)	상 (한국어)	중상 (한국어)
정산 속도	D+2 (최단)	D+3~D+5	D+3~D+5
소규모 쇼핑몰	매우 적합	적합	보통
대규모 쇼핑몰	적합	매우 적합	매우 적합
해외 결제	지원	지원	지원 (강점)

💡 PG사 선택 실전 가이드

1. 월 매출 1,000만원 이하: 토스페이먼츠를 추천합니다. 초기 설정이 가장 간편하고, 테스트 환경이 즉시 제공되며, 수수료도 합리적입니다.
2. 월 매출 1,000만~1억원: 토스페이먼츠 또는 나이스페이먼츠를 추천합니다. 수수료 협상이 가능해지는 구간이므로 여러 PG사에 견적을 요청하세요.
3. 월 매출 1억원 이상: KG이니시스 또는 나이스페이먼츠를 추천합니다. 전담 매니저 배정과 맞춤형 수수료 협상이 가능합니다.
4. 글로벌 판매: KG이니시스 + Stripe 조합을 추천합니다. 국내 결제는 KG이니시스로, 해외 결제는 Stripe로 처리합니다.

🔒

여기까지는 미리보기입니다

결제 게이트웨이 설정
무료 가입하면 이어서 볼 수 있고, 강의를 완료할 때마다 XP와 레벨이 쌓입니다.

Google로 3초 만에 시작 →🧵 Threads로 시작 무료 공개 강의 둘러보기 (Lv.1~3)