Computer >> 컴퓨터 >  >> 프로그래밍 >> HTML

WooCommerce에 Stripe 연동하는 방법 – 초보자를 위한 단계별 완벽 가이드

온라인 스토어를 성공적으로 운영하기 위해서는 WooCommerce 사이트에 맞는 결제 게이트웨이를 설정하는 것이 매우 중요합니다. 이미 Stripe로 결정하셨다면, 이 글이 시작점이 되어줄 것입니다.

WooCommerce에 Stripe를 추가하려면 플러그인을 활성화하고 자신의 Stripe 계정과 연결해야 합니다. 이 글에서는 WooCommerce에 Stripe를 설정하는 방법을 단계별로 안내하고, Stripe 사용 시 알아두어야 할 핵심 사항들도 함께 다룹니다.

핵심 요약: Stripe는 높은 보안성과 다양한 결제 수단 지원으로 인기 있는 서비스입니다. 이 가이드를 따라 쉽게 WooCommerce에 Stripe를 연동할 수 있습니다. 다만 작업을 시작하기 전에 BlogVault로 사이트를 백업해 두는 것을 권장합니다. 그래야 지금까지 진행한 작업을 잃어버릴 위험 없이 안전하게 진행할 수 있습니다.

WooCommerce에 Stripe를 추가하기 위한 필수 조건

본격적인 설정에 앞서 몇 가지 확인해야 할 사항이 있습니다.

  • 적합한 플러그인 선택: WooCommerce용 Stripe 연동 플러그인은 종류가 매우 다양합니다. 각각 장점이 다르므로 제공하는 기능에 따라 선택하는 것이 좋습니다. 예를 들어 WooCommerce Stripe Payment Gateway는 구독 플러그인용 확장 프로그램이 필요하며, 의류나 액세서리를 판매하는 비즈니스에 적합합니다.
  • SSL 인증서 설치: SSL 인증서가 반드시 필요합니다. SSL은 연결을 암호화해 주므로 결제 게이트웨이와 무관하게 설치하는 것이 좋습니다.
  • WooCommerce 2.2 이상 버전 필요: Stripe는 WooCommerce 2.2 이상에서만 환불 처리를 지원하므로 사이트를 최신 상태로 유지하세요. 최신 업데이트는 보안 강화와 버그 감소 효과도 있으니 어차피 해두는 것이 좋습니다.

Stripe 계정 만들기

WooCommerce 사이트에 Stripe를 연동하기 전에 먼저 Stripe 계정을 만들어야 합니다. 계정 생성 과정은 직관적이며, 국가마다 절차가 약간씩 다를 수 있지만 아래 단계를 따르면 됩니다.

  1. 계정 생성: Stripe 웹사이트로 이동하여 'Start Now'를 클릭합니다. 이메일, 이름을 입력하고 국가를 선택한 후 강력한 비밀번호를 설정한 뒤 'Create Account'를 클릭합니다.
  2. 이메일 주소 인증: 본인의 이메일 계정으로 이동하여 'Verify email address' 버튼을 클릭합니다.
  3. 결제 활성화: Stripe 계정으로 돌아가 'Activate Payments'를 클릭합니다. 결제를 받기 위해 반드시 필요한 단계이므로 건너뛰지 말고 진행하는 것을 권장합니다.
  4. 사업 기본 정보 입력: 등록된 사업자 주소, 사업 유형, 사업 형태(개인 사업자가 아닌 경우)를 입력합니다.
  5. 사업 세부 정보 입력: 법적 사업체명 또는 LLC 명칭, 고용주 식별 번호(EIN), 등록된 사업자 주소와 전화번호를 입력합니다. 해당하는 업종을 선택하고, 웹사이트와 제품 설명 같은 추가 정보도 기입합니다.
  6. 사업 대표자 정보 입력: 회사 담당자(연락 창구) 정보를 입력합니다.
  7. 소유주 정보 입력: 해당되는 경우 소유주 정보도 함께 입력합니다.
  8. 배송/이행 정보 선택: 고객이 제품이나 서비스를 받거나 사용하기까지 걸리는 시간을 선택합니다.
  9. 명세서 표시명(statement descriptor) 입력: 고객의 거래 내역서에 표시될 이름입니다. 쉽게 식별할 수 있도록 설정하세요. 글자 수 제한이 있습니다.
  10. 은행 정보 입력: 직접 입력하거나 은행을 선택한 후 안내에 따라 진행합니다.
  11. 2단계 인증 활성화: SMS 또는 인증 앱 중 하나를 선택합니다.
  12. 판매세 계산 활성화: 선택 사항이지만 세금 처리를 간편하게 해 줍니다.
  13. 추가 정보 입력: 다음 페이지에서 요구되는 나머지 정보를 입력합니다. 앞선 단계에서 입력한 내용에 따라 달라질 수 있습니다. 완료 후 'Submit'을 클릭하면 결제를 받을 준비가 끝납니다.

