둘러보기

링크페이 연동

발행·안내·수납 단계를 링크 결제 운영 순서로 붙여요.

결제창 대신 결제 링크(링크페이) 를 보내고, 고객이 링크로 결제하는 여정이에요. 수기 견적·전화 주문·후불 청구·비회원 결제에 써요.

이 문서는 누구에게 맞나

쇼핑몰 체크아웃 대신 "링크 보내 → 고객이 누르면 결제" 흐름이 주인 개발자용이에요. B2B 청구, 레슨·학원 수강료, 수기 영업, 배송비 추가 청구 등.

다음이면 다른 문서로 가요.

기획 배경

링크페이 / 결제 링크 / 세금계산서 / 후불 청구 용어가 섞여 쓰여요. 발행 주체·시점·수단을 먼저 정리해요. 결제 vs 커머스 스코프 결정 · 정산 흐름 설계 참고.

준비

  • application_id / private_key 발급 — 결제 SDK의 연동키 가 canonical
  • 서버 SDK 설치 → 환경설정
  • 고객 연락처 수집 방침 확정 (이메일·휴대폰·알림톡 중 무엇으로 보낼지)

단계 1: 고객 등록

  • 할 일: 링크를 받을 고객 정보를 등록해요 (이메일·휴대폰 필수)
  • API:
왜 먼저 고객인가

링크페이는 고객 식별이 선행되어야 발송·수납·재알림이 가능해요.

단계 2: (선택) 상품 등록

  • 할 일: 반복 발행할 품목을 상품으로 미리 등록해둔다
  • API: 상품 생성, 상품 수정, 상품 목록
  • 선택 이유: 금액만 입력해 즉석 발행도 가능. 그러나 반복 청구는 상품 등록이 재사용·리포팅에 유리.

단계 3: 링크페이 생성

  • 할 일: 결제 링크(URL) 를 서버에서 생성해요
  • API: 링크페이 생성
  • 방식:
    • 금액만 입력 — 상품 없이 빠르게 생성
    • 상품 선택 — 미리 등록된 상품으로 생성
  • 필수 값: invoice.name, invoice.price, invoice.user_id
  • 선택 값: expired_at (만료 시점), metadata (내부 참조 키)
관리자 콘솔에서도 생성 가능

코드 없이 운영팀이 직접 발행하려면 → 관리자에서 생성

단계 4: 링크 발송

  • 할 일: 생성된 링크를 고객에게 전달해요
  • 방법:
  • 정책: 재발송 횟수·간격·만료 후 재발행 여부를 정해요

단계 5: 결제 완료 감지 (웹훅)

  • 할 일: 고객이 링크로 결제를 마치면 서버가 결과를 받아요
  • 엔드포인트: 웹훅 처리 가이드
  • 처리:
    • 성공 → 주문 확정, 세금계산서 발행 트리거, 회계 시스템 연동
    • 실패 → 만료 연장·재발송 안내

단계 6: 상태 조회·수납 관리

  • 할 일: 발행된 링크페이의 상태(발행됨/결제됨/만료됨) 를 봐요
  • API:
  • 대시보드: 미수·수납 완료·만료 건을 구분해 운영팀이 추적

단계 7: 취소·환불

  • 할 일: 결제 완료된 링크페이 건을 취소해요
  • API: 취소 요청 (주문 API와 동일 경로)
  • 정책: 링크페이 취소 시 세금계산서 수정발행 여부까지 함께 결정

단계 8: (선택) 정기 청구 자동화

월말 정기 청구가 필요하면 그룹 집계 → 자동 링크페이 발행으로 엮어요.

  • 고객 그룹 통합 집계 → 고객·그룹 단계 5
  • 집계 결과를 스케줄러가 돌려 단계 3의 API 호출

전체 플로우 확인

고객 등록 → 링크 생성 → 발송 → 결제 → 조회 → 취소 시퀀스는 주문 아키텍처 를 참고.

다음 단계

최신 글커머스 체크아웃 연동 이전 글주문 관리 연동