우커머스 pg 연결하려면 이 순서로 설정하세요
얼마 전 결제가 끝났는데 주문은 계속 ‘결제 대기’로 남는 쇼핑몰을 봤습니다. 카드 승인은 났고 고객에게 문자도 갔는데, 운영자는 주문이 들어온 줄 몰랐죠. 우커머스 pg를 연결할 때 결제창이 뜨는지만 확인하면 이런 일이 생깁니다. 계약, 플러그인, 주문 상태 반영까지 한 흐름으로 점검해야 합니다.
처음부터 결제수단을 많이 열 필요는 없습니다. 카드 결제 하나를 안정적으로 붙이고, 실제 주문과 취소가 맞물리는지 확인한 뒤 필요한 수단을 추가하는 편이 운영하기 쉽습니다.
PG를 고르기 전에 판매 방식부터 확인하세요
국내 고객에게 원화로 판매한다면 카드 결제가 기본입니다. 가상계좌는 입금 전후 주문 상태가 달라지고, 정기결제는 최초 결제뿐 아니라 다음 회차 청구까지 확인해야 합니다. 상품권이나 예약 상품처럼 제공 시점이 다른 상품은 취소 규칙도 먼저 정해 두는 게 좋습니다.
PG 계약을 문의할 때는 결제수수료 숫자만 비교하지 마세요. 가입비나 연회비, 정산 주기, 부분 취소 지원, 필요한 서류, 판매 업종 제한을 함께 확인해야 합니다. 수수료와 심사 조건은 사업자 유형과 계약에 따라 달라지므로 다른 쇼핑몰의 조건을 그대로 예상하면 안 됩니다.
- 실물 상품이라면 배송 전 전체 취소와 배송 후 부분 취소가 필요한지 확인합니다.
- 디지털 상품이라면 결제 완료와 동시에 다운로드 권한이 열리는지 확인합니다.
- 정기결제라면 사용하려는 PG와 우커머스 구독 기능의 연동 범위를 먼저 확인합니다.
아직 상품 구성을 시험하는 단계라면 우커머스 기본 계좌이체로 주문 흐름을 점검할 수 있습니다. 자동 카드 결제가 필요한 시점에 PG 계약을 진행해도 됩니다. 계좌이체는 입금을 사람이 확인하고 주문 상태를 바꿔야 하므로, 주문량이 늘면 운영 부담이 커집니다.
결제 플러그인은 한 경로를 선택하세요
국내 우커머스 pg 연동에는 크게 두 경로가 있습니다. 계약한 PG가 안내하는 우커머스용 플러그인을 쓰거나, 포트원처럼 여러 PG를 연결하는 플러그인을 쓰는 방식입니다. 이미 계약한 PG가 있다면 그 계약에서 지원하는 플러그인과 결제수단부터 확인하세요. 여러 PG를 비교하거나 추후 변경할 가능성이 있다면 포트원 방식도 검토할 만합니다.
포트원은 워드프레스 플러그인 목록에 우커머스용 플러그인을 공개하고 있습니다. 플러그인 자체를 무료로 설치할 수 있어도 실제 결제에는 PG 계약과 거래 수수료가 따릅니다. 유료 결제 플러그인을 먼저 살 이유는 없습니다. 필요한 결제수단이 무료 플러그인에서 빠져 있거나, 유지보수 책임을 맡길 업체가 필요한 경우에 비용을 따져보면 됩니다.
같은 카드 결제를 처리하는 플러그인 두 개를 동시에 켜 두면 결제수단이 중복 표시되거나 주문 상태를 서로 다르게 처리할 수 있습니다. 운영 중인 사이트라면 기존 플러그인을 바로 지우지 말고 설정과 주문 내역을 백업한 뒤 테스트 환경에서 교체하세요. 교체 전 주문의 취소 처리가 어느 관리자 화면에서 가능한지도 확인해야 합니다.
호환성도 플러그인 이름만 보고 판단하지 마세요. 현재 우커머스 주문서가 체크아웃 블록인지, 기존 숏코드 방식인지 먼저 확인해야 합니다. 우커머스 안내에 따르면 결제수단은 체크아웃 블록 지원 여부에 따라 주문서에 표시되지 않을 수 있습니다. 포트원 플러그인은 변경 내역에 체크아웃 블록과 HPOS 지원을 명시하지만, 실제 사용 버전과 선택한 결제수단에서는 시험 주문으로 확인하는 편이 안전합니다.
설정은 테스트 키로 시작하고 주문 상태까지 확인하세요
먼저 워드프레스, 우커머스, 결제 플러그인을 지원 범위 안의 최신 버전으로 맞춥니다. 운영 사이트라면 파일과 데이터베이스를 함께 백업하고, 복원할 수 있는지 확인한 뒤 업데이트하세요. 결제 플러그인은 우커머스의 주문 데이터를 직접 다루므로 무심코 자동 업데이트만 켜 두는 것도 부담스럽습니다. 업데이트 내용을 보고 테스트 주문을 거칠 시간을 잡는 게 낫습니다.
포트원 플러그인을 쓰는 경우 워드프레스의 ‘플러그인 추가’에서 우커머스 포트원을 설치하고, 포트원 관리자에서 발급한 가맹점 식별코드와 API 키, 비밀 키를 플러그인 설정에 입력합니다. 키 이름과 설정 화면 위치는 플러그인 버전에 따라 달라질 수 있으니 현재 화면의 안내를 기준으로 맞추세요. 비밀 키를 게시글이나 고객에게 보이는 화면에 붙여 넣으면 안 됩니다.
- 우커머스 ‘설정 → 결제’에서 사용할 결제수단만 활성화합니다.
- PG 관리자와 플러그인에서 테스트 환경을 맞추고 카드 결제를 1건 진행합니다.
- PG 승인 내역의 금액·주문번호와 우커머스 주문의 금액·상태를 대조합니다.
- 전체 취소 1건을 실행하고 양쪽 화면에 취소가 반영되는지 확인합니다.
- 가상계좌를 쓴다면 입금 전 대기 상태와 입금 후 상태 변경도 별도로 시험합니다.
테스트 주문은 가능하면 별도 테스트 사이트에서 진행하세요. 운영 사이트에서 시험하면 주문 이메일, 재고, 분석 데이터, 외부 배송 연동이 실제 주문처럼 움직일 수 있습니다. 실결제 키로 시험했다가 취소하면 계약 조건에 따라 비용이 남을 수도 있습니다.
오픈 직전에는 결제 실패보다 상태 불일치를 찾으세요
결제창이 열리지 않으면 오류가 바로 보입니다. 더 위험한 쪽은 고객에게 돈이 청구됐는데 우커머스 주문은 대기 중인 경우입니다. 이때 고객에게 다시 결제하라고 안내하기 전에 PG 관리자에서 같은 주문번호의 승인 내역을 먼저 확인해야 중복 결제를 피할 수 있습니다. 우커머스도 이런 상황에서는 PG 거래 내역과 주문을 대조하고, 결제 통지나 콜백을 확인하도록 안내합니다.
주문 상태가 갱신되지 않는다면 서버의 방화벽이나 보안 플러그인이 PG의 통지를 막는지, 주문서와 결제 완료 페이지가 캐시에 잡히는지 확인하세요. 우커머스 ‘상태 → 로그’에서 해당 결제 플러그인의 오류 기록을 찾을 수 있습니다. 로그를 켠 채 오래 운영하면 불필요한 정보가 쌓이므로 문제를 확인한 뒤 자세한 기록은 끄는 편이 좋습니다.
휴대전화와 PC에서 각각 소액 상품을 주문해 배송비, 쿠폰, 취소까지 한 번씩 확인합니다. 오픈 뒤에도 플러그인 업데이트 직후에는 같은 순서로 시험 주문을 돌립니다. 제 경험상 결제수단을 하나 더 늘리는 일보다, 이미 받는 결제가 주문과 환불에 정확히 반영되는지 지키는 일이 훨씬 중요합니다.