WooCommerce에 Stripe 추가하는 방법

Stripe 계정을 만들었다면 이제 WooCommerce 사이트와 연동할 차례입니다. 선택 가능한 플러그인은 많지만, 여기서는 대표적인 세 가지 플러그인을 기준으로 안내합니다.

  • WooCommerce Stripe Payment Gateway
  • Payment Plugins for Stripe WooCommerce
  • WooCommerce Payments

WooCommerce Stripe Payment Gateway

WooCommerce에서 제공하는 이 플러그인은 전 세계 37개국 판매자가 사용할 수 있으며, 지원 국가가 꾸준히 늘고 있습니다. 폭넓은 결제 수단 지원으로 선호되며, 구독 결제를 사용하려면 WooCommerce Subscriptions 확장 프로그램을 설치해야 합니다. 이 플러그인을 선택했다면 아래 단계를 따라 연동을 시작하세요.

  1. WooCommerce Stripe Payment Gateway 활성화

    좌측 메뉴에서 플러그인을 클릭하고 새로 추가를 선택합니다. 검색창에 "WooCommerce Stripe Payment Gateway"를 입력한 후 설치활성화를 클릭합니다.
  2. Stripe 계정 연결

    WooCommerce 대시보드로 이동해 Payments 탭을 엽니다. Stripe (Credit Card)를 켜고 페이지가 로드되면 Stripe 계정에 로그인합니다. 완료하면 자동으로 사이트로 돌아옵니다.
  3. 테스트 모드 활성화

    WP 대시보드에서 좌측 WooCommerce 로고 위에 마우스를 올리고 설정(Settings)을 클릭합니다. Payments 탭에서 Stripe (credit card)를 클릭한 뒤 Settings 탭으로 이동합니다. 일반 섹션에서 'Edit Account Keys'를 클릭하고 팝업에서 Test 탭을 엽니다.
  4. 테스트 API 키 설정

    Stripe 웹사이트로 전환해 우측 상단의 Developers를 클릭합니다. 우측 상단에서 Test Mode를 켠 후 좌측 메뉴에서 API Keys 탭을 선택합니다. 공개 키(publishable key)와 시크릿 키(secret key)를 복사해 WordPress 관리자 화면의 테스트 공개 키/테스트 시크릿 키 필드에 붙여넣습니다.
  5. 테스트 웹훅(webhook) 설정

    WP 관리자 대시보드의 Stripe 설정 페이지에서 제공되는 웹훅 엔드포인트 URL을 복사합니다. Stripe 개발자 대시보드의 Webhooks 페이지에서 + Add Endpoint를 클릭하고 엔드포인트 URL 필드에 붙여넣습니다.
  6. 이벤트 선택

    표시된 목록에서 필요한 이벤트를 선택합니다. 최신 API 버전이 있다면 함께 선택하고, 완료 후 Add Endpoint를 클릭합니다. Stripe는 최소한 아래 이벤트들을 선택할 것을 권장합니다.
    • source.chargeable
    • source.cancelled
    • charge.succeeded
    • charge.failed
    • charge.captured
    • charge.dispute.created
    • charge.dispute.closed
    • charge.refunded
    • review.opened
    • review.closed
    • payment_intent.succeeded
    • payment_intent.payment_failed
    • payment_intent.amount_capturable_updated
    • payment_intent.requires_action
    • setup_intent.succeeded
    • setup_intent.setup_failed
  7. 결제 게이트웨이 테스트

    직접 카드 정보로 테스트할 수도 있지만, Stripe가 제공하는 테스트용 인증 정보를 사용하는 것을 권장합니다.
  8. 테스트 모드 비활성화

    3번 단계와 같이 'Edit Account Keys'를 클릭하고 Live 탭을 엽니다. Stripe 계정으로 돌아가 테스트 모드를 끈 후 Live API 키를 복사해 붙여넣습니다. 웹훅도 동일한 과정을 거치고 이벤트를 선택합니다.
  9. 최종 확인

    API 키와 웹훅 설정을 한 번 더 확인한 후 실제 결제를 받을 준비를 마칩니다.

