GUIDE / 01
자체제작 사이트의 결제 구조 — 결제창 · 승인 · 결과 수신
자체제작 사이트는 상품과 주문을 관리하는 방식이 사이트마다 다릅니다. 카드결제를 붙일 때에는 고객이 결제창을 여는 화면, 승인 결과를 확인하는 서버, 주문 상태를 기록하는 관리 기능을 이어 봅니다. 세 부분이 같은 거래를 가리켜야 결제와 주문이 맞습니다. 화면에 완료 문구를 띄우는 것만으로 출고 가능한 거래가 됐다고 판단하지 않습니다. 실제 연결 방식은 선택한 결제 서비스의 공식 연동 절차를 따릅니다. 베스트페이에 현재 사이트 주소와 주문 저장 방식, 개발 담당자 유무를 알려 주시면 준비할 자료와 작업 범위를 구체적으로 정리할 수 있습니다. 전체 흐름은 전자담배 사이트 카드결제 안내에서 함께 볼 수 있습니다.
개발 담당자는 기존 주문 생성 시점과 결제 요청 시점을 확인해 주세요. 주문이 먼저 만들어지는지, 결제 후 만들어지는지에 따라 중단된 거래를 처리하는 방법이 달라질 수 있습니다. 운영자에게 필요한 것은 어떤 상태를 보고 출고할지에 대한 명확한 기준입니다. 주문 목록에서 미결제와 결제 완료, 취소 상태를 어떻게 구분할지도 함께 정합니다. 회원과 비회원 주문이 따로 있다면 두 경로를 모두 확인합니다. 구현을 시작하기 전에 현재 흐름을 간단한 순서도로 적어 두면 추가할 기능과 이미 있는 기능을 나누는 데 도움이 됩니다.
- 상품 선택 → 주문 생성 → 결제 요청 → 결과 확인 → 출고 준비를 한 주문으로 따라가 보세요. 연결이 빠진 구간을 구체적으로 찾을 수 있습니다.
- 운영자가 확인하는 주문번호와 결제 관리자에서 조회하는 거래 식별값을 함께 보관하면 고객 문의 때 같은 거래를 찾기 쉬워집니다.
GUIDE / 02
개발자가 있을 때 — 연동 문서 · 시험 키 · 검수 항목
개발자가 있다면 적용할 서비스의 공식 문서, 시험용 가맹점 정보, 결과를 받을 주소를 준비합니다. 지원 언어나 예제 코드만 확인하지 말고 현재 서버 구조와 연결할 수 있는지도 살펴봅니다. 시험 환경에서 한 주문의 전체 흐름을 끝까지 연결하는 것이 우선입니다. 주문 금액 계산과 인증 후 결과 확인, 오류 처리, 취소 확인을 각각 작업 항목으로 나누어 주세요. 비밀 키는 서버에서 관리하고 고객에게 전달되는 파일에 포함하지 않습니다. 운영자와 개발자가 서로 다른 완료 기준을 생각하지 않도록 어느 화면에서 무엇을 확인할지 미리 합의해 두면 좋습니다.
검수 목록에는 성공 사례뿐 아니라 고객이 결제창을 닫거나 통신이 끊기는 상황도 넣습니다. 결과 알림을 다시 받는 방식이 있다면 같은 거래가 여러 번 반영되지 않는지도 확인해야 합니다. 오류가 나도 주문 기록을 추적할 수 있게 만드는 것이 중요합니다. 개발 로그에는 필요한 거래 식별 정보와 발생 시각을 남기되 비밀 키와 민감한 고객 정보는 출력하지 않습니다. 베스트페이는 사이트의 신청 조건과 준비 상태를 안내하고, 실제 구현은 담당자가 선택한 서비스 문서를 기준으로 확인하도록 돕습니다. 추가 개발 비용과 지원 범위는 작업 전에 서면으로 정리합니다.
| 구간 | 연결 담당자가 확인할 것 | 운영자가 확인할 것 |
|---|---|---|
| 주문 생성 | 식별값 · 금액 저장 · 중복 처리 | 품목과 옵션이 맞는 주문인지 |
| 결제 요청 | 공식 모듈 · 요청 데이터 | 고객에게 보이는 결제 수단 |
| 결과 확인 | 서버 검증 · 거래 상태 저장 | 결제 완료 주문 분류 |
| 고객 화면 | 성공 · 실패 · 중단 경로 | 다음 행동과 문의 방법 |
| 운영 관리 | 키 권한 · 로그 · 변경 기록 | 조회 · 취소 · 인수인계 순서 |
- 개발 전달 목록에는 사이트 주소, 주문 방식, 시험 환경, 완료 주소, 실패 주소, 결과 확인 방식을 적습니다. 비밀값은 별도 권한 관리 경로로 공유합니다.
- 시험 결과는 사용한 기기와 주문번호, 기대한 상태, 실제 상태로 기록하세요. '결제가 안 된다'보다 구체적인 오류 지점을 전달할 수 있습니다.

