GUIDE / 01
플러그인 방식이 맞는 사이트 — 워드프레스 · 우커머스 · 그누보드
플러그인 방식은 주문 기능을 제공하는 사이트에 결제 서비스를 추가하는 구조입니다. 워드프레스에서 쇼핑 기능을 운영한다면 우커머스 등 어떤 주문 시스템을 사용하는지부터 확인하고, 그누보드 계열에서도 실제 쇼핑 기능과 버전을 구분해 봅니다. 사이트 기반과 결제 모듈의 지원 범위가 맞아야 합니다. 같은 이름의 플러그인이 있더라도 개발 주체와 업데이트 상태, 지원하는 가맹점 계약은 다를 수 있습니다. 설치 화면의 인기 순위만 보고 선택하기보다 공식 제공 경로와 적용 조건을 확인해 주세요. 베스트페이가 현재 사이트 정보를 기준으로 확인할 항목을 정리합니다. 전체 흐름은 전자담배 사이트 카드결제 안내에서 함께 볼 수 있습니다.
사이트에 이미 다른 결제 모듈이 있다면 바꾸려는 이유와 유지할 기능을 적어 두면 좋습니다. 단순 카드결제 외에 부분 취소, 고객 알림, 주문 내역 표시를 어떤 모듈이 맡는지도 살펴봅니다. 설치 가능 여부와 운영에 필요한 기능은 따로 확인합니다. 사용하지 않는 플러그인이 남아 있으면 설정이 겹치거나 담당자가 혼동할 수 있으므로 현재 활성 기능을 목록으로 정리하세요. 제거와 교체는 기존 주문을 확인할 방법까지 준비한 뒤 담당자와 진행합니다. 실제 적용 방식은 선택한 모듈의 공식 안내와 현재 가맹점 조건을 기준으로 확인합니다.
- 사이트 버전, 주문 시스템, 결제 모듈 이름, 설치 출처, 최근 업데이트 상태를 기록해 두세요. 호환성을 문의할 때 필요한 기본 정보입니다.
- 쇼핑 기능이 없는 일반 소개 사이트라면 결제 플러그인만 설치해 주문 관리가 생기는지 먼저 확인합니다. 필요한 기능을 구분해 준비하세요.
GUIDE / 02
설치와 키 입력 — 관리자에서 하는 일
설치 전에는 현재 사이트와 설정을 복구할 수 있는지 확인하고 시험 환경을 준비합니다. 공식 경로에서 받은 모듈을 적용한 다음 관리자에서 요구하는 가맹점 정보와 키를 입력합니다. 시험용과 운영용 설정을 구분해 입력하는 것이 기본입니다. 키 종류와 입력 위치는 모듈 안내에 따르며, 다른 가맹점이나 예전 사이트의 정보를 섞지 않습니다. 설정 화면을 저장한 뒤 실제로 값이 반영됐는지 확인하고, 결과를 받는 주소나 추가 설정이 필요한 방식이라면 그 항목도 함께 점검합니다. 운영자는 접근 권한과 작업 담당자를 정해 두면 좋습니다.
키는 복사 과정에서 공백이 들어가거나 일부가 누락되지 않도록 확인하되 공개 문서에 기록하지 않습니다. 설치 화면을 다른 사람에게 보낼 때에도 비밀값이 보이지 않게 처리합니다. 필요한 담당자만 설정에 접근하도록 관리합니다. 설정을 마쳤다면 모듈을 활성화했다는 표시에서 끝내지 말고 고객 주문서에서 결제 수단이 나타나는지 확인하세요. 관리자 계정으로만 보이는 기능과 일반 고객에게 보이는 상태가 다를 수 있습니다. 베스트페이는 가맹점 적용 준비를 안내하고, 실제 모듈 설정은 해당 버전의 공식 설치 절차와 대조해 확인하도록 돕습니다.
| 시점 | 확인할 내용 | 남겨 둘 기록 |
|---|---|---|
| 설치 전 | 사이트 · 쇼핑 기능 · 지원 버전 | 모듈 출처와 현재 버전 |
| 키 적용 | 가맹점 일치 · 시험과 운영 구분 | 작업 환경과 담당자 |
| 화면 확인 | 결제 수단 · 모바일 · 비회원 | 고객 권한의 주문 화면 |
| 거래 점검 | 상태 · 재고 · 알림 · 취소 | 한 주문의 처리 결과 |
| 업데이트 | 백업 · 호환성 · 복구 경로 | 변경 버전과 시험 기록 |
- 설정 기록에는 입력한 비밀값 대신 적용한 환경과 작업 날짜, 담당자를 적습니다. 운영 전환 시 어떤 항목을 바꿨는지 추적하기 쉬워집니다.
- 처음 연결할 때에는 다른 설정을 한꺼번에 여러 개 바꾸지 않는 편이 좋습니다. 변경한 항목과 결과를 나누어 기록해 원인을 좁혀 주세요.