Payment Plugins for Stripe WooCommerce

Payment Plugins for Stripe WooCommerce는 WooCommerce Stripe Payment Gateway의 훌륭한 대안입니다. Stripe 공식 지원 플러그인 중 하나로, WooCommerce Subscriptions, Pre-Orders, Blocks를 지원하며 일부 국가에서는 할부 결제 구조도 지원합니다. 연동 방법은 아래와 같습니다.

  1. 설치 및 활성화:

    플러그인 디렉터리에서 Payment Plugins for Stripe WooCommerce를 검색한 후 설치활성화를 클릭합니다.
  2. 테스트 모드 활성화:

    활성화하면 플러그인 대시보드로 이동합니다. Settings를 클릭해 모드가 Test로 설정되어 있는지 확인하고, Stripe 사이트에서도 Test Mode를 켭니다.
  3. 테스트 API 키 설정:

    'Connect to Stripe'를 클릭해 Stripe 계정에 로그인하면 테스트 API 키와 웹훅이 자동으로 연결됩니다.
  4. 결제 게이트웨이 테스트:

    고객 관점의 결제 및 체크아웃 프로세스를 테스트할 수 있습니다.
  5. 웹훅 URL 추가

    플러그인 대시보드에서 웹훅 URL을 복사합니다. Stripe 개발자 대시보드로 이동해 + Add Endpoint를 클릭하고 엔드포인트 URL 필드에 붙여넣습니다.
  6. 이벤트 선택

    아래 목록에서 원하는 이벤트를 모두 선택합니다. 완료 후 최신 API 버전이 표시되면 선택하고 Add Endpoint를 클릭합니다. Stripe 기준 최소 필요 이벤트는 다음과 같습니다.
    • source.chargeable
    • source.cancelled
    • charge.succeeded
    • charge.failed
    • charge.captured
    • charge.dispute.created
    • charge.dispute.closed
    • charge.refunded
    • review.opened
    • review.closed
    • payment_intent.succeeded
    • payment_intent.payment_failed
    • payment_intent.amount_capturable_updated
    • payment_intent.requires_action
    • setup_intent.succeeded
    • setup_intent.setup_failed
  7. 서명 시크릿(signing secret) 복사:

    'Add Endpoint'를 클릭하면 대시보드로 돌아옵니다. 테이블에서 Reveal을 클릭해 서명 시크릿을 표시한 후 복사하여 WP 관리자 대시보드의 Webhook Secret 필드에 붙여넣습니다. 이제 결제를 받을 준비가 완료되었습니다.


참고: 테스트 모드에서 웹훅을 추가했다면, 테스트 모드를 비활성화한 후 동일한 과정을 반복하세요. Stripe와 WooCommerce 양쪽 모두 라이브 모드인지 확인해야 합니다.

WooCommerce Payments

