Appearance

이해하기 ​

실물 상품/서비스 결제는 토스페이로 빠르고 매끄럽게 처리하세요.
마찰을 줄이면 전환율은 올라가고, 결제 실패·이탈은 줄어듭니다. 💳✨

왜 꼭 연동해야 하나요? ​

  • 원탭 결제 경험: 복잡한 폼 없이 결제로 직행 → 전환율 상승
  • 신뢰도 높은 흐름: 결제창·인증·승인까지 표준 플로우로 안정적
  • 수단 선택 유연함: 토스머니/카드 등 상황에 맞게 결제
  • 운영이 쉬움: API로 생성→인증→승인/환불→상태조회가 명확

이렇게 쓰면 좋아요

결제 전에 주문 요약(상품/금액/할인/환불 규정) 을 한 화면에 명확히 보여주세요.

시작 전에 ​

콘솔에서 먼저 준비해요 ​

  • 계약 진행 → 키 발급(가맹점 키) → 연동 키 등록
  • 발급된 키는 개발 탭의 API 연동에 사용돼요. (테스트 키와 운영 키 구분)

필수 선행 연동 ​

개발 전 체크 ​

  • 주문번호(orderNo) 유니크: 중복 사용 시 결제 생성이 거절돼요.
  • 테스트 키 사용: 개발 단계에선 테스트 키로만 진행하세요. (테스트 환경에선 “결제 생성까지만” 가능할 수 있어요.)
  • 금액 필드 정합성: 총액/비과세/과세/부가세 숫자형으로 전달, 화면 표시 금액과 API 요청 금액 일치 확인.
  • 에러/타임아웃 대비: 재시도·망취소(취소 처리) 플로우와 멱등 처리(중복 승인 방지)를 준비하세요.

UX/정책 가이드 ​

  • 핵심 정보는 선명하게: 상품명·수량·총액·할인·환불 규정을 결제 전 분명히 고지.
  • 중복 승인 방지: 결제 중 버튼 잠금/로딩 노출, 뒤로가기 시 상태 보존.
  • 실패도 친절하게: 실패 사유 안내 + 재시도/다른 수단 선택 유도.
  • 취소 동작 명확히: 결제창 ‘취소’ 시 주문 화면으로 안전 복귀.

성과를 빠르게 키우는 TIP ​

  • 스텝 최소화: 상품 선택 → 요약 → 결제 3단 구성으로 짧게.
  • 혜택 가시화: 즉시할인/포인트 사용 가능 여부를 요약에 명확히 표기.
  • 퍼널 로깅: 결제 생성 → 인증(체크아웃) → 승인 → 완료/취소 이벤트를 모두 기록해서 병목 구간을 찾으세요.
  • 시너지 활용: 푸시·프로모션(포인트)와 묶어 재구매/복귀를 유도하면 AOV·리텐션 개선에 효과적입니다.