헥토파이낸셜 개발자센터
Products서비스
PG 결제
다양한 간편 결제
내통장결제
실시간 계좌이체 서비스
간편현금결제
계좌 등록 / 결제 / 송금
화이트라벨
브랜드페이-통합결제지원
현금영수증
실시간 펌뱅킹
VAN 가상계좌
안심선불
LLMs로 연동하기
MCP 서버 및 AI 챗봇
API & SDKAPI & SDK
PG 결제
다양한 간편 결제
내통장결제
실시간 계좌이체 서비스
간편현금결제
계좌 등록 / 결제 / 송금
화이트라벨
브랜드페이-통합결제지원
현금영수증
실시간 펌뱅킹
VAN 가상계좌
안심선불
블로그블로그
FAQFAQ
서비스 상태
PG 결제
내통장결제
간편현금결제
화이트라벨
현금영수증
실시간 펌뱅킹
VAN 가상계좌
안심선불
LLMs로 연동하기
MCP 서버 및 AI 챗봇
PG 결제
내통장결제
간편현금결제
화이트라벨
현금영수증
실시간 펌뱅킹
VAN 가상계좌
안심선불
블로그
기술 블로그 및 소식
FAQ
자주 묻는 질문
서비스 상태
서비스 장애 및 점검 현황
시작하기신용카드 결제가상계좌 결제010 가상계좌계좌이체 결제휴대폰 결제상품권 결제포인트 다모아간편결제
내통장결제
펌뱅킹오픈뱅킹
화이트라벨
현금영수증
실시간 펌뱅킹
VAN 가상계좌
안심선불
LLMs로 연동하기
시작하기신용카드 결제가상계좌 결제010 가상계좌계좌이체 결제휴대폰 결제상품권 결제포인트 다모아간편결제
내통장결제
펌뱅킹오픈뱅킹
화이트라벨
현금영수증
실시간 펌뱅킹
VAN 가상계좌
안심선불
LLMs로 연동하기
서비스PG 결제신용카드 결제

신용카드 결제

신용카드 결제는 구매자가 카드사로부터 발급받은 카드로 상품이나 서비스 대금을 지불하는 방식입니다. 온라인 결제 수단 중 가장 높은 비중을 차지하고 있으며, 구매자와 가맹점 모두에게 익숙하고 편리한 결제 방식입니다.

온라인에서는 카드를 직접 꽂거나 대는 대신, 카드 정보를 입력하거나 카드사 앱으로 인증하는 방식으로 결제가 진행됩니다.
결제가 완료되면 카드사가 가맹점에 대금을 지급하고, 구매자에게는 다음 결제일에 청구됩니다.

이 문서에서는 신용카드 결제가 어떻게 이루어지는지, 어떤 결제 방식이 있는지, 그리고 연동할 때 알아두면 좋은 내용을 차근차근 안내해 드릴게요.

NOTE

카드 결제의 핵심 흐름. 구매자가 결제 요청 → 카드 소유자 인증 → 카드사 승인 → 결제 완료. 이 흐름은 어떤 결제 방식이든 기본적으로 동일합니다.

결제 방식 알아보기

헥토파이낸셜은 서비스 특성에 맞게 선택할 수 있도록 다양한 신용카드 결제 방식을 제공합니다.

인증결제결제창 ✓API ✗

가장 보편적인 결제 방식입니다. 구매자가 카드사 앱(ISP, 앱카드 등)이나 비밀번호를 통해 본인임을 인증한 뒤 결제가 승인됩니다.

  • 카드사 자체 인증을 거치기 때문에 보안성이 가장 높습니다.
  • 일반적인 온라인 쇼핑몰, 서비스 결제에 잘 맞습니다.
  • 결제창 연동으로만 사용할 수 있습니다.
비인증결제 (KEY-IN)결제창 ✓API ✓

