Stripe Terminal 결제 게이트웨이
Stripe Terminal을 사용하면 계산대에서 Stripe 카드 리더기로 결제를 받을 수 있습니다. 계산대가 리더기로 금액을 전송하면 고객이 카드를 대거나 삽입하거나 긁습니다. Stripe에서 결제 금액을 매입하고 남은 결제 금액이 없으면 판매가 완료됩니다. 이 페이지에서는 최초 설정부터 각 계산대의 리더기 연결, 첫 결제까지 안내합니다.
이미 설정을 마쳤나요? 이 계산대에 리더기를 연결하거나 결제를 받으세요.
Stripe Terminal에는 WCPOS Pro 2.0.0 이상이 필요합니다. WCPOS Pro가 없으면 확장 프로그램이 작동하지 않습니다.
리더기 선택
Stripe는 세 가지 종류의 리더기를 판매합니다. 계산대에서 사용할 수 있는 종류는 POS를 실행하는 환경에 따라 다릅니다.
- 스마트 리더기 — 브라우저, 데스크톱 앱, iPhone, iPad, Android 등 모든 계산대에서 사용할 수 있습니다. Stripe Reader S700 및 S710, BBPOS WisePOS E가 해당합니다. 네트워크에 연결되며 매장에서 리더기로 결제를 전송합니다.
- Bluetooth 리더기 — iOS 및 Android 앱에서만 사용할 수 있습니다. Stripe Reader M2, BBPOS WisePad 3가 해당합니다. 휴대폰이나 태블릿과 페어링합니다.
- Tap to Pay — 앱 업데이트를 통해 iOS 및 Android 앱에 제공될 예정입니다. 별도의 리더기 없이 고객이 휴대폰에 직접 카드를 댑니다.
브라우저와 데스크톱 앱은 Bluetooth 리더기나 휴대폰의 비접촉 결제 칩에 접근할 수 없으므로 스마트 리더기를 사용합니다. Stripe 대시보드의 Terminal 상점에서 리더기를 구매하세요.
Stripe는 미국에서 Stripe Reader M2를, 영국, 유럽, 캐나다, 호주 등 미국 외 국가에서는 BBPOS WisePad 3를 판매합니다. Terminal 상점에서 해당 지역의 리더기를 확인하세요.
결제 게이트웨이 설정
관리자가 WP Admin에서 매장별로 한 번 설정합니다.
- 확장 프로그램을 설치하세요. GitHub의 릴리스 첨부 파일에서 플러그인 ZIP 파일인
stripe-terminal-for-woocommerce.zip을 다운로드한 뒤,플러그인 > Add Plugin에서 플러그인 업로드를 선택해 업로드하세요. GitHub의 "Source code" ZIP 파일로는 설치할 수 없습니다. - 키를 추가하세요.
WP Admin > WooCommerce > 설정 > 결제로 이동해 Stripe Terminal을 열고 라이브 비밀 키를 붙여넣으세요. 먼저 테스트하려면 테스트 비밀 키도 입력하세요. 두 키 모두 Stripe 대시보드에서 가져옵니다. 저장된 키는 점으로 표시되며 *(저장됨; 유지하려면 비워 두세요)*라는 안내가 나타납니다. - Bluetooth 리더기와 Tap to Pay에 사용할 Terminal 위치를 선택하세요. Stripe 대시보드의 Terminal → 위치에서 테스트 모드와 라이브 모드에 각각 하나씩 생성한 다음, Terminal 위치(테스트) 와 Terminal 위치(라이브) 로 선택하세요.
- POS 연결에서 이 매장에서 허용할 리더기를 선택하세요. 스마트 리더기, Bluetooth 리더기 및 Tap to Pay 또는 둘 다 선택할 수 있습니다. 앱에서 Bluetooth 리더기나 Tap to Pay를 사용하려면 Bluetooth 리더기 및 Tap to Pay를 선택하고 스마트 리더기는 선택 해제하세요. 스마트 리더기, Bluetooth 또는 둘 다 사용을 참고하세요.
- 설정을 저장한 뒤, 아래 웹훅 행에 서명 비밀 키가 저장되었습니다. 라는 문구가 표시되는지 확인하세요.
- POS에서 활성화하세요.
WP Admin > POS > 설정 > 결제로 이동해 Stripe Terminal을 켜고 저장하세요. WooCommerce 자체 결제 목록에서는 활성화할 필요가 없습니다. 결제 설정을 참고하세요.
위치를 선택하지 않으면 Bluetooth 리더기나 Tap to Pay를 연결할 수 없으며, 계산대에 *모바일 리더기를 연결하기 전에 Stripe Terminal 설정에서 Terminal 위치를 선택하세요.*라는 안내가 표시됩니다.
결제 게이트웨이 페이지의 모든 설정
- 제목 및 설명 — 고객에게 표시되는 이름과 설명 문구입니다. 계산대 타일에는 제목이 표시됩니다.
- 라이브 비밀 키 및 테스트 비밀 키 — Stripe 대시보드에서 가져옵니다.
- 기본 단말기 — 계산대에서 다른 리더기를 선택하기 전까지 결제에 사용하는 스마트 리더기입니다.
- 활성화된 단말기 — 계산대에서 선택한 스마트 리더기만 사용하도록 제한합니다. 계정의 모든 리더기를 허용하려면 비워 두세요.
- 단말기 선택 잠금 — 캐셔가 POS 결제 시 단말기를 변경할 수 없습니다. 기본 단말기를 지정해야 합니다.
- POS 연결 — 계산대에서 사용할 수 있는 리더기 종류입니다. *스마트 리더기(매장에서 네트워크를 통해 리더기를 제어)*와 *Bluetooth 리더기 및 Tap to Pay(POS 앱에서 리더기를 제어)*가 있습니다. 스마트 리더기, Bluetooth 또는 둘 다 사용을 참고하세요.
- Terminal 위치(테스트) 및 Terminal 위치(라이브) — 앱에서 Bluetooth 리더기와 Tap to Pay를 연결할 때 등록하는 위치입니다.
- 테스트 모드 — 테스트 모드 활성화. HTTPS를 사용하지 않는 사이트는 테스트 모드로 유지됩니다. Stripe Terminal에서 실제 결제를 받으려면 HTTPS가 필요합니다.
- Phone Orders (MOTO) — Stripe Terminal을 통한 전화 주문 결제를 사용 설정합니다. 전화 주문(MOTO)을 참조하세요.
- 리더기 준비 상태 유지(실험적) — 한동안 사용하지 않은 후 첫 결제가 지연되지 않도록 리더기에 주기적으로 신호를 보냅니다. 여러 계산대가 리더기 하나를 공유하는 경우에는 권장하지 않습니다.
입력란 아래에는 Stripe Terminal 위치 목록과 웹훅 행이 표시됩니다.
스마트 리더기, Bluetooth 또는 둘 다 사용
POS 연결은 매장 설정으로, 모든 계산대에서 사용할 리더기 종류를 결정합니다.
- 스마트 리더기만 선택: 모든 계산대에서 스마트 리더기로 결제합니다.
- Bluetooth 리더기 및 Tap to Pay만 선택: iOS 및 Android 앱에서 Bluetooth 리더기나 휴대폰으로 결제합니다. 브라우저나 데스크톱 계산대에서는 Stripe 타일이 … 지금은 사용할 수 없음 아래에 접힌 상태로 표시되며, *이 결제 수단은 앱의 리더기만 허용합니다. 이 계산대에서 결제하려면 해당 WooCommerce 설정 페이지에서 스마트 리더기를 허용하세요.*라는 안내가 나타납니다.
- 둘 다: 계산대에서 스마트 리더기를 사용합니다. 스마트 리더기를 선택 해제하기 전까지는 Bluetooth 리더기와 Tap to Pay를 사용하지 않습니다.
리더기 종류 변경 또는 업그레이드
리더기 종류를 선택 해제하면 이후 결제에 사용할 리더기만 바뀝니다. 모든 결제의 환불은 스마트 리더기든 앱이든 원래 결제에 사용한 연결을 통해 처리되며, Stripe 웹훅도 계속 작동합니다. 이전 버전에서 업그레이드하면 저장된 연결이 유지됩니다. 기본 단말기만 저장되어 있었다면 스마트 리더기가 유지됩니다. 새로 설치하면 두 종류가 모두 선택되어 있으므로 스마트 리더기를 선택 해제하기 전까지 앱에서도 스마트 리더기를 사용합니다.
이 계산대에 리더기 연결
계산대마다 사용할 리더기를 따로 기억합니다. POS의 사이드 메뉴 하단에서 설정을 누른 다음 카드 리더기를 누르세요.

