하위사업장 등록 API는 파트너의 가맹점이 결제선생 사업장으로 등록하고 연동하는 프로세스를 제공합니다. 이를 통해 파트너 가맹점이 결제선생을 통해 청구서를 발송하고 결제를 받을 수 있습니다.
파트너 하위사업장 등록 API는 파트너사의 가맹점(하위사업장)이 결제선생에 사업장을 등록하고 파트너와 연결하는 과정을 자동화합니다.
파트너사는 API를 호출하여 결제선생 파트너 하위사업장 등록 화면을 제공하고, 회원가입 → 사업장 등록 → 심사 → 연결 완료까지의 전 과정을 콜백으로 수신받을 수 있습니다.
복사 파트너 → API 호출 → 결제선생 화면 제공 → 회원가입/로그인 → 사업장 등록/선택 → 심사 → 연결 완료
↓ ↓ ↓
멤버ID 콜백 머천트ID 콜백 심사결과 콜백 2.2 API 호출 시 전달 파라미터
API 호출 시 전달된 멤버 ID, 머천트 ID, 사업자등록번호의 결제선생 내 연결 상태에 따라 사용자에게 제공되는 화면이 달라집니다.
3.1 분기 조건 판단 기준
3.3 사업자등록번호 조회 상세 규칙
값이 없는 경우 : 조회 건너뜀 (N으로 처리)
값이 있는 경우 : 결제선생에 등록된 사업장 대상으로 조회
작성중, 보완, 반려, 개시, 심사중 상태의 사업장이 있으면 → Y
멤버 ID가 결제선생 회원과 연결되지 않은 경우 회원가입 화면이 제공됩니다.
가입 절차:
이메일(또는 아이디), 비밀번호, 이름, 휴대전화번호 입력
약관 동의 (개인정보 수집·이용, 제공 동의 등)
가입 완료 시 동작:
결제선생 → 파트너 서버로 멤버 ID 연결 콜백 발송
사업자등록번호로 조회된 기존 사업장이 있으나 멤버 ID가 연결되지 않은 경우, 로그인 화면이 제공됩니다.
로그인 화면에서 가능한 동작:
비밀번호 재설정 → 비밀번호 재설정 페이지 이동
로그인 성공 시 동작:
결제선생 → 파트너 서버로 멤버 ID 연결 콜백 발송
사업자등록번호로 조회된 기존 사업장이 있는 경우, 해당 사업장 목록이 표시됩니다.
표시되는 사업장 상태: 작성중, 심사중, 반려, 보완, 개시
각 사업장에는 사업자등록번호, 상호명, 지점명, 관리회원 정보(이메일 마스킹)가 표시되며, 사용자는 "로그인 하러가기"를 통해 해당 사업장의 관리회원으로 로그인 후 사업장을 선택합니다.
로그인한 회원이 관리하는 사업장 목록이 표시되며, 파트너와 연결할 사업장을 선택합니다.
선택 후 처리:
연결 성공 : 머천트 ID 연결 콜백 발송 → 연동 완료 화면 → 연동 사업장 화면으로 이동
연결 실패 : 실패 사유 표시 (예: "이미 연결된 사업장입니다. '파트너 서비스명' 고객센터로 문의해 주세요.")
"닫기" 클릭 시 → 창닫기 브릿지 또는 리다이렉트 URL로 이동
신규 사업장을 등록하는 흐름입니다.
등록 절차:
사업자등록번호 입력 (파트너에서 제공한 번호가 있으면 자동 노출, 변경 가능)
사업장 정보 입력 (간판상호, 지점명, 사업장 전화번호 등)
서류 첨부 (사업자등록증, 대표자 본인인증/신분증 등)
약관 동의 (VAN 서비스 이용약관, 카드가맹 관련 동의)
참고 : 추천인 코드 입력 화면은 파트너 연동 시 노출되지 않습니다.
등록 완료 시 동작:
머천트 ID 연결 콜백 발송 (상태: 작성중 → 심사중)
5. 콜백 (Callback)
파트너사는 콜백 URL을 통해 연동 진행 상태를 실시간으로 수신받습니다.
5.1 멤버 매핑 콜백 (Member Mapping)
5.2 사업장 연결 콜백 (Merchant Mapping)
6. 클라이언트 환경별 지원 방식
결제선생 화면은 파트너사의 클라이언트 환경에 따라 다른 방식으로 제공됩니다.
iframe 제공 불가 : 보안 정책상 iframe 내에서 결제선생 화면을 제공할 수 없습니다.
리다이렉트 URL : 파트너사의 환경에서 리다이렉트 URL이 정상 작동할 수 있는 구조여야 합니다.
시나리오 A: 신규 회원 + 신규 사업장
시나리오 B: 기존 회원 + 기존 사업장 연결
