간편현금결제 (오픈뱅킹)
간편현금결제(오픈뱅킹)는 금융결제원 오픈뱅킹 망을 통해 사용자 은행 계좌 기반으로 결제를 진행하는 서비스로, API를 통해 결제, 계좌 관리, 송금, 자금반환청구 등의 기능을 시스템에 연동할 수 있습니다. 사용자가 ARS 계좌점유인증을 통해 오픈뱅킹 계좌를 등록하고, 해당 계좌에서 결제를 진행하는 계좌 기반 결제 서비스로 일반적으로 ARS 인증 → 계좌 등록 → 결제 → 거래 관리 흐름으로 구성됩니다.
카드 결제와 달리 카드번호 입력 과정이 필요하지 않고, 계좌 등록 이후에는 비교적 간단한 절차로 결제가 이루어지는 장점이 있습니다. 비즈니스 관점에서 구독 서비스, 플랫폼 서비스, 콘텐츠 서비스 등 다양한 서비스에서 간편한 결제수단으로서 간편현금결제 API 활용이 가능합니다.
헥토파이낸셜에서 제공하는 간편현금결제(오픈뱅킹) 서비스는 금융결제원 오픈뱅킹 망을 통해 결제 관련 기능을 API 형태로 제공하는 '결제 플랫폼'으로 활용 할 수 있습니다.
간편현금결제(오픈뱅킹) 핵심 흐름. ARS 계좌점유인증 → 계좌 등록 → 결제 API 호출 → 금융결제원 망을 통해 즉시 출금.
결제 방식 알아보기
금융결제원 오픈뱅킹 망을 통해 고객 계좌에서 출금하는 서비스입니다. ARS 계좌점유인증으로 계좌를 등록하고, 오픈뱅킹 전용 API(/v2/api/...)로 결제·송금·자금반환청구를 처리합니다.
- ARS 계좌점유인증 : 펌뱅킹 공통 ARS 인증 API를 사용하여 계좌 점유를 확인합니다.
- 오픈뱅킹 전용 경로 : 계좌 등록, 결제, 송금 모두 /v2/api/... 경로를 사용합니다.
- 펌뱅킹+오픈뱅킹 동시 등록 : 1회의 계좌 등록으로 펌뱅킹과 오픈뱅킹을 동시에 등록할 수 있습니다.
- 자금반환청구 : 오픈뱅킹 고유 기능으로 잘못 이체된 자금 반환을 청구할 수 있습니다.
결제 흐름 알아보기
- 간편현금결제(오픈뱅킹)는 모든 기능이 API 방식으로 제공됩니다. (결제창 없음)
- ARS 인증은 펌뱅킹 공통 API(
/v1/api/auth/ars,/v1/api/auth/arscheck)를 사용합니다. - 계좌 등록, 결제, 송금은 오픈뱅킹 전용 API(
/v2/api/...)를 사용합니다.
계좌 등록 흐름
ARS 계좌점유인증 후 오픈뱅킹 계좌를 등록하는 과정입니다. ARS 인증에서 획득한 trdNo를 계좌 등록 시 사용합니다.
각 단계 상세
- 1계좌 등록 요청 : 고객이 가맹점에서 오픈뱅킹 계좌 등록을 요청합니다.
- 2ARS 인증 요청 : 가맹점이 펌뱅킹 ARS 인증 API(POST /v1/api/auth/ars)를 호출합니다.
- 3ARS 전화 발신 : 헥토파이낸셜이 고객 전화로 ARS 인증을 발신합니다.
- 4ARS 인증 확인 : 가맹점이 ARS 인증 확인 API(POST /v1/api/auth/arscheck)를 호출하여 trdNo를 획득합니다.
- 5계좌 등록 : 가맹점이 trdNo를 포함하여 오픈뱅킹 계좌 등록 API(POST /v2/api/acnt/reg)를 호출합니다.
- 6계좌 등록 응답 : custAcntKey, fintechUseNo, obPayerNo 등 오픈뱅킹 식별 정보를 응답합니다.
연동 전 확인사항
연동을 시작하기 전에, 아래 사항을 미리 확인해 두면 좋습니다.
운영 환경 테스트 주의
요청/응답 방식
- 요청 방식은
POST만 지원합니다. - 요청 헤더:
Content-Type: application/json; charset=UTF-8 - 응답 형식: JSON
IDC 이중화 구성
- 헥토파이낸셜 시스템은 IDC센터 이중화로 구성되어 있습니다.
- DNS Lookup에 의한 접속을 권장하며, hosts 파일 고정 설정은 권장하지 않습니다.
- 방화벽에 Primary/Secondary IP 주소 모두 허용해 주세요.