GUIDE / 03
결제 수단 노출과 기본 선택
플러그인을 설치한 뒤에는 어떤 결제 방법을 주문서에 보여 줄지 정합니다. 계약된 수단과 모듈이 지원하는 수단을 확인하고, 고객이 선택할 수 있는 이름을 알기 쉽게 표시합니다. 화면에 보이는 결제 방법이 실제 사용 가능한 범위와 같아야 합니다. 기본 선택을 카드로 둘지 고객이 직접 고르게 할지도 운영 방식에 맞춰 결정합니다. 무통장 입금을 함께 받는다면 입금 대기와 카드 승인 완료를 구분할 수 있어야 합니다. 현재 베스트페이 안내 기준으로 롯데카드는 제외되므로 최종 결제창과 사이트 안내에서 지원 범위를 맞춰 주세요.
주문서 디자인을 별도로 바꿨다면 모듈에서 추가한 입력 영역과 버튼이 제대로 표시되는지 확인합니다. 새 주문 블록이나 테마 전용 주문 화면은 지원 여부가 다를 수 있어 현재 구성을 기준으로 살펴봐야 합니다. PC와 모바일에서 실제 주문 경로를 각각 확인합니다. 접힌 안내나 고정 배너가 결제 선택을 가리지 않는지, 필수 입력 항목이 빠지지 않는지도 점검합니다. 회원과 비회원, 배송비가 있는 주문을 나누어 확인하면 차이를 찾기 쉽습니다. 고객이 결제창에서 돌아왔을 때 선택한 주문을 계속 확인할 수 있는지도 함께 봅니다.
- 결제 방법의 이름과 안내 문구는 고객에게 익숙한 표현으로 씁니다. 관리자용 서비스 코드나 기술 설정 이름을 그대로 노출하지 않습니다.
- 사용하지 않는 수단을 숨긴 뒤에는 주문서와 결제창에서 모두 반영됐는지 확인하세요. 사이트 안내 문구만 바꾸면 고객이 혼동할 수 있습니다.
GUIDE / 04
주문 상태 · 재고 · 알림 연결
결제가 승인되면 주문 상태가 적절하게 바뀌고 이후 출고 작업으로 이어져야 합니다. 모듈이 거래 결과를 받아 주문에 반영하는 범위와 쇼핑 시스템이 재고나 알림을 처리하는 범위를 구분해 봅니다. 한 주문의 결제 결과와 운영 상태가 같은 흐름으로 이어져야 합니다. 예를 들어 결제는 확인됐는데 주문이 대기로 남으면 운영자가 출고를 놓칠 수 있습니다. 반대로 미결제 주문에 알림이 잘못 나가면 고객 응대가 필요해집니다. 상태 이름은 시스템마다 다르므로 해당 사이트의 실제 처리 기준을 확인하고 담당자와 정리해 주세요.
주문 상태를 자동으로 바꾸는 다른 플러그인이 있다면 역할이 겹치는지 살펴봅니다. 모든 주문을 같은 상태로 옮기는 설정이 현재 배송 방식과 맞는지도 확인해야 합니다. 결제 완료와 배송 완료를 같은 뜻으로 사용하지 않습니다. 취소할 때 재고가 다시 반영되는지, 고객에게 어떤 알림이 가는지, 부분 취소가 지원되는지도 시험합니다. 베스트페이는 결제 연결에서 확인할 항목을 안내하고 운영자는 주문 관리자와 실제 업무를 대조합니다. 결과가 다르면 주문번호와 거래 내역, 발생 시각을 기록해 모듈 담당자가 확인할 수 있게 전달합니다.
- 주문 생성, 승인, 출고, 취소 때 각각 어떤 상태로 바뀌는지 표로 적어 두세요. 자동 처리되는 항목과 운영자가 눌러야 할 항목을 구분합니다.
- 알림과 재고 기능이 다른 확장 모듈에 있다면 함께 시험합니다. 결제 모듈 하나의 설정만 확인해서는 전체 운영 흐름을 알기 어렵습니다.
GUIDE / 05
테마 · 캐시 · SSL 충돌 — 자주 걸리는 것
테마나 캐시, 보안 접속 설정이 결제 흐름에 영향을 줄 때가 있습니다. 버튼이 보이지 않거나 결과 화면으로 돌아오지 않는다면 최근 변경한 항목과 발생 위치부터 확인해 주세요. 운영 사이트에서 여러 기능을 무작정 끄기보다 시험 환경에서 원인을 좁힙니다. 모듈과 테마의 지원 버전을 확인하고, 주문서 방식이 호환되는지도 살펴봅니다. 캐시가 이전 화면을 보여 주는지와 결과 수신이 막히는지 등은 증상에 따라 확인 범위가 달라집니다. 담당자가 재현할 수 있도록 주소와 기기, 오류 문구를 기록하는 것이 도움이 됩니다.
문제를 찾으려고 계속 실제 결제를 시도하기 전에 이미 처리된 거래가 있는지 조회합니다. 고객에게 보이는 실패 화면과 실제 거래 결과가 다를 수 있으므로 중복 결제가 생기지 않게 상태를 먼저 맞춥니다. 거래 결과를 확인한 다음 복구와 재시도를 결정합니다. 충돌 확인은 현재 사이트를 복구할 수 있는 준비가 된 상태에서 진행하고, 변경 항목을 하나씩 기록하세요. 로그를 전달할 때에는 키와 고객 개인정보를 제거합니다. 베스트페이는 신청과 가맹점 적용 상태에서 확인할 내용을 안내하고, 테마와 모듈 동작은 각 담당자의 공식 지원 범위에 맞춰 점검하도록 돕습니다.
- 증상 기록에는 마지막으로 정상 작동한 시점과 이후 바꾼 모듈, 테마, 설정을 적습니다. 원인을 추측해 바꾸기보다 변화 지점을 찾아보세요.
- 캐시를 비우거나 설정을 수정한 뒤에는 일반 고객 권한과 모바일에서도 확인합니다. 관리자에게만 정상으로 보이는 상태가 남지 않도록 합니다.
GUIDE / 06
업데이트와 백업 — 운영 중 지킬 것
업데이트는 새 기능을 추가하는 작업이면서 기존 연결과의 호환성을 다시 확인하는 작업입니다. 사이트와 주문 시스템, 결제 모듈의 버전 정보를 남기고 변경 전에 복구 가능한 백업을 준비합니다. 백업이 있다는 사실뿐 아니라 되돌리는 방법을 확인해야 합니다. 가능하면 시험 환경에서 같은 업데이트를 먼저 적용해 주문과 취소 흐름을 확인합니다. 운영 중인 사이트에서는 작업 시간을 정하고 담당자가 결과를 볼 수 있게 준비하세요. 업데이트 내용을 확인하지 않은 채 여러 모듈을 동시에 바꾸면 문제가 생겼을 때 어느 변경이 원인인지 찾기 어려워집니다.
변경 후에는 첫 화면뿐 아니라 상품 선택과 주문서, 인증 후 복귀, 관리자 상태 반영을 확인합니다. 기록에는 적용 날짜와 담당자, 바뀐 버전, 시험 주문 결과를 남겨 두세요. 결제와 주문을 함께 점검한 뒤 변경을 완료한 것으로 봅니다. 이전 주문의 조회와 취소 기능도 필요한 범위에서 확인합니다. 지원이 중단된 모듈을 계속 쓰고 있다면 대체할 경로와 데이터 관리 범위를 검토해야 할 수 있습니다. 베스트페이는 사이트 운영자가 어떤 질문을 준비하면 되는지 안내하며, 유지 보수와 장애 대응 책임은 실제 계약 범위에 맞춰 분명하게 정리하도록 돕습니다.
- 백업 날짜와 복구 담당자, 시험 결과를 같은 문서에 남겨 두세요. 문제가 생겼을 때 이전 상태가 무엇인지 바로 확인할 수 있습니다.
- 업데이트 후 일정 기간은 결제 완료와 취소 관련 문의를 따로 살펴보면 좋습니다. 변경 직후 나타난 예외를 기록해 담당자에게 전달하세요.