카드번호와 유효기간, 두 가지 정보만 입력하면 결제가 완료되는 방식입니다.

  • 별도의 카드사 앱 인증 없이 간단하게 결제할 수 있습니다.
  • 인증 단계가 생략되기 때문에 결제 전환율을 높이는 데 도움이 됩니다.
  • 결제창, API 연동 모두 지원합니다.
구인증결제 (KEY-IN)결제창 ✓API ✓

비인증결제보다 한 단계 더 보안을 강화한 방식입니다. 카드번호·유효기간에 더해 생년월일과 비밀번호 앞 2자리까지 총 네 가지 정보를 입력합니다.

  • 비인증결제보다 보안성이 높으면서도, 카드사 앱 설치 없이 결제할 수 있습니다.
  • 결제창, API 연동 모두 지원합니다.
빌키결제 (정기결제 / 자동결제)결제창 ✗API ✓

구독 서비스, 정기 배송처럼 반복 결제가 필요할 때 사용하는 방식입니다. 처음 한 번만 카드 정보를 입력하면 고유 식별값인 빌키(BillKey)가 발급되고, 이후에는 빌키만으로 결제를 요청할 수 있습니다.

  • 구매자는 매번 카드 정보를 입력할 필요가 없어서 편리합니다.
  • 가맹점은 원하는 시점에 자동으로 결제를 실행할 수 있습니다.
  • API 연동으로만 사용할 수 있습니다.
  • 빌키 결제용 상점아이디를 추가 발급해야할 수 있습니다.
NOTE
빌키의 유효기간은 해당 카드의 유효기간과 동일합니다. 카드가 만료되면 빌키도 사용할 수 없으니, 가맹점에서 빌키와 유효기간을 함께 관리해 주세요.
인증/승인 분리결제창 ✓API ✓

고객 인증과 실제 승인을 분리하여 처리하는 방식입니다. 인증 완료 이후 개발사에서 별도로 승인 API를 호출합니다.

  • 인증 단계에서는 결제가 발생하지 않습니다.
  • 가맹점이 필요한 시점에 승인 API를 호출하여 최종 결제를 진행합니다.

결제 흐름 알아보기

결제창 연동

가맹점 웹페이지에서 헥토파이낸셜 결제창을 호출하면, 구매자가 결제창에서 직접 결제 정보를 입력하고 인증을 진행합니다. 결제가 완료되면 헥토파이낸셜이 가맹점 서버로 결과를 전달해 줍니다.

구매자
가맹점
헥토파이낸셜
원천사
11. 주문서에서 결제 요청
1. 주문서에서 결제 요청
22. 결제창 호출 (JS SDK)
2. 결제창 호출 (JS SDK)
33. 결제창 표시
3. 결제창 표시
44. 카드 정보 입력 및 인증
4. 카드 정보 입력 및 인증
55. 카드사에 승인 요청
5. 카드사에 승인 요청
66. 승인 결과 반환
6. 승인 결과 반환
77. 결과 통보 (notiUrl)
7. 결과 통보 (notiUrl)

각 단계 상세

  1. 1결제 요청 : 구매자가 주문서에서 결제 수단을 선택하고 "결제하기" 버튼을 클릭합니다.
  2. 2결제창 호출 : 가맹점은 헥토파이낸셜 JavaScript SDK(SETTLE_PG.pay)를 호출하여 결제창을 띄웁니다.
  3. 3결제창 표시 : 구매자에게 카드 정보 입력 화면이 나타납니다.
  4. 4인증 진행 : 구매자가 카드 정보를 입력하고, 카드사 앱이나 비밀번호로 본인 인증을 완료합니다.
  5. 5승인 요청 : 헥토파이낸셜이 카드사(원천사)에 결제 승인을 요청합니다.
  6. 6승인 결과 : 카드사가 승인 여부를 헥토파이낸셜에 전달합니다.
  7. 7결과 통보 : 헥토파이낸셜이 가맹점 서버의 notiUrl로 결제 결과를 전달합니다.