WooCommerce Payments는 Automattic에서 만든 플러그인으로, Stripe와의 내장 파트너십을 기반으로 작동합니다. 덕분에 거래 및 결제 관련 모든 작업을 WooCommerce 대시보드에서 처리할 수 있습니다. 분쟁 해결이나 거래 모니터링을 위해 일일이 Stripe에 로그인할 필요가 없으며, 모든 것이 한곳에서 관리됩니다. 설정 방법은 아래와 같습니다.

  1. 설치 및 활성화

    WordPress 대시보드에서 플러그인 탭으로 이동해 '새로 추가'를 클릭하고, 플러그인 디렉터리에서 WooCommerce Payments를 검색해 설치·활성화합니다.
  2. WooCommerce Payments 설정

    WooCommerce Payments 페이지로 이동되면 Finish Setup을 클릭합니다. 올바른 이메일을 선택해 사이트를 연결한 후 Stripe 계정으로 로그인하면 설정이 완료되고 WordPress 대시보드로 돌아옵니다. 좌측 탭에서 거래 내역, 분쟁, 입금 내역 등을 확인할 수 있습니다.
  3. 테스트 모드 활성화

    로그인 후 Test Mode 아래 체크박스를 선택하면 이후 모든 거래가 테스트 모드로 진행됩니다.
  4. 테스트 모드 비활성화

    테스트를 마쳤다면 Test Mode 옆 체크박스를 해제하여 테스트 모드를 끕니다. 이제 설정이 완료되었으며 실제 결제를 받을 준비가 되었습니다.

WooCommerce용 Stripe 플러그인 선택 기준

적합한 결제 게이트웨이 플러그인을 고를 때는 비용, 관리 편의성, 지원 결제 수단, 기능 등을 반드시 고려해야 합니다.

비용: 세 플러그인 모두 무료이지만, WooCommerce Stripe Payment Gateway와 Payment Plugins for Stripe WooCommerce는 확장 프로그램 사용 시 추가 비용이 발생합니다.

거래 관리: WooCommerce Payments는 관리자 패널 내 대시보드에서 모든 것을 관리할 수 있습니다. 나머지 두 플러그인은 Stripe 대시보드를 따로 사용해야 합니다.

지원 결제 수단: WooCommerce Stripe Payment Gateway가 세 가지 중 가장 많은 결제 수단을 지원합니다. 주요 신용카드와 결제 방식뿐 아니라 Diners Club, Alipay, Microsoft Pay까지 데스크톱 사용자에게 지원합니다.

기능: Payment Plugins for Stripe WooCommerce와 WooCommerce Stripe Payment Gateway는 구독 같은 기능을 위해 별도 확장 프로그램 설치가 필요합니다.

Stripe를 사용해야 하는 이유

보안

Stripe는 가장 엄격한 컴플라이언스 감사를 통과했으며 PCI Level 1 Service Provider로 인증받았습니다. 모든 민감한 데이터와 통신이 암호화되며, 모든 서비스에 TLS 또는 SSL 보안을 요구합니다. Stripe를 사용하면 본인과 고객의 데이터가 안전하게 보호된다는 점을 확신할 수 있습니다.

추가로 MalCare처럼 멀웨어 스캐너, 최신 방화벽, 빠르고 간편한 멀웨어 정리 기능을 제공하는 보안 플러그인으로 사이트를 보호하는 것도 권장합니다. WooCommerce 보안에 대한 더 자세한 팁은 관련 심층 아티클을 참고하세요.

프라이버시

Stripe는 인증을 위해 정부 발급 신분증과 은행 정보를 수집합니다. 또한 고객이 사이트에서 구매할 때 이름, 나이(연령 제한 제품 판매 시), 배송 정보, 은행 정보, 거래 내역 등 개인 데이터를 수집합니다. Stripe는 이러한 고객 정보를 사기 탐지에 활용하거나, 고객이 승인한 경우 광고·결제 등의 목적으로 사업주에게 전달합니다.

요금

