헥토파이낸셜 개발자센터
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로 연동하기
서비스간편현금결제오픈뱅킹

간편현금결제 (오픈뱅킹)

간편현금결제(오픈뱅킹)는 금융결제원 오픈뱅킹 망을 통해 사용자 은행 계좌 기반으로 결제를 진행하는 서비스로, API를 통해 결제, 계좌 관리, 송금, 자금반환청구 등의 기능을 시스템에 연동할 수 있습니다. 사용자가 ARS 계좌점유인증을 통해 오픈뱅킹 계좌를 등록하고, 해당 계좌에서 결제를 진행하는 계좌 기반 결제 서비스로 일반적으로 ARS 인증 → 계좌 등록 → 결제 → 거래 관리 흐름으로 구성됩니다.

카드 결제와 달리 카드번호 입력 과정이 필요하지 않고, 계좌 등록 이후에는 비교적 간단한 절차로 결제가 이루어지는 장점이 있습니다. 비즈니스 관점에서 구독 서비스, 플랫폼 서비스, 콘텐츠 서비스 등 다양한 서비스에서 간편한 결제수단으로서 간편현금결제 API 활용이 가능합니다.

헥토파이낸셜에서 제공하는 간편현금결제(오픈뱅킹) 서비스는 금융결제원 오픈뱅킹 망을 통해 결제 관련 기능을 API 형태로 제공하는 '결제 플랫폼'으로 활용 할 수 있습니다.

NOTE

간편현금결제(오픈뱅킹) 핵심 흐름. ARS 계좌점유인증 → 계좌 등록 → 결제 API 호출 → 금융결제원 망을 통해 즉시 출금.

결제 방식 알아보기

주요 특징

금융결제원 오픈뱅킹 망을 통해 고객 계좌에서 출금하는 서비스입니다. ARS 계좌점유인증으로 계좌를 등록하고, 오픈뱅킹 전용 API(/v2/api/...)로 결제·송금·자금반환청구를 처리합니다.

  • ARS 계좌점유인증 : 펌뱅킹 공통 ARS 인증 API를 사용하여 계좌 점유를 확인합니다.
  • 오픈뱅킹 전용 경로 : 계좌 등록, 결제, 송금 모두 /v2/api/... 경로를 사용합니다.
  • 펌뱅킹+오픈뱅킹 동시 등록 : 1회의 계좌 등록으로 펌뱅킹과 오픈뱅킹을 동시에 등록할 수 있습니다.
  • 자금반환청구 : 오픈뱅킹 고유 기능으로 잘못 이체된 자금 반환을 청구할 수 있습니다.
일반결제결제창 ✗API ✓

등록된 오픈뱅킹 계좌에서 즉시 출금하는 방식입니다. 계좌 등록 후 별도 인증 없이 API 호출만으로 결제할 수 있습니다.

  • 오픈뱅킹 결제 API(`POST /v2/api/pay/confirm`)를 호출하면 고객 계좌에서 즉시 출금됩니다.
  • 결제 취소/환불은 펌뱅킹과 공유하는 API(`POST /v1/api/pay/cancel`)를 사용합니다.
송금결제창 ✗API ✓

가맹점 계좌에서 고객 계좌로 송금하는 방식입니다. 오픈뱅킹 전용 송금 API를 통해 환불, 리워드 지급 등을 처리합니다.

  • 오픈뱅킹 송금 API(`POST /v2/api/pay/rmt`)를 통해 가맹점에서 고객 계좌로 직접 송금합니다.
  • 환불, 캐시백, 리워드 지급 등 다양한 용도로 활용 가능합니다.
자금반환청구결제창 ✗API ✓

오픈뱅킹 고유 기능으로 잘못 이체된 자금 반환을 청구할 수 있습니다.

  • 자금반환청구 요청 API(`POST /v2/api/fundsReturn/req`)를 통해 반환을 청구합니다.
  • 자금반환청구 확인 API(`POST /v2/api/fundsReturn/check`)를 통해 청구 결과를 확인합니다.

결제 흐름 알아보기

  • 간편현금결제(오픈뱅킹)는 모든 기능이 API 방식으로 제공됩니다. (결제창 없음)
  • ARS 인증은 펌뱅킹 공통 API(/v1/api/auth/ars, /v1/api/auth/arscheck)를 사용합니다.
  • 계좌 등록, 결제, 송금은 오픈뱅킹 전용 API(/v2/api/...)를 사용합니다.

계좌 등록 흐름

ARS 계좌점유인증 후 오픈뱅킹 계좌를 등록하는 과정입니다. ARS 인증에서 획득한 trdNo를 계좌 등록 시 사용합니다.