notiUrl은 꼭 구현해 주세요.결제창 연동에서 notiUrl은 필수입니다. 구매자가 결제창을 중간에 닫거나 브라우저를 종료하더라도, notiUrl을 통해 결제 결과를 안정적으로 수신할 수 있습니다. nextUrl은 화면 표시 용도이므로, 실제 주문 처리 로직은 반드시 notiUrl에서 수행해야 합니다.

결제창 vs API 비교

항목결제창 연동API 연동
카드 정보 취급헥토파이낸셜이 관리가맹점이 직접 수집
결제 UI헥토파이낸셜 제공 결제창가맹점 자체 디자인 가능
지원 결제 방식인증, 비인증, 구인증비인증, 구인증, 빌키

API 연동

가맹점 서버에서 헥토파이낸셜 API를 직접 호출하여 결제를 처리하는 방식입니다. 결제창 없이 가맹점이 직접 카드 정보를 수집하고, 서버 간(Server-to-Server) 통신으로 결제를 요청합니다.

구매자
가맹점
헥토파이낸셜
원천사
11. 카드 정보 입력 및 결제 요청
1. 카드 정보 입력 및 결제 요청
22. 결제 API 호출
2. 결제 API 호출
33. 카드사에 승인 요청
3. 카드사에 승인 요청
44. 승인 결과 반환
4. 승인 결과 반환
55. API 응답 반환
5. API 응답 반환
66. 결제 결과 안내
6. 결제 결과 안내

각 단계 상세

  1. 1카드 정보 입력 : 구매자가 가맹점의 자체 결제 화면에서 카드 정보를 입력합니다.
  2. 2API 호출 : 가맹점 서버가 헥토파이낸셜 결제 API를 호출합니다.
  3. 3승인 요청 : 헥토파이낸셜이 카드사(원천사)에 결제 승인을 요청합니다.
  4. 4승인 결과 : 카드사가 승인 여부를 반환합니다.
  5. 5API 응답 : 헥토파이낸셜이 가맹점 서버로 결제 결과를 응답합니다.
  6. 6결과 안내 : 가맹점이 구매자에게 결제 완료 여부를 안내합니다.
NOTE
API 연동에서는 notiUrl이 필수가 아닙니다. API 응답으로 결제 결과를 바로 수신할 수 있기 때문입니다. 다만, 네트워크 장애 같은 예외 상황에 대비해서 notiUrl도 함께 구현해 두면 더 안심이에요.

빌키(BillKey) 결제

빌키 결제는 정기결제, 구독 서비스를 구현할 때 핵심이 되는 기능입니다. 처음 한 번만 카드를 등록하면 고유 식별값인 빌키(BillKey)가 발급되고, 이후에는 빌키만으로 결제를 자동 실행할 수 있습니다.

구매자
가맹점
헥토파이낸셜
카드사
11. 카드 등록 요청
1. 카드 등록 요청
22. 카드등록(빌키발급) 결제창 호출
2. 카드등록(빌키발급) 결제창 호출
33. 결제창에서 카드 정보 입력 (0원 인증)
3. 결제창에서 카드 정보 입력 (0원 인증)
44. 카드 유효성 검증
4. 카드 유효성 검증
55. 검증 완료
5. 검증 완료
66. 빌키 발급 완료
6. 빌키 발급 완료
77. 빌키 결제 API 호출 (원하는 시점에)
7. 빌키 결제 API 호출 (원하는 시점에)
88. 결제 결과 응답
8. 결제 결과 응답

