가상계좌 결제
가상계좌(무통장입금)는 구매자에게 임시 계좌번호를 발급하고, 해당 계좌로 입금하면 결제가 완료되는 방식입니다.
카드가 없는 고객도 결제할 수 있고, 입금 확인이 자동으로 처리되어 가맹점의 운영 효율을 높여줍니다.
일반적인 결제 수단과 달리, 가상계좌는 채번(계좌 발급)과 입금이 분리된 비동기 구조로 동작합니다.
결제 요청 시 실제 결제가 발생하지 않고 계좌만 발급되며, 고객이 해당 계좌에 입금해야 비로소 결제가 완료됩니다.
가상계좌 결제의 핵심 흐름. Step1 : 채번 요청 → 가상계좌 발급 Step2 : 구매자 입금 → 입금 확인 노티 수신 → 주문 완료 처리. 채번과 입금이 분리되어 있으므로, notiUrl을 통한 입금 통보 처리가 필수입니다.
계좌 방식 알아보기
헥토파이낸셜은 서비스 특성에 맞게 선택할 수 있도록 세 가지 방식을 제공합니다.
헥토파이낸셜이 보유한 계좌 풀(Pool)에서 주문마다 다른 계좌번호를 자동으로 할당하는 방식입니다. 가맹점이 계좌를 별도로 관리할 필요 없이, 요청 즉시 사용 가능한 계좌가 발급됩니다.
- 주문마다 고유한 계좌번호가 자동으로 발급됩니다.
- 입금 기한이 지나면 계좌가 자동 회수되어 다른 주문에 재사용됩니다.
결제 흐름 알아보기
결제창 연동
가맹점 웹페이지에서 헥토파이낸셜 결제창을 호출하면, 구매자가 결제창에서 은행을 선택하고 가상계좌를 발급받습니다. 입금이 완료되면 헥토파이낸셜이 가맹점 서버로 결과를 전달합니다.
각 단계 상세
- 1결제 요청 : 구매자가 주문서에서 가상계좌 결제를 선택합니다.
- 2결제창 호출 : 가맹점이 JavaScript SDK(SETTLE_PG.pay)를 호출하여 결제창을 띄웁니다.
- 3은행 선택 : 구매자가 결제창에서 입금할 은행을 선택합니다.
- 4채번 노티 : 헥토파이낸셜이 가상계좌 정보(계좌번호, 입금 기한)를 notiUrl로 전달합니다. (outStatCd: 0051)
- 5입금 안내 : 가맹점이 구매자에게 발급된 가상계좌 정보를 안내합니다.
- 6입금 : 구매자가 안내받은 계좌로 입금합니다.
- 7입금 노티 : 입금이 확인되면 헥토파이낸셜이 notiUrl로 입금 완료를 전달합니다. (outStatCd: 0021)
결제창 vs API 비교
| 항목 | 결제창 연동 | API 연동 |
|---|---|---|
| 계좌 방식 | 회전식 | 회전식, 고정식, 고정무제한 |
| 결제 UI | 헥토파이낸셜 제공 결제창 | 가맹점 자체 디자인 가능 |
| notiUrl | 필수 (채번 + 입금) | 채번 노티 선택 / 입금 노티 필수 |
주요 기능 및 특징
1. 유효성 체크
일반 가상계좌와 다르게 입금 기한, 입금 금액 등을 체크하여 정상적인 입금 여부를 확인합니다.
2. 가상계좌 만료 처리
입금 기한이 지나도 입금이 없으면 계좌가 자동 만료됩니다.
가상계좌 만료 시 별도 노티가 발송되지 않습니다. 만료된 계좌에 대한 처리(주문 취소, 재발급 안내 등)는 가맹점에서 별도로 구현해야 합니다. 만료 기한 도달 여부를 주기적으로 확인하는 배치 처리를 권장합니다.
3. 가맹점 수취조회 기능
기본적으로 PG사에서 수취조회 기능을 대행하고 있습니다. 다만 필요시 영업담당자를 통해 요청하면 수취조회를 가맹점에서 체크할 수 있습니다.
4. 현금영수증
가상계좌는 현금성 결제로 분류되어 현금영수증 발행 대상입니다. 결제창을 통해 연동하는 경우 따로 연동할 필요 없습니다. WEB-API를 통해 채번하는 경우 파라미터를 통해 현금영수증 설정이 가능합니다.
5. 은행 직계약
헥토파이낸셜 가상계좌 외에 은행과 직접 계약이 된 경우,
또는 일부 은행만 사용하는 경우에도 영업담당자를 통해 설정 가능합니다.
취소 및 환불
가상계좌의 취소와 환불은 입금 전/후에 따라 처리 방법이 달라집니다.
| 구분 | 처리 방법 | 설명 |
|---|---|---|
| 입금 전 취소 | 채번취소 API | 발급된 계좌를 회수합니다. 고객이 입금하지 않은 상태에서 주문 취소 시 사용합니다. |
| 입금 후 환불 | 환불 API | 고객 계좌로 입금된 금액을 송금합니다. 환불계좌 정보를 고객으로부터 직접 입력받아야 합니다. |
| 환불 처리 기간 | 영업일 기준 2~5일 | 일반적으로 영업일 기준 익일 환불 진행되나 일부 예외적인 경우 시일이 걸릴 수 있습니다. |
입금 전 취소와 입금 후 환불의 차이. 입금 전 취소는 발급된 가상계좌를 단순히 회수하는 것이므로 즉시 처리됩니다. 입금 후 환불은 고객 계좌로 별도 송금해야 하므로 환불계좌 정보가 필요하고, 처리 시간이 소요됩니다.
연동 전 확인사항
가상계좌 결제 연동을 시작하기 전에, 아래 사항을 미리 확인해 두면 좋습니다.
상점아이디 관련
- 회전식, 고정식, 고정무제한 등 계좌 방식에 따라 상점아이디가 분리될 수 있습니다. 사용할 방식을 미리 확인하고, 영업 담당자와 협의해 주세요.
- 테스트 환경과 운영 환경의 상점아이디는 다릅니다. 운영환경에서 테스트하면 실제 비용이 발생하니, 꼭 테스트베드를 이용해 주세요.
기타 관련
- 가상계좌는 notiUrl 연동이 필수입니다. 회전식/고정식은 채번 노티(0051)와 입금 노티(0021)를 처리해야 합니다. 고정무제한은 채번 노티가 발송되지 않으며, 입금 노티(0021/B1)와 설정 시 자동취소 노티(0121/B2)를 처리해야 합니다.
- 고정식/고정무제한 방식은 notiUrl을 영업담당자에게 미리 전달해야 합니다.
- 은행 점검 시간(23:30~00:35)에는 채번 및 취소 요청을 피해 주세요.
- 취소 기한은 1년입니다.
영업/심사 관련
- 고정식, 고정무제한 방식은 영업담당자 협의를 통해 신청해야 합니다.
- 영업 문의 :
