개발자센터
V1
V2

가상계좌 입금통보 설정

PG사별 입금통보 설정을 통해 가상계좌 결제를 사용할 수 있습니다.

가상계좌를 이용하는 가맹점의 경우 가상계좌 결제 이후 포트원에 입금통보를 받을 수 있도록 준비해야 합니다.

PG사별 가상계좌 입금통보 URL

PG입금통보 주소
KG이니시스https://service.iamport.kr/inicis_payments/notice_vbank
NHN KCPhttps://service.iamport.kr/kcp_payments/notice_vbank
(구) 나이스페이먼츠https://service.iamport.kr/nice_payments/notice_vbank
KICChttps://service.iamport.kr/kicc_payments/notice_vbank
헥토파이낸셜https://service.iamport.kr/settle_payments/notice_vbank
키움페이
(산) 토스페이먼츠https://tx-gateway-service.prod.iamport.co/virtual-account/webhook-event/tosspayments
KSNEThttps://tx-gateway-service.prod.iamport.co/ksnet
(신) 스마트로입금 통보, 환불이체 URL 동일: https://tx-gateway-service.prod.iamport.co/smartro-v2
(신) 나이스페이먼츠https://tx-gateway-service.prod.iamport.co/nicepay-v2
웰컴페이먼츠https://tx-gateway-service.prod.iamport.co/welcome

KG 이니시스

“KG이니시스” > “포트원 서버”로 이루어지는 통지는 KG이니시스 상점관리자 페이지에서 다음과 같은 추가 설정이 필요합니다. “상점정보” > “결제수단정보” 메뉴에서, “입금통보 URL(IP)“를 https://service.iamport.kr/inicis_payments/notice_vbank 로 설정해주세요.

KCP

“KCP” > “포트원 서버”로 이루어지는 통지는 KCP 상점관리자 페이지에서 다음과 같은 추가 설정이 필요합니다.
“상점정보관리” > “정보변경” > “공통URL정보” 메뉴에서, “공통 URL” https://service.iamport.kr/kcp_payments/notice_vbank 로 설정해주세요.

(구) 나이스페이먼츠

“나이스페이먼츠” > “포트원 서버”로 이루어지는 통지는 나이스페이 상점관리자 페이지에서 다음과 같은 추가 설정이 필요합니다. “가맹점정보” > “기본정보” 메뉴에서, “결제데이터 통보의 가상계좌” 부분을 https://service.iamport.kr/nice_payments/notice_vbank 로 설정해주세요. (OK체크를 체크해주시고, 재전송 횟수는 1혹은 그 이상으로 해주세요.)

KICC

“KICC서버” > “포트원 서버”로 이루어지는 통지는 MID 발급 시 자동으로 등록됩니다. 만약, 입금통보가 수신되지 않는다면 KICC 영업담당자 혹은 대표 연락처(1644-2004, easypay_cs@kicc.co.kr)로 연락하셔서 “가상계좌 입금통보 URL” 설정 확인을 요청주세요.

헥토파이낸셜

“헥토파이낸셜 서버” > “포트원 서버”로 이루어지는 통지는 헥토파이낸셜 담당자 및 기술팀에 메일로 요청해주셔야 합니다. (헥토파이낸셜 관리자 페이지에 오류가 있어 저장이 안됨)
settle_pgdev@settlebank.co.kr(개발팀) 에 발급받으신 MID와 함께 아래와 같은 메일을 발송부탁드립니다.

헥토파이낸셜(구 세틀뱅크)의 가상계좌 기능을 이용하기 위해 포트원의 vbank API를 사용하고자 합니다. 관련해서 정상적인 입금확인 절차가 이루어질 수 있도록 지정된 MID에 대한 가상계좌 통보 URL을 설정해 주시기 바랍니다.

MID: XXXXXX 입금통보 URL: https://service.iamport.kr/settle_payments/notice_vbank

설정이 완료되면 회신 부탁드립니다.

키움페이

(신) 토스페이먼츠

토스페이먼츠 상점 관리자 페이지 -> 개발 정보 -> 웹훅 페이지에서 설정이 필요합니다. 구독할 이벤트를 DEPOSIT_CALLBACK 으로 해야 정상적으로 입금 통보가 가능합니다.

KSNET

KSNET은 포트원을 통해 발급된 MID에 대해 자동으로 입금통보 URL이 설정됩니다. 만약 입금통보를 받지 못하는 경우 KSNET 담당자에게 메일을 통해 확인 요청 후 변경이 필요합니다.

(신)스마트로

스마트로 관리자 페이지 -> 가맹점 -> 가맹점정보 -> 기본정보 페이지에서 입금통보, 환불이체 URL 설정이 가능합니다.

  • 재전송 간격: 최소 1분 ~ 최대 10분까지만 입력 가능합니다.
  • 재전송 횟수: 최소 1회 ~ 최대 10회까지 재전송 가능합니다.(전송 실패 건에 대해 자동 재전송)

(신)나이스페이먼츠

나이스 관리자 페이지 -> 가맹점정보 -> 페이지 하단의 결제데이터통보 탭에서 설정이 필요합니다. 정상적인 입금통보 전송, 재전송을 위해 암호화 전송 여부, 미전송시 체크를 해제하셔야 합니다, OK여부는 체크하지 않으셔도 무관한 옵션입니다.

  • 재전송 간격: 최소 1분 ~ 최대 10분까지만 입력 가능합니다.
  • 재전송 횟수: 최소 1회 ~ 최대 10회까지 재전송 가능합니다.(전송 실패 건에 대해 자동 재전송)

웰컴페이먼츠

웰컴페이먼츠 상점관리자페이지 -> 상점정보 -> 결제수단 정보 -> 가상계좌 필드에서 설정이 필요합니다. 입금내역 통보를 “실시간통보함”, 통보전문을 “URL수신사용(일반)“으로 설정하셔야 합니다.