# WooCommerce 스토어를 위한 결제 게이트웨이

Source: https://support.kapsulehost.com/ko-kr/site-payments

Payments 탭에는 WooCommerce 스토어에서 사용할 수 있는 결제 게이트웨이가 나열되며, 어떤 게이트웨이가 설치되어 있고 어떤 게이트웨이가 켜져 있는지 보여줍니다. 또한 원클릭 설치 및 활성화 기능을 제공하므로 결제 수단이 전혀 없는 스토어를 몇 분 만에 카드 결제를 받는 스토어로 전환할 수 있습니다.

## Payments 탭 위치

**웹사이트**를 열고 스토어를 클릭한 다음, 사이트 왼쪽 메뉴에서 **WordPress** 그룹을 열고 **결제**를 선택합니다. 페이지 제목은 **결제 게이트웨이**입니다.

이 탭은 WooCommerce 사이트로 생성된 사이트에서만 표시됩니다. 사이트가 일반 WordPress 설치인 경우 메뉴 항목이 표시되지 않으며, 그래도 해당 페이지에 접근하면 게이트웨이 목록 대신 업그레이드 배너가 표시됩니다. 페이지 상단 사이트 이름 옆의 스택 표시를 확인하면 사이트가 어떻게 분류되어 있는지 알 수 있습니다.