각 단계 상세

  1. 1카드 등록 : 구매자가 카드 등록을 요청합니다.
  2. 2카드등록 결제창 호출 : 가맹점이 카드등록(빌키발급) 결제창을 호출합니다. 실제 결제 없이 0원 인증으로 진행됩니다.
  3. 3카드 정보 입력 : 구매자가 결제창에서 카드 정보를 입력합니다.
  4. 4카드 유효성 검증 : 헥토파이낸셜이 카드사에 카드 유효성을 확인합니다.
  5. 5검증 완료 : 카드사가 검증 결과를 반환합니다.
  6. 6빌키 발급 완료 : 헥토파이낸셜이 가맹점에 빌키를 전달합니다. 가맹점에서 보관합니다.
  7. 7빌키 결제 호출 : 가맹점이 원하는 시점에 빌키를 사용하여 결제 API를 호출합니다.
  8. 8결제 결과 응답 : 헥토파이낸셜이 결제 결과를 응답합니다.
NOTE
실제 사용 예시를 들어볼게요.처음 결제할 때 카드를 등록(빌키 발급)하고, 이후 매달 자동으로 결제(빌키 결제)가 이루어지는 구조입니다.

모바일 결제 연동

모바일 앱에서 결제창을 연동할 때는 WebView를 사용하게 됩니다.

웹 브라우저와 달리 WebView 환경에서는 카드사 앱 호출, 인증 완료 후 복귀 등을 위해 추가 설정이 필요해요.

꼭 확인해야 할 사항:

  • 카드사 앱 호출을 위한 AppScheme 등록
  • 외부 앱 호출 및 복귀를 위한 shouldOverrideUrlLoading 함수 재정의
  • OS별(Android/iOS) WebView 설정 차이 확인
NOTE

자세한 내용은 아래 가이드를 참고해 주세요. WebView 연동 가이드에서 Android, iOS별 상세한 설정 방법을 확인할 수 있습니다.

신용카드 취소

결제 취소는 전체 취소와 부분 취소 두 가지를 지원합니다.

구분설명
전체 취소결제된 금액 전체를 취소합니다. 승인 취소로 즉시 처리됩니다.
부분 취소결제된 금액 중 일부만 취소합니다. 취소매입 방식으로 처리되며, 보통 3~5 영업일 정도 소요됩니다.
취소 기한결제일로부터 1년 이내에 취소 요청이 가능합니다.
NOTE

부분 취소는 왜 바로 처리되지 않을까요? 부분 취소는 기존 승인을 유지한 상태에서 일부 금액만 취소 매입하는 방식으로 처리됩니다. 카드사의 매입 처리 절차를 거쳐야 하기 때문에 전체 취소보다 시간이 조금 더 걸립니다.

연동 전 확인사항

신용카드 결제 연동을 시작하기 전에, 아래 사항을 미리 확인해 두면 좋습니다.

상점아이디 관련

  • 인증결제, 비인증결제, 구인증결제 등 결제 용도에 따라 상점아이디가 분리될 수 있습니다. 사용할 결제 방식을 미리 확인하고, 영업 담당자와 협의해 주세요.
  • 테스트 환경과 운영 환경의 상점아이디는 다릅니다. 운영환경에서 테스트하면 실제 비용이 발생하니, 꼭 테스트베드를 이용해 주세요.

기타 관련

  • 신용카드 카드 빌키 유효기간은 카드 유효기간과 동입합니다.
  • 일부 법인카드, 선불카드의 경우 업종에 따라 결제가 어려울 수 있습니다.

영업/심사 관련

  • 업종, 심사 진행 사항, 결제 후 SMS의 가맹점 명 표기 등은 영업 담당자를 통해 문의해 주세요.
  • 영업 문의 :

신용카드 개발 문서 바로가기

💳

일반 결제 API

기본적인 카드 결제 연동

➕

카드등록(빌키발급) 결제창

0원 인증으로 카드 등록 및 빌키 발급

🔄

정기(빌키) 결제 API

구독 서비스를 위한 자동 결제

↩️

취소 API

전체 취소 및 부분 취소

❓

더 궁금한 내용이 있나요?

FAQ
💬

기술지원이 필요한가요?

코드 샘플

HectoFinancial GitHub