개발자센터
V1
V2
이 페이지의 다른 버전 보기
릴리즈 노트 기술 블로그

가상계좌 입금통보 설정

결제대행사별 입금통보 URL을 안내합니다.

가상계좌 결제를 이용하는 고객사의 경우 가상계좌 발급 후 고객이 입금 완료 했을 때 입금통보를 받을 수 있도록 아래와 같이 사전 설정을 진행해야 합니다.

결제대행사별 가상계좌 입금통보 URL

PG코드값 (pg provider)입금통보 주소
토스페이먼츠tosspaysmentshttps://tx-gateway-service.prod.iamport.co/virtual-account/webhook-event/tosspayments
스마트로smartro_v2입금 통보, 환불이체 URL 동일: https://tx-gateway-service.prod.iamport.co/smartro-v2
나이스페이먼츠nice_v2https://tx-gateway-service.prod.iamport.co/nicepay-v2
KG이니시스inicis_v2https://tx-gateway-service.prod.iamport.co/inicis-v2
한국결제네트웍스kpnhttps://tx-gateway-service.prod.iamport.co/kpn/virtual-account

결제대행사별 가상계좌 입금통보 URL 설정 방법

KSNET 설정 방법

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

토스페이먼츠(신모듈) 설정 방법

  1. 토스페이먼츠 개발자센터 접속 후 로그인을 합니다.
  2. [내 개발정보]를 클릭합니다.
  3. [상점]을 선택한 후 [웹훅]을 클릭합니다.
  4. [+ 웹훅 등록하기]를 클릭합니다.
  5. [이름]을 입력하고, [URL]은 https://tx-gateway-service.prod.iamport.co/virtual-account/webhook-event/tosspayments로 설정해주세요.
  6. [구독할 이벤트]에서 DEPOSIT_CALLBACK을 체크한 후 [등록하기]를 클릭합니다.
토스페이먼츠 개발자센터 내 입금통보 URL 설정 화면 1
토스페이먼츠 개발자센터 내 입금통보 URL 설정 화면 1
토스페이먼츠 개발자센터 내 입금통보 URL 설정 화면 2
토스페이먼츠 개발자센터 내 입금통보 URL 설정 화면 2

나이스페이먼츠(신모듈) 설정 방법

  1. 나이스페이먼츠 가맹점 관리자 접속 후 로그인을 합니다.
  2. [가맹점정보]→[기본정보]를 클릭합니다.
  3. [결제데이터통보] 항목에서 가상계좌의 [URL/IP]를 https://tx-gateway-service.prod.iamport.co/nicepay-v2 로 설정해주세요.
  4. [재전송 간격]은 1분, [재전송 횟수]는 3회로 설정해주세요.
  5. [OK체크] 체크 여부는 선택이며, 체크하지 않아도 무관합니다.
  • 정상적인 입금통보 전송, 재전송을 위해 암호화 전송 여부, 미전송시 체크를 해제해야 합니다.
  • 재전송 간격: 최소 1분 ~ 최대 10분까지만 입력 가능합니다.
  • 재전송 횟수: 최소 1회 ~ 최대 10회까지 재전송 가능합니다.(전송 실패 건에 대해 자동 재전송)
나이스페이먼츠 가맹점 관리자 내 입금통보 URL 설정 화면
나이스페이먼츠 가맹점 관리자 내 입금통보 URL 설정 화면

스마트로(신모듈) 설정 방법

  1. 스마트로 스마일비즈 접속 후 로그인을 합니다.
  2. [가맹점정보]→[기본정보]를 클릭합니다.
  3. [결제 데이터 통보] 항목 중 [가상계좌] 및 [환불]항목에 다음과 같이 설정해주세요.
  4. [통보 티입]은 신통보 를 선택합니다.
  5. [인코딩 타입]은 UTF-8 를 선택합니다.
  6. [URL/IP]는 https://tx-gateway-service.prod.iamport.co/smartro-v2로 입력해주세요.
  7. [재전송 간격]은 1분, [재전송 횟수]는 5회로 입력한 후 [저장]을 클릭합니다.
  • 재전송 간격: 최소 1분 ~ 최대 10분까지만 입력 가능합니다.
  • 재전송 횟수: 최소 1회 ~ 최대 10회까지 재전송 가능합니다.(전송 실패 건에 대해 자동 재전송)
스마트로 스마일비즈 내 입금통보 URL 설정 화면
스마트로 스마일비즈 내 입금통보 URL 설정 화면

KG 이니시스 설정 방법

  1. KG이니시스 가맹점관리자 접속 후 로그인을 합니다.
  2. [상점정보]→[계약정보]→[결제수단 정보]를 클릭합니다.
  3. [가상계좌] 항목 중 [입금내역 통보]를 실시간통보함으로 설정해주세요.
  4. [입금통보 URL(IP)]를 https://tx-gateway-service.prod.iamport.co/inicis-v2 로 설정해주세요.
  5. [통보전문]을 URL수신사용(일반) 으로 설정해주세요.
  6. [채번방식]을 건별채번으로 설정해주세요.
이니시스 가맹점관리자 내 입금통보 URL 설정 화면
이니시스 가맹점관리자 내 입금통보 URL 설정 화면

한국결제네트웍스(KPN) 설정 방법

한국결제네트웍스(KPN)는 계약 이후, 발급된 MID에 대해 가상계좌 백노티 기능을 별도로 요청해야 합니다.

한국결제네트웍스(KPN) 담당자에게 MID 정보와 함께 입금 통보 URL을 전달하여 가상계좌 백노티 기능 요청을 진행해주세요.

만약 입금통보를 받지 못하는 경우 한국결제네트웍스(KPN) 담당자에게 메일을 통해 확인 요청 후 변경이 필요합니다.