![KPanel의 WooCommerce 스토어용 결제 게이트웨이 페이지](https://support.kapsulehost.com/help/screenshots/site-payments.23b0b42c.webp)

## 제공되는 게이트웨이

| 게이트웨이 | 처리 대상 |
|---|---|
| Stripe | 카드, Apple Pay, Google Pay |
| PayPal | PayPal 및 카드 |
| Afterpay | 선구매 후결제(Buy now, pay later) |
| POLi | 뉴질랜드 계좌 이체 |
| Windcave | 뉴질랜드 카드 결제 및 EFTPOS |

뉴질랜드 가맹점에 특히 중요한 게이트웨이에는 목록에 **NZ** 표시가 붙습니다.

> **Note:** Apple Pay와 Google Pay는 별도의 게이트웨이가 필요하지 않습니다. 이들은 Stripe에 포함되어 있으며, 패널에도 Stripe 행에 그렇게 안내되어 있습니다. Stripe를 활성화하는 것만으로 충분합니다.

## 상태 표시 읽는 법

각 행에는 다음 세 가지 상태 중 하나가 표시됩니다.

- **Connected**(녹색): 플러그인이 설치되어 활성화된 상태입니다. 결제 과정에 참여하고 있습니다.
- **Installed**(주황색): 플러그인이 사이트에 있지만 꺼져 있는 상태입니다. 고객에게 표시되지 않습니다.
- **Available**(회색): 플러그인이 아직 설치되지 않은 상태입니다.

WooCommerce 스토어가 프로비저닝될 때 대부분의 게이트웨이는 사전 설치되어 있지만 비활성화 상태이며, 이는 의도된 것입니다. 자격 증명 없이 활성화된 게이트웨이는 결제 과정을 망가뜨릴 수 있으므로, 직접 켜기 전까지는 아무것도 활성화되지 않습니다.

## 게이트웨이 활성화하기

1. 목록에서 게이트웨이를 찾습니다.
2. 이미 설치되어 있다면 **Enable**을, 설치되어 있지 않다면 **설치 및 활성화**를 클릭합니다.
3. 상태 표시가 녹색으로 바뀌어 **Connected**로 표시될 때까지 기다립니다.
4. **Configure**를 클릭합니다.

**Configure**를 클릭하면 새 탭에서 스토어의 WordPress 관리자 안에 있는 해당 게이트웨이의 자체 설정 페이지가, 이미 올바른 화면에서 열립니다. 바로 여기에서 계정 자격 증명, 즉 결제 제공업체로부터 발급받은 API 키, 가맹점 ID, 계좌번호를 입력합니다.

> **Warning:** 표시가 Connected라고 해서 해당 게이트웨이가 실제로 결제를 받고 있는 것은 아닙니다. Connected는 플러그인이 활성화되어 있다는 뜻일 뿐, 설정이 완료되었다는 뜻은 아닙니다. WooCommerce에 본인의 계정 자격 증명을 입력하고 실제 테스트 주문을 완료하기 전까지는 결제 과정이 아직 끝나지 않은 것으로 간주하십시오.

## 직접 설치해야 하는 게이트웨이

모든 게이트웨이가 WordPress 플러그인 디렉터리를 통해 배포되는 것은 아닙니다. Windcave가 그런 경우로, 해당 행에는 설치 버튼 대신 공급업체의 자체 다운로드 페이지로 이동하는 **플러그인 받기** 버튼이 표시됩니다.

이 경우 순서는 다음과 같습니다.

1. **플러그인 받기**를 클릭하여 공급업체로부터 플러그인을 다운로드합니다.
2. 스토어의 WordPress 관리자에서 Plugins로 이동한 다음 Add New로 들어가 파일을 업로드합니다.
3. 그곳에서 활성화합니다.
4. Payments 탭으로 돌아와 **Configure**를 클릭해 해당 설정 화면으로 이동합니다.

설치가 완료되면 다른 게이트웨이와 마찬가지로 일반적인 상태 표시와 함께 나타납니다.

## 게이트웨이 끄기

**Connected** 상태인 행에서 **Disable**을 클릭합니다. 플러그인은 설치된 상태로 유지되지만 더 이상 활성화되지 않으므로, 즉시 결제 화면에서 사라지고 표시는 다시 **Installed**로 바뀝니다.

제공업체 측 계정 문제를 해결하는 동안처럼 결제 수단을 일시적으로 중단할 때는 삭제 대신 비활성화를 사용하십시오. 설정이 그대로 유지되므로, 나중에 다시 활성화할 때 자격 증명을 다시 입력할 필요가 없습니다.

## 어떤 것을 켤지 선택하기

게이트웨이가 많다고 무조건 좋은 것은 아닙니다. 결제 화면의 선택지가 많아질수록 고객이 내려야 할 결정도 늘어나고, 정산해야 할 계정도 늘어납니다.

뉴질랜드에서 흔한 구성은 카드 결제 수단 하나에 대안 결제 수단 하나를 더하는 방식입니다.

- **카드**: Stripe 또는 Windcave. 추가 작업 없이 Apple Pay와 Google Pay를 사용하고 싶다면 Stripe가 더 빠른 방법입니다. 이미 이들을 통해 EFTPOS나 가맹점 계약을 맺고 있다면 Windcave를 살펴볼 만합니다.
- **대안 결제 수단 하나**: 친숙함을 원한다면 PayPal, 장바구니 금액이 할부에 적합하다면 Afterpay, 고객이 계좌에서 바로 결제하는 것을 선호한다면 POLi.

활성화한 각 결제 수단은 공지하기 전에 실제 소액 주문으로 테스트하십시오. 모든 제공업체에는 테스트 모드 또는 샌드박스 모드가 있으니 이를 사용한 뒤, 실제 거래를 한 번 진행하고 환불 처리하십시오.

## 문제 해결

**플러그인 상태를 읽을 수 없다는 경고가 표시됩니다.** 패널은 WordPress에 직접 어떤 플러그인이 설치되어 있고 활성화되어 있는지 확인합니다. 사이트가 점검 모드이거나 오류가 발생하는 등의 이유로 WordPress가 응답하지 못하면, 목록에는 상태가 불완전할 수 있다는 주의 문구와 함께 표시됩니다. 근본적인 사이트 문제를 해결한 다음 새로고침하십시오. [오류 로그](https://support.kapsulehost.com/ko-kr/error-logs)와 [WordPress 흰 화면](https://support.kapsulehost.com/ko-kr/wordpress-white-screen) 문서가 다음으로 확인할 만한 자료입니다.

**목록이 비어 있습니다.** 스토어에서 인식된 게이트웨이 플러그인이 보고되지 않은 경우입니다. 사이트에 WooCommerce 자체가 설치되어 활성화되어 있는지 확인하십시오.

**목록 대신 업그레이드 배너가 표시됩니다.** 해당 사이트가 WooCommerce 사이트로 등록되어 있지 않은 경우입니다. 이는 사이트의 속성이며 이 화면에서 전환할 수 있는 항목이 아닙니다.

**Enable은 성공했지만 게이트웨이가 결제 화면에 나타나지 않습니다.** 거의 대부분 자격 증명이 누락되었거나, KPanel에서는 게이트웨이가 활성화되었지만 WooCommerce 자체 설정 화면에서는 여전히 꺼져 있는 경우입니다. **Configure**를 열어 두 곳 모두 확인하십시오.

**카드 결제가 일반 오류와 함께 실패합니다.** 먼저 WooCommerce 안에 있는 게이트웨이 자체 로그를 확인한 다음, 사이트의 오류 로그를 확인하십시오. 실제(live) 키를 테스트 모드 입력란에 붙여넣었거나 그 반대인 경우가 가장 흔한 원인입니다.

## 다음으로 볼 만한 문서

- 더 넓은 스토어 설정에 대해서는 [KapsuleHost의 WooCommerce](https://support.kapsulehost.com/ko-kr/wordpress-woocommerce)를 참고하십시오.
- [사이트 활동 로그](https://support.kapsulehost.com/ko-kr/site-activity-log)에는 이 페이지에서 이루어진 모든 게이트웨이 변경 내역이 기록됩니다.
- 운영 중인 스토어에서 무언가를 변경하기 전에는 [백업 만들기](https://support.kapsulehost.com/ko-kr/taking-a-backup)를 참고하십시오.