고객
가맹점
헥토파이낸셜
11. 계좌 등록 요청
1. 계좌 등록 요청
22. ARS 인증 요청 (펌뱅킹 API)
2. ARS 인증 요청 (펌뱅킹 API)
33. ARS 전화 발신
3. ARS 전화 발신
44. ARS 인증 확인 → trdNo 획득
4. ARS 인증 확인 → trdNo 획득
55. 계좌 등록 (오픈뱅킹용)
5. 계좌 등록 (오픈뱅킹용)
66. 계좌 등록 응답 (custAcntKey, fintechUseNo)
6. 계좌 등록 응답 (custAcntKey, fintechUseNo)

각 단계 상세

  1. 1계좌 등록 요청 : 고객이 가맹점에서 오픈뱅킹 계좌 등록을 요청합니다.
  2. 2ARS 인증 요청 : 가맹점이 펌뱅킹 ARS 인증 API(POST /v1/api/auth/ars)를 호출합니다.
  3. 3ARS 전화 발신 : 헥토파이낸셜이 고객 전화로 ARS 인증을 발신합니다.
  4. 4ARS 인증 확인 : 가맹점이 ARS 인증 확인 API(POST /v1/api/auth/arscheck)를 호출하여 trdNo를 획득합니다.
  5. 5계좌 등록 : 가맹점이 trdNo를 포함하여 오픈뱅킹 계좌 등록 API(POST /v2/api/acnt/reg)를 호출합니다.
  6. 6계좌 등록 응답 : custAcntKey, fintechUseNo, obPayerNo 등 오픈뱅킹 식별 정보를 응답합니다.
NOTE
펌뱅킹+오픈뱅킹 동시 등록 /v2/api/acnt/reg 호출 시 svcDivCd=3으로 응답되면 펌뱅킹과 오픈뱅킹이 동시에 등록됩니다. 이미 펌뱅킹이 등록된 고객은 /v2/api/acnt/obreg를 통해 오픈뱅킹만 추가로 등록할 수 있습니다.

결제 흐름

등록된 오픈뱅킹 계좌로 결제를 실행합니다. 고객 계좌에서 가맹점의 오픈뱅킹 모계좌로 현금이 이체됩니다.

가맹점
헥토파이낸셜
금융결제원
11. 결제 API 호출 (v2)
1. 결제 API 호출 (v2)
22. 오픈뱅킹 출금이체 요청
2. 오픈뱅킹 출금이체 요청
33. 출금 결과
3. 출금 결과
44. 승인 결과 응답
4. 승인 결과 응답

각 단계 상세

  1. 1결제 API 호출 : 가맹점이 오픈뱅킹 결제 API(POST /v2/api/pay/confirm)를 호출합니다.
  2. 2출금이체 요청 : 헥토파이낸셜이 금융결제원 오픈뱅킹 망으로 출금이체를 요청합니다.
  3. 3출금 결과 : 금융결제원이 출금 결과를 반환합니다.
  4. 4승인 결과 응답 : 헥토파이낸셜이 가맹점에 승인 결과를 응답합니다.
NOTE
제공 기능 1. 일반결제 - POST /v2/api/pay/confirm 2. 결제 취소/환불 - POST /v1/api/pay/cancel (펌뱅킹 공유) 3. 송금 - POST /v2/api/pay/rmt 4. 자금반환청구 - POST /v2/api/fundsReturn/req 5. 거래결과 조회/거래내역 조회 (펌뱅킹 공유)

연동 전 확인사항

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

운영 환경 테스트 주의

운영환경에서 테스트 시 발생하는 비용은 가맹점에서 부담합니다. 반드시 테스트베드에서 모든 테스트를 완료 후 운영환경을 이용해야 합니다.

요청/응답 방식

  • 요청 방식은 POST만 지원합니다.
  • 요청 헤더: Content-Type: application/json; charset=UTF-8
  • 응답 형식: JSON

IDC 이중화 구성

  • 헥토파이낸셜 시스템은 IDC센터 이중화로 구성되어 있습니다.
  • DNS Lookup에 의한 접속을 권장하며, hosts 파일 고정 설정은 권장하지 않습니다.
  • 방화벽에 Primary/Secondary IP 주소 모두 허용해 주세요.

개발 문서 바로가기

🚀

연동 준비하기

서버 환경, 키 정보, 보안 설정

🏦

계좌관리

계좌 등록, 오픈뱅킹 등록, 해지

💳

결제/송금

출금 승인, 취소/환불, 송금

↩️

자금반환청구

자금반환청구 요청 및 확인

❓

더 궁금한 내용이 있나요?

FAQ
💬

기술지원이 필요한가요?

코드 샘플

HectoFinancial GitHub