GUIDE / 03
개발자가 없을 때 — 설정형 모듈과 외부 결제 페이지
개발자가 없는 경우에는 현재 사이트가 어떤 기반으로 만들어졌는지부터 확인합니다. 관리 화면에서 모듈을 설치할 수 있는지, 제작 업체가 유지 보수를 맡고 있는지, 외부 결제 페이지를 연결할 수 있는지를 살펴봅니다. 설정으로 해결할 수 있는 일과 주문 시스템 수정이 필요한 일을 구분합니다. 외부 화면으로 이동해 결제하는 방식도 사이트의 판매 구조와 계약 범위에 맞는지 확인해야 합니다. 결제 링크를 하나 붙였다는 이유로 주문, 재고, 취소가 모두 자동으로 연결되는 것은 아닙니다. 현재 불편한 점과 원하는 운영 범위를 함께 알려 주세요.
모듈을 선택할 때에는 설치 가능 여부뿐 아니라 운영 중 누가 관리할지도 확인합니다. 사이트 버전이나 테마가 바뀌면 업데이트와 호환성 확인이 필요할 수 있습니다. 운영자가 감당할 수 있는 관리 범위까지 포함해 방식을 고릅니다. 고객에게 결제 방법을 설명하는 문구, 완료 후 돌아올 화면, 문의할 때 필요한 주문 정보도 정리합니다. 베스트페이가 가능한 연결 경로를 안내하면 제작 업체나 유지 보수 담당자에게 실제 적용 범위를 확인해 주세요. 필요한 개발이 있다면 기능 목록과 비용, 일정이 분명해진 다음 진행하는 것이 좋습니다.
- 사이트 제작 계약이나 관리 화면에서 사용 중인 플랫폼과 유지 보수 담당자를 확인해 보세요. 개발 언어를 몰라도 구조를 파악하는 데 도움이 됩니다.
- 외부 결제 화면을 검토한다면 결제 후 주문 상태를 누가 어떤 화면에서 확인하는지부터 정합니다. 수동으로 남는 업무도 함께 기록하세요.
GUIDE / 04
주문번호 · 금액 · 상품명이 맞아야 하는 이유
주문번호와 금액, 상품명은 서로 다른 화면에서 같은 거래를 찾는 기준입니다. 장바구니에서 선택한 구성과 주문서에 저장된 내용, 결제 요청에 전달한 금액을 대조해야 합니다. 최종 결제 금액은 서버가 확인한 주문 내용을 기준으로 검증합니다. 고객 화면에서 전달한 숫자만 믿고 승인 처리를 이어가면 할인이나 배송비 계산이 어긋날 수 있습니다. 사용하는 연동 방식에 맞춰 요청 전 정보를 저장하고 결과를 받은 뒤 다시 확인합니다. 상품명에는 운영자가 거래를 식별할 수 있는 내용을 쓰되 실제 판매 품목과 다른 이름으로 설명하지 않습니다.
쿠폰과 적립금, 묶음 배송이 있다면 일반 주문과 별도로 시험해 보세요. 같은 상품도 옵션 수량에 따라 최종 금액이 달라지므로 일부 화면만 확인해서는 차이를 찾기 어렵습니다. 주문 변경과 결제 재시도 때도 거래가 섞이지 않아야 합니다. 새 주문번호를 만드는 기준과 기존 주문을 다시 사용하는 기준은 개발 담당자가 결제 서비스의 요구사항에 맞춰 정리합니다. 운영자는 주문 목록과 결제 내역에서 같은 금액이 보이는지 확인하면 됩니다. 금액이 다르면 출고 전에 차이를 확인하고, 고객에게 결제를 다시 요청하기 전 기존 거래 상태부터 조회합니다.
- 상품가 · 옵션 추가금 · 배송비 · 할인액 · 최종 금액을 나누어 시험하세요. 관리자 합계와 결제 요청 합계가 같아지는지 확인합니다.
- 새로고침이나 뒤로 가기 뒤 다시 결제한 주문도 점검합니다. 고객에게 하나로 보이는 주문이 관리자에서 중복으로 처리되지 않는지 살펴봅니다.
GUIDE / 05
완료 · 실패 · 취소 페이지 만들기
완료 화면은 고객이 결제가 끝났다는 사실을 확인하고 다음 행동을 정하는 곳입니다. 주문번호와 처리 상태, 문의 방법이 보여야 하며 필요한 경우 주문 내역으로 이동할 수 있어야 합니다. 성공 화면의 내용은 확인된 실제 결제 결과에 맞춰 표시합니다. 실패나 중단 화면도 함께 준비해 고객이 현재 상태를 이해하도록 안내합니다. 인증을 중단한 상황과 실제 승인 실패를 같은 문장으로 단정하지 말고, 확인 가능한 범위에서 설명합니다. 상세한 내부 오류나 서버 정보는 화면에 그대로 노출하지 않고 담당자가 확인할 수 있는 기록으로 남깁니다.
휴대전화에서는 카드 인증 앱으로 이동했다가 다시 돌아오는 흐름도 확인합니다. 돌아온 화면이 비어 있거나 장바구니가 초기화되면 결제 여부를 묻는 문의가 생길 수 있습니다. 다시 결제하기 전에 현재 거래를 확인할 수 있는 길을 둡니다. 취소 요청 화면은 단순한 주문 취소 표시와 실제 결제 취소가 어떻게 연결되는지 안내해야 합니다. 개발 담당자는 처리 중 상태와 결과 확인 흐름을 구분하고, 운영자는 고객에게 사용할 응대 문구를 준비합니다. 베스트페이가 도입 과정에서 확인해야 할 화면을 정리하면 실제 기기에서 한 경로씩 점검해 주세요.
- 완료 · 실패 · 중단 화면에 고객이 돌아갈 위치와 문의 방법이 있는지 확인하세요. 페이지가 열렸다는 사실만으로 거래 상태를 판단하지 않습니다.
- 모바일 인증 뒤 복귀, 브라우저 새로고침, 창 닫기처럼 실제로 자주 생기는 행동을 시험 목록에 포함해 주문 기록을 대조합니다.
GUIDE / 06
운영 뒤 키 관리와 담당자 인수인계
연결이 끝난 뒤에도 가맹점 정보와 키, 관리자 권한을 관리해야 합니다. 개인 메신저에만 저장해 두거나 외주 담당자 한 명만 알고 있는 상태로 남기면 변경 작업이 어려워질 수 있습니다. 업무에 필요한 접근 권한과 보관 책임을 정해 둡니다. 비밀 키는 공개 저장소나 고객이 볼 수 있는 코드에 넣지 않으며, 접근이 끝난 담당자의 권한도 점검합니다. 키 변경이 필요한 상황이라면 사용하는 서비스의 절차에 따라 적용 범위와 시점을 확인합니다. 운영용 정보와 시험용 정보를 구분해 잘못된 환경으로 전환되지 않도록 관리합니다.
인수인계 문서에는 결제창을 여는 위치, 결과를 받는 주소, 주문 상태를 확인하는 화면, 취소 처리 경로를 기록합니다. 문서에 비밀값을 그대로 적기보다 권한이 있는 사람이 어디에서 조회하는지 설명하는 편이 좋습니다. 새 담당자가 한 거래를 처음부터 끝까지 찾을 수 있어야 합니다. 사이트 변경 후에는 시험 결과와 적용 날짜도 남겨 주세요. 현재 롯데카드는 지원 범위에서 제외되며 실제 노출 수단과 수수료, 정산 조건은 최종 계약과 가맹점 안내를 기준으로 관리합니다. 베스트페이는 운영자가 확인할 기준과 변경 전에 질문할 항목을 함께 정리해 드립니다.
- 퇴사나 외주 종료 때에는 관리자 계정과 서버 접근 권한을 점검하세요. 공용 계정을 공유했다면 현재 책임자와 변경 절차를 확인합니다.
- 결제 장애 연락 창구와 확인 순서를 문서로 남겨 두면 담당자가 자리를 비워도 주문번호와 발생 시각을 기준으로 대응을 시작할 수 있습니다.