- 이 매장에 설정된 카드 리더기가 없습니다 — 이 계산대에서 사용할 수 있는 리더기 종류로 결제 게이트웨이를 설정하기 전까지 표시되는 문구입니다. 설정을 마치면 아래에 설명된 리더기 섹션 중 이 계산대에서 사용할 수 있는 섹션이 대신 나타납니다. 브라우저나 데스크톱 계산대에는 스마트 리더기만 표시됩니다.
스마트 리더기
각 스마트 리더기에 표시된 코드로 Stripe 대시보드에 리더기를 등록하세요. 등록하기 전에는 기본 단말기, 활성화된 단말기 또는 계산대에 표시되지 않습니다.
스마트 리더기 섹션에는 매장에서 허용한 리더기마다 행이 하나씩 표시됩니다. 리더기 이름 옆에는 결제 게이트웨이 이름이, 아래에는 Terminal 위치와 온라인 또는 오프라인 상태가 표시됩니다. 계산대는 선택됨으로 표시된 행의 리더기로 결제합니다. 변경하려면 온라인 상태인 다른 리더기의 이 리더기 사용을 누르세요. 이후에는 해당 리더기로 결제합니다.
어떤 리더기가 자동으로 사용되나요?
- 아직 선택하지 않은 경우: 기본 단말기가 온라인 상태이고 사용 중이 아니면 계산대에서 해당 단말기를 사용합니다.
- 매장에 스마트 리더기가 하나뿐인 경우: 따로 선택할 필요가 없습니다. 해당 리더기가 온라인 상태이고 다른 판매에 사용 중이 아니면 계산대에서 이 리더기로 결제합니다.
- 매장에서 지정한 경우: 단말기 선택 잠금이 적용된 기본 단말기를 사용합니다. 온라인 상태인 동안 모든 계산대에서 선택됨으로 표시되며, 어느 행에도 이 리더기 사용이 표시되지 않습니다.
Bluetooth 리더기
iOS 또는 Android 앱에서 다음과 같이 진행하세요.
- 리더기를 켜고 휴대폰이나 태블릿 가까이에 두세요.
- 설정 → 카드 리더기에서 리더기 연결을 누르세요. 매장에 리더기 결제 게이트웨이가 여러 개 있으면 사용할 게이트웨이를 묻습니다. 리더기 연결에 사용할 게이트웨이에서 Stripe Terminal을 선택하세요.
- 행에 *리더기를 찾는 중… 리더기를 켜고 이 기기 가까이에 두세요.*가 표시된 다음, 리더기 1개를 찾았습니다. 사용하려는 리더기인가요? 또는 *리더기 3개를 찾았습니다. 어느 리더기를 사용하시겠어요?*가 나타납니다. 사용할 리더기 옆의 연결을 누르세요.
- 처음 연결할 때 리더기 소프트웨어 업데이트가 설치됩니다. 행에 진행률 표시줄과 함께 리더기 소프트웨어 설치 중이 표시되고, *리더기를 켜 두고 충분히 충전된 상태로 유지하세요. 첫 업데이트는 약 10분이 걸립니다.*라는 안내가 나타납니다. 시작하기 전에 리더기를 절반 이상 충전하고, 이 화면을 유지하세요.
- 행에 연결됨과 리더기 배터리 잔량이 표시됩니다. 예를 들면 연결됨 · 80% 입니다.
이후에는 연결에 몇 초만 걸리며, 다음 판매 시 계산대가 같은 리더기에 다시 연결됩니다. 연결된 리더기가 없으면 Bluetooth 리더기 섹션에 *아직 연결된 리더기가 없습니다. 리더기를 켜고 이 휴대폰 가까이에 두세요.*가 표시됩니다.
Tap to Pay
Tap to Pay는 앱 업데이트를 통해 iOS 및 Android 앱에 제공될 예정입니다. 앱에 이 기능이 추가되면 다음과 같이 사용할 수 있습니다. iOS 또는 Android 앱을 실행하는 휴대폰의 이 휴대폰 섹션에 Tap to Pay on iPhone 또는 Tap to Pay on Android 행이 표시됩니다. 매장 관리자나 관리자는 Tap to Pay 설정을 누르세요. 그 외 사용자에게는 설정되지 않음 · 관리자에게 문의하세요가 표시됩니다.
처음에는 휴대폰에서 서비스 제공업체의 약관에 동의하라는 안내가 표시됩니다. iPhone에서는 Apple이 Apple ID 연결과 Tap to Pay 약관 동의를 요청합니다. 설정을 마치면 행에 준비됨이 표시됩니다. Tap to Pay로 결제를 받으려면 네트워크 연결이 필요합니다.
리더기 행에 표시되는 상태
각 리더기 행에는 리더기 이름, 일련번호, Terminal 위치와 한 줄의 상태가 표시됩니다.
- 연결됨 · 80% — 결제를 받을 준비가 되었다는 뜻이며 배터리 잔량도 표시됩니다. Tap to Pay에는 준비됨이 표시됩니다.
- 연결되지 않음 — 계산대에 이 리더기가 저장되어 있지만 현재 연결되어 있지 않습니다. 연결을 누르세요.
- …에 연결 중 — 잠시 기다리세요. 버튼에는 연결 중… 이 표시됩니다.
- 리더기 소프트웨어 설치 중 — 업데이트 중입니다. Bluetooth 리더기의 4단계를 참고하세요.
- 리더기를 찾지 못했습니다. 리더기를 켜고 다시 시도하세요. — 다시 시도를 누르거나, 리더기 안내를 보려면 리더기가 보이지 않나요? 를 누르세요.
- 연결하지 못했습니다: … — 뒤에 Stripe에서 제공한 이유가 표시됩니다. 다시 시도 또는 도움말을 누르세요.
- 리더기를 연결하려면 Bluetooth를 켜세요. — 이 기기의 Bluetooth가 꺼져 있습니다.
- 앱 설정에서 리더기 접근을 허용하세요. — 앱에 Bluetooth 사용 권한이 부여되지 않았습니다. 휴대폰 설정에서 허용하세요.
행 옆의 ⋮ 메뉴에는 등록 해제가 있습니다. 이를 선택하면 다음 판매 시 계산대가 해당 리더기에 자동으로 다시 연결하지 않습니다. 이 페이지에서 다시 연결할 수 있습니다. 연결된 행의 연결 해제 버튼은 현재 리더기 연결을 끊습니다. 앱이 리더기를 계속 점유하여 사용할 수 없는 경우에는 메뉴에 리더기 점유 해제도 표시됩니다.
실제 사용 전 테스트
결제 게이트웨이 설정 페이지(WP Admin > WooCommerce > 설정 > 결제 > Stripe Terminal)에서 테스트 모드를 선택하고 저장하세요. 그러면 결제가 Stripe 테스트 계정으로 전송되며 실제 금액은 이동하지 않습니다. 결제 받기의 단계에 따라 테스트 판매를 진행하세요.
- 스마트 리더기: Stripe 테스트 계정에 등록한 가상 리더기가 실제 리더기와 함께 표시되므로, 하드웨어 없이 판매를 테스트할 수 있습니다.
- Bluetooth 리더기 및 실제 스마트 리더기: Stripe 대시보드의 Terminal 상점에서 주문한 Stripe 실물 테스트 카드로 결제하세요. 금액의 마지막 두 자리에 따라 결과가 결정됩니다.
.00은 승인,.05는 거절이며,.02는 PIN1234입력을 요청합니다.
테스트가 끝나면 실제 결제를 받기 전에 테스트 모드를 선택 해제하고 저장하세요.
결제 받기
계산대 열기 및 닫기가 켜져 있으면 계산대가 닫힌 동안에는 결제가 기록되지 않으며, 이미 받은 카드 결제는 환불해야 합니다. 계산대 열기를 참고하세요.
-
장바구니에 상품을 담고 결제를 누르세요.
-
결제 수단 패널에서 Stripe Terminal 타일을 누르세요.
-
리더기를 확인하세요. 스마트 리더기에는 단말기: … 가 표시되며, 매장에서 허용한 경우 변경을 눌러 다른 리더기를 선택할 수 있습니다. Bluetooth 리더기에는 연결됨 · 80% 가 표시되거나, 연결된 리더기 없음과 함께 설정 → 카드 리더기 링크가 표시됩니다.
-
…을 Stripe Terminal로 전송을 누른 다음 고객이 결제하도록 안내하세요.
- 스마트 리더기: 고객이 리더기에 카드를 대거나 삽입하거나 긁는 동안 계산대에는 단말기에서 고객 결제 대기 중이 표시됩니다.
- Bluetooth 리더기: 계산대에 리더기에 카드를 대세요가 표시됩니다.
- Tap to Pay: 휴대폰에 자체 Tap to Pay 화면이 나타나며, 고객이 카드나 자신의 휴대폰을 매장 휴대폰에 댑니다.
계산대에서 전송됨, 단말기 수신됨, 승인됨, 매입됨 단계가 차례로 완료 표시됩니다.
-
남은 결제 금액이 없으면 영수증 화면이 열립니다. 영수증을 인쇄하거나 이메일로 보낸 다음 새 판매를 누르세요. 결제 완료 확인을 참고하세요. 결제할 금액이 일부 남았다면 다른 수단으로 받으세요. 분할 결제를 참고하세요.
중단하려면 단말기에서 취소를 누르세요. 카드가 거절되면 결제 실패: … 와 함께 다시 시도, 다른 결제 수단 선택이 표시됩니다. 카드 리더기로 결제를 참고하세요.
이 타일에서는 카드 정보를 입력할 수 없습니다. 전화 주문은 전화 주문(MOTO)을 참조하세요.
고객이 리더기에서 추가한 팁은 주문에 팁 수수료 항목으로 반영됩니다. WisePad 3, WisePOS E, S700, S710은 팁을 요청할 수 있지만 M2는 지원하지 않습니다. Stripe 대시보드에서 리더기의 팁 기능을 켜세요.
전화 주문(MOTO)
MOTO(우편 주문 및 전화 주문)는 현장에 없는 고객의 카드 결제를 처리하는 방식입니다. 카드를 탭하는 대신 카드 번호, 만료일, 보안 코드를 리더기 화면에 입력합니다. 전화 주문은 Stripe 전용 패널에서 결제 화면의 레거시 탭으로만 처리할 수 있습니다. 결제 탭의 Stripe Terminal 타일에서는 카드 정보를 입력할 수 없습니다.
다음 세 가지 조건을 모두 충족해야 전화 주문 스위치가 표시됩니다:
- Stripe에서 계정의 MOTO 기능을 사용 설정해야 합니다. 기본적으로 사용 설정되어 있지 않으므로 Stripe 지원팀에 문의하세요.
- 전화 주문(MOTO)을 선택하세요.
WP Admin > WooCommerce > 설정 > 결제 > Stripe Terminal로 이동해 전화 주문(MOTO) 을 선택하고 저장하세요. - S700, S710 또는 WisePOS E 스마트 리더기를 사용하세요. Stripe 패널에서 이 중 하나를 연결하면 스위치가 표시됩니다. P400, M2, WisePad 3, Tap to Pay 또는 시뮬레이션 리더기에서는 표시되지 않습니다.
전화 주문(MOTO) 을 선택하면 전화 주문뿐 아니라 레거시 탭에서 처리하는 모든 Stripe Terminal 결제에 Stripe 전용 패널이 일반 패널 대신 표시됩니다. 선택 해제하면 레거시 탭에 단말기 선택기와 단말기로 전송, 취소, 다시 시도가 표시되고, 결제 패널에서 처리한 결제처럼 기록됩니다.
전화 주문을 처리하려면:

- 레거시 — 계산대 안에 매장 자체 결제 페이지를 표시하는 탭입니다.
- 매장의 결제 페이지 — 여기에서 Stripe Terminal을 선택한 다음 아래로 스크롤해 사용 가능한 리더기, 연결, 전화 주문을 찾으세요.
- 결제 처리 — 다른 레거시 결제와 마찬가지로 페이지 아래에 있는 계산대 버튼입니다. 전화 주문은 페이지의 단말기로 결제를 눌러 시작합니다.
- 결제를 누르고 레거시 탭을 연 다음 Stripe Terminal을 선택하세요.
- 사용 가능한 리더기에서 사용할 리더기의 연결을 누르세요.
- 전화 주문을 켜세요.
- 단말기로 결제를 누르세요. 리더기에서 카드를 대라는 안내 대신 카드 정보 입력 화면이 표시됩니다.
- 리더기에 카드 번호, 만료일, 보안 코드를 입력하세요.
Stripe는 전화 주문을 카드 비대면 결제로 처리하므로, 대면 카드 결제 요율과 그에 따른 부정 사용 책임 이전이 적용되지 않습니다.
문제가 발생한 경우
리더기가 연결되지 않습니다. 스마트 리더기는 Wi-Fi나 이더넷에 연결되어 있어야 하며, Stripe 대시보드에 등록되어 온라인 상태여야 합니다. Bluetooth 리더기는 iOS 또는 Android 앱이 필요하며, Bluetooth가 켜져 있고 앱에 Bluetooth 사용 권한이 부여되어 있어야 합니다.
"Terminal 위치를 선택하세요…". 결제 게이트웨이의 현재 모드인 테스트 또는 라이브 모드에 Terminal 위치가 지정되지 않았습니다. 결제 게이트웨이 설정의 3단계를 참고하세요.
처음 연결하는 데 너무 오래 걸립니다. 리더기 소프트웨어 업데이트 때문이며, 약 10분이 걸립니다. 리더기를 켜 두고 충분히 충전된 상태로 유지하며, 이 화면에서 기다리세요. 다음 연결부터는 몇 초만 걸립니다.
Stripe 타일에 사용할 수 없다고 표시됩니다. 브라우저나 데스크톱 계산대에서 매장이 앱용 리더기만 허용한 경우입니다. 스마트 리더기, Bluetooth 또는 둘 다 사용을 참고하세요. 오프라인 상태에서는 카드 리더기가 네트워크 연결을 기다립니다. 오프라인 모드를 참고하세요.
카드 리더기에 이 매장에서는 앱의 리더기만 허용됩니다. 메시지가 표시됩니다. 브라우저나 데스크톱 POS에서 같은 원인으로 발생합니다. POS 연결에서 스마트 리더기를 허용하거나 iOS 또는 Android 앱을 사용하세요. 스마트 리더기, Bluetooth 또는 둘 다 사용하기를 참고하세요.
카드가 거절됩니다. 다른 카드나 결제 수단을 요청하세요. 테스트 모드에서는 금액의 마지막 두 자리를 확인하세요.
전화 주문 스위치가 표시되지 않음. 전화 주문은 Stripe Terminal 타일이 아니라 레거시 탭에서만 처리됩니다. 전화 주문(MOTO) 이 선택되어 있고 S700, S710 또는 WisePOS E에 연결되어 있으며 시뮬레이션 리더기가 아닌지 확인하세요.
전화 주문 결제가 실패합니다. Stripe에서 아직 계정의 MOTO를 활성화하지 않았거나 카드 정보를 잘못 입력한 경우입니다.
아직 해결되지 않았나요? GitHub에 버그를 신고하거나, 리더기에 관한 Stripe Terminal 문서를 확인하거나, 계정 문제에 대해 Stripe 지원팀에 문의하세요.