클라이언트 연동breadcrumb사용자 인증

사용자 인증 결과 처리 가이드

1. 사용자 인증

사용자는 결제창에서 각 결제수단에 맞는 인증을 진행해야 해요.

휴대폰결제: 본인인증(SMS, VACS, ACS, 삼성페이 인증 등)
신용카드: 카드사 인증(앱카드, 비밀번호 등)
간편결제: 간편결제사 인증
계좌이체: 은행 계좌 인증

인증을 마치고 결제창에서 '결제 완료'만 누르면 결제가 끝나요.
이 시점이 사용자 입장에서는 결제 여정의 마지막이에요. (서버 처리는 그 뒤로 계속돼요.)

2. 인증 결과 처리

사용자가 결제 완료 버튼을 누를 때, 결제창은 가맹점 서버의 successUrl 또는 failUrl로 결과를 전달해요.

결제창은 사용자의 User-Agent를 기준으로 모바일/PC 환경을 구분하며,
  • 모바일 환경일 때는 GET 요청으로
  • PC환경일 때는 POST(form-data) 요청으로

사용자 브라우저에서 가맹점 서버로 직접 전송돼요.

전송되는 정보는 아래 예시 코드를 참고해주세요.

공통 파라미터

  • 성공/실패 무관하게 모든 결제수단 응답에 동일하게 포함되는 값이에요.
  • 휴대폰결제, 신용카드, 계좌이체, 간편결제(페이코/네이버페이/카카오페이)일 때 아래와 같이 응답을 받을 수 있어요.
{
  "code": "SUCCESS",
  "message": "성공",
  "transactionId": "202404290001234567890",
  "orderId": "ORDER-20240429-0001",
  "method": "CARD", // 결제 수단 코드,
  "amount": 10000,
}

개별 파라미터

  • 결제수단이 가상계좌, 컬쳐랜드상품권, 도서문화상품권일 때는 추가로 응답하는 값이 있으니 아래 예시를 참고해주세요.

가상계좌

{
  "code": "SUCCESS",
  "message": "성공",
  "paymentsToken": "yvB53V13pIQaSCyXk8UR2LpSlviqEV69ZrBRY54l6UHDd7iGuQiO-TNa_-PoznTl",
  "transactionId": "202404290001234567890",
  "orderId": "ORDER-20240429-0001",
  "authStatus" : "Y"
  "method": "VACCOUNT",
  "amount": 10000,
}

컬쳐랜드상품권

{
  "code": "SUCCESS",
  "message": "성공",
  "paymentsToken": "yvB53V13pIQaSCyXk8UR2LpSlviqEV69ZrBRY54l6UHDd7iGuQiO-TNa_-PoznTl",
  "transactionId": "202404290001234567890",
  "certificateToken" : "f2a9b7c3e18d4f56a2c1b9d8e37a4c92",
  "orderName" : "상품명"
  "authType" : "Y"
  "method": "CULTURELAND",
  "amount": 10000,  
}

도서문화상품권

{
  "code": "SUCCESS",
  "message": "성공",
  "paymentsToken": "yvB53V13pIQaSCyXk8UR2LpSlviqEV69ZrBRY54l6UHDd7iGuQiO-TNa_-PoznTl",
  "transactionId": "202404290001234567890",
  "certificateToken" : "f2a9b7c3e18d4f56a2c1b9d8e37a4c92",
  "orderName" : "상품명"
  "method": "BOOK_AND_LIFE",
  "amount": 10000,
}

3. 결제 승인 요청 API 호출

가맹점 서버가 결과를 정상적으로 수신하면, 결제 승인 요청 API를 호출해 결제를 최종 승인할 수 있어요.
아래 안내를 참고해 다음 단계를 진행해보세요.

💡다음 단계: 헤더 설정

  • 결제 진행을 위한 인증이 성공했다면, 이제 서버로 결제 승인 요청을 보낼 차례예요.
  • 서버로 요청을 보낼 때는 정상적인 인증과 처리를 위해 요청 헤더를 반드시 포함해야 해요.
  • 자세한 내용은 요청 헤더 설정 가이드를 확인해 주세요.

← 이전 단계로 이동

맨 위로