헥토파이낸셜 개발자센터
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 결제상품권 결제

상품권 결제

상품권 결제는 컬쳐캐쉬, 도서문화상품권, 스마트문상, 틴캐시, 티머니 등 선불 상품권 및 포인트로 결제하는 방식입니다.
신용카드나 은행 계좌 없이도 결제할 수 있어, 간편한 소액 결제를 원하는 고객에게 적합합니다.

구매자가 결제창에서 상품권 종류를 선택하고, 로그인 또는 PIN 번호를 입력하면 보유 잔액에서 결제 금액이 차감됩니다.

NOTE

상품권 결제의 핵심 흐름. 구매자가 상품권 선택 → 로그인/PIN 입력 → 잔액 확인 → 잔액 차감 → 결제 완료. 상품권은 현금성 결제로 분류되어 현금영수증 발행 대상입니다.

상품권 종류 알아보기

헥토파이낸셜은 다양한 상품권 결제를 지원합니다.

컬쳐캐쉬결제창 ✓API ✗

컬쳐랜드에서 충전하여 게임, 쇼핑, 도서 등 다양한 온라인 서비스에서 사용할 수 있는 상품권입니다.

  • 결제창에서 컬쳐랜드 로그인 후 잔액을 확인하고 결제합니다.
NOTE
결제 후 고객이 비밀번호를 변경하거나 잔액을 이미 사용한 경우 취소가 실패할 수 있습니다.
도서문화상품권결제창 ✓API ✗

북앤라이프에서 발행하는 상품권으로, 도서뿐만 아니라 영화, 게임, 쇼핑 등 다양한 콘텐츠 결제에 사용할 수 있습니다.

  • 유효기간은 발행일로 부터 5년입니다.
스마트문상결제창 ✓API ✗

게임 및 디지털 콘텐츠 결제에 특화된 상품권으로, PIN 번호만으로 즉시 결제가 가능합니다.

  • 16~18자리의 핀(PIN) 번호를 입력해 결제합니다
틴캐시결제창 ✓API ✗

게임 및 디지털 콘텐츠 결제에 특화된 상품권으로, 편의점 등에서 구매하여 온라인에서 사용할 수 있습니다.

  • 편의점 등 오프라인에서 구매 후 온라인에서 사용합니다.
티머니결제창 ✓API ✗

교통카드 기반의 선불 포인트로, 다양한 온라인 가맹점에서 결제 수단으로 사용할 수 있습니다.

  • 티머니 앱에서 충전한 잔액으로 결제합니다.

결제 흐름 알아보기

결제창 연동

가맹점 웹페이지에서 헥토파이낸셜 결제창을 호출하면, 구매자가 상품권 종류를 선택하고 로그인 또는 PIN 입력을 통해 결제를 진행합니다. 잔액 확인 후 결제 금액이 차감됩니다.

구매자
가맹점
헥토파이낸셜
상품권사
11. 결제 수단으로 상품권 선택
1. 결제 수단으로 상품권 선택
22. 결제창 호출 (method 설정)
2. 결제창 호출 (method 설정)
33. 결제창 표시 (로그인/PIN 입력)
3. 결제창 표시 (로그인/PIN 입력)
44. 로그인 또는 PIN 입력
4. 로그인 또는 PIN 입력
55. 잔액 확인 및 차감 요청
5. 잔액 확인 및 차감 요청
66. 차감 완료
6. 차감 완료
77. 결과 통보 (notiUrl)
7. 결과 통보 (notiUrl)

각 단계 상세

  1. 1결제 수단 선택 : 구매자가 주문서에서 상품권 결제를 선택합니다.
  2. 2결제창 호출 : 가맹점이 JavaScript SDK를 호출하여 결제창을 띄웁니다. method 파라미터로 상품권 종류를 지정합니다.
  3. 3로그인/PIN 입력 : 구매자가 상품권사에 로그인하거나 PIN 번호를 입력합니다.
  4. 4잔액 확인 : 상품권사가 잔액을 확인하고 결제 가능 여부를 판단합니다.
  5. 5잔액 차감 : 결제 금액만큼 상품권 잔액이 차감됩니다.
  6. 6결과 통보 : 헥토파이낸셜이 가맹점 서버의 notiUrl로 결제 결과를 전달합니다.
notiUrl은 꼭 구현해 주세요. 결제창 연동에서 notiUrl은 필수입니다. 구매자가 결제창을 중간에 닫더라도, notiUrl을 통해 결제 결과를 안정적으로 수신할 수 있습니다.

상품권 취소

상품권 결제 취소는 원천사 정책에 의해 부분 취소가 불가할 수 있습니다. 전체 취소 후 재 승인이 필요할 수 있습니다.

상품권취소 가능 시점부분 취소
컬쳐캐쉬1년지원하지 않음
도서문화상품권1년지원하지 않음
스마트문상1년지원하지 않음
틴캐시1년부분 취소 지원
티머니90일부분 취소 지원

연동 전 확인사항

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

상점아이디 관련

  • 테스트 환경과 운영 환경의 상점아이디는 다릅니다. 운영환경에서 테스트하면 실제 비용이 발생하니, 꼭 테스트베드를 이용해 주세요.

기타 관련

  • 상품권 결제는 현금성 결제로 분류되어 현금영수증 발행 대상입니다.
  • 상품권 결제는 결제창 연동만 지원합니다. API 단독 연동은 지원하지 않습니다.
  • 티머니의 경우 90일 이후 취소가 어렵습니다.
  • 일부 결제 수단은 부분 취소가 불가할 수 있습니다. (전체 취소 후 재 승인 필요)

영업/심사 관련

  • 상품권사별 심사가 필요할 수 있습니다. 영업 담당자와 협의해 주세요.
  • 영업 문의 :

상품권 결제 개발 문서 바로가기

🎫

상품권 결제 API

상품권 종류별 결제 요청

↩️

상품권 결제 취소 API

결제 취소 요청

❓

더 궁금한 내용이 있나요?

FAQ
💬

기술지원이 필요한가요?

코드 샘플

HectoFinancial GitHub