Stripe는 균일 정률 처리 수수료 구조로 호평받고 있습니다. 주요 사항은 다음과 같습니다.

  • 설치비나 정기 요금이 없습니다.
  • 미국 기준 종량제/거래 수수료는 카드 거래 2.9% + 30센트, 대면 결제 수단 2.7% + 5센트입니다. 해외 발급 카드에는 추가 1%, 환전 수수료로 추가 1%가 부과됩니다. 비용은 국가, 결제 유형, 은행에 따라 달라집니다.
  • 연동에 사용하는 플러그인, 확장 프로그램, 추가 상품에 따라 추가 비용이 발생할 수 있습니다. 예를 들어 사기 방지 상품인 Stripe Radar는 검증 거래당 7센트(2.9% + 30센트 표준 요금 적용 시 2센트)입니다.

입금 주기

입금 주기는 국가와 해당 지역의 리스크 수준에 따라 다릅니다(고위험 지역은 14일 주기일 수 있음). 일부 국가에서는 즉시 출금(instant payout)도 가능합니다. Stripe 계정을 만들면 계정 잔액이 생성되고, 거래 발생 시 수수료를 제외한 금액이 보류 잔액(pending balance)에 표시됩니다. 입금 주기가 완료되면 누적된 금액이 가용 잔액(available balance)으로 전환됩니다.

마무리 thoughts – 마무리 생각

Stripe 계정을 설정해 두면 다양한 결제 플러그인과의 연동이 한결 수월해집니다. 다양한 결제 수단 지원, 높은 보안성, 종량제 요금 구조라는 장점도 있습니다.

플러그인 선택에 대해 말씀드리면, 사이트 전체를 한곳에서 관리할 수 있다는 점에서 WooCommerce Payments를 추천합니다.

다만 어떤 결제 게이트웨이를 설치하기 전에 BlogVault로 사이트를 백업해 두는 것을 권장합니다. 자동 백업을 지원하는 빠르고 간편한 플러그인입니다. 여러분의 WooCommerce 사이트 운영을 응원합니다.

자주 묻는 질문

Checkout Plugins으로 Google Pay나 Apple Pay를 설정하는 방법은?

Google Pay나 Apple Pay 설정에는 Checkout Plugins이라는 별도 플러그인이 필요합니다.

  • 플러그인 디렉터리에서 해당 플러그인을 찾습니다.
  • 설치·활성화한 후 플러그인을 Stripe 계정에 연결합니다.
  • 게이트웨이 활성화 페이지로 이동되면 Stripe Card를 켜고 Enable Gateways를 선택합니다.
  • 익스프레스 체크아웃과 웹훅 활성화 옵션은 건너뜁니다.
  • Let's Customise 버튼을 클릭하면 WooCommerce 내 WordPress 대시보드로 돌아옵니다.
  • Express Checkout 탭을 클릭하고 체크박스를 선택해 활성화합니다.
  • 익스프레스 체크아웃 버튼과 사이트 내 표시 위치를 커스터마이즈합니다.
  • '변경 사항 저장'을 선택하면 완료됩니다.
  • 고객이 Apple 기기로 구매하면 Apple Pay 버튼이, 그 외에는 Google Pay 버튼이 표시됩니다.

WooCommerce에 가장 좋은 결제 게이트웨이는?

WooCommerce Payments, PayPal Zettle, Amazon Pay, PayFast, Authorize.net, Square 등이 가장 인기 있는 결제 게이트웨이입니다. WooCommerce 결제 게이트웨이 목록을 깊이 있게 다룬 아티클을 통해 자신에게 맞는 최적의 선택을 찾아보세요.

웹훅(webhook)이란?

웹훅은 웹 애플리케이션 간에 서로 통신하는 방식입니다. 커스텀 콜백으로 웹 애플리케이션의 동작을 변경하며, 쉽게 말해 특정 이벤트가 발생했을 때 한 애플리케이션에서 다른 애플리케이션으로 정보와 데이터를 전송합니다. 예를 들어 charge.failed 이벤트를 활성화해 두면, 결제가 실패했을 때 Stripe가 WooCommerce 사이트에 알려줍니다.

API 키란?

API는 Application Programming Interface(애플리케이션 프로그래밍 인터페이스)의 약자입니다. API 키는 웹 애플리케이션이 생성하는 코드로, 사이트에 접근하려는 사용자나 개발자를 식별하는 역할을 